Upgrade the Jobserver and Collibra Console on Linux

When your Collibra Platform is upgraded, you have to update all your on-premises Jobservers and Collibra Console instances to the latest available on-premises version. The installers are released on a quarterly basis, check the compatibility list to know which installer you have to download.

This section describes how you can upgrade your on-premises Jobservers and Collibra Console on Linux.

Tip If you already installed the on-premises Jobserver and Collibra Console with the latest available installer, there's no need to upgrade these.

Prerequisites

  • You have downloaded the latest Jobserver-only installer from the Collibra Community Downloads page.
  • You have installed PostgreSQL 14.9. If you install Jobserver and Collibra Console on separate servers, then both servers require PostgreSQL 14.9
Note 
  • You must upgrade with the same user account that was used for the installation, both on Linux and Windows. If the user account is no longer active, see Upgrade an environment with another user account in the Troubleshooting section.

Steps

Use this drop-down to select your operating system:

  1. Stop the environment:
    1. Open Collibra Console with a user profile that has at least the ADMIN role.Collibra Console opens with the Infrastructure page.
    2. Click the environment that you want to stop.
    3. Click Stop.
      The Stop environment dialog box appears.
    4. Click Stop environment.
    5. Wait until all the nodes of the environment show Stopped.
    6. Stop Collibra Console and the Collibra DGC Agent. In the terminal of the node that runs Collibra Console:
      1. As root:
        service collibra-agent stop
        service collibra-console stop
      2. Manual stop of the services:
        /opt/collibra/console/bin/console stop
        /opt/collibra/agent/bin/agent stop
  2. Install PostgreSQL 14.9:
    1. Install PostgreSQL 14.9 with the following commands.

      Important Run the commands as root.

      #Clean the YUM cache and update existing packages for your current Linux repository. Note that this makes system changes.
      yum clean all && yum update -y
      #Prepare the PostgreSQL repository and packages: yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -E %{rhel})-x86_64/pgdg-redhat-repo-latest.noarch.rpm
      #Update the packages in the repository: yum -y update
      #Install the PostgreSQL 14.9 packages: yum -y install postgresql14 postgresql14-server postgresql14-contrib
    2. Update the file /usr/lib/tmpfiles.d/postgresql-14.conf to set the correct permissions for some PostgreSQL folders. Open the file for editing, for example with vim or nano and update the line d /run/postgresql 0755 postgres postgres - to:
      d /run/postgresql 2777 postgres postgres - -

      Important Do not use the chmod command on any directories or files, edit this configuration file instead.

    3. If you are upgrading from version 5.8.x to 5.9, you also have to update the configuration file of PostgreSQL 11 (/usr/lib/tmpfiles.d/postgresql-11.conf) as described in the previous step.
    4. Reboot the server.

    Tip The default PostgreSQL 14 path on RHEL/Rocky/CentOS is /usr/pgsql-14.

    1. Install PostgreSQL 14.9 with the following commands:

      Important Run the commands as root.


      sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

      wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

      apt-get update && apt-get upgrade -y

      apt-get install -y postgresql-14
    2. Update the file /usr/lib/tmpfiles.d/postgresql-common.conf to set the correct permissions for some PostgreSQL folders. Open the file for editing, for example with vim or nano and update the line d /run/postgresql 1775 postgres postgres - to:
      d /run/postgresql 2777 postgres postgres - -
    3. Reboot the server.

    Tip The default PostgreSQL 14 path on Debian/Ubuntu is /usr/lib/postgresql/14.

    1. Install PostgreSQL 14.9 with the following commands:

      Important Run the commands as root. In the first of the following commands, the packages are for Suse 15, replace "15" by your used major version, for example 12. You can check your Suse version with the command: cat /etc/os-release.


      zypper addrepo https://download.postgresql.org/pub/repos/zypp/repo/pgdg-sles-15-pg14.repo
      zypper refresh
      zypper install postgresql14 postgresql14-server postgresql14-contrib
    2. Update the file /usr/lib/tmpfiles.d/postgresql-14.conf to set the correct permissions for some PostgreSQL folders. Open the file for editing, for example with vim or nano and update the line d /run/postgresql 0755 postgres postgres - to:
      d /run/postgresql 2777 postgres postgres - -
    3. If you are upgrading from version 5.8.x to 5.9, you also have to update the configuration file of PostgreSQL 11 (/usr/lib/tmpfiles.d/postgresql-11.conf) as described in the previous step.
    4. Reboot the server.

    Tip The default PostgreSQL 14 path on Suse is /usr/lib/pgsql-14.

    If you don't update the PostgreSQL configuration file, you get an error that a test file could not be written.

  3. Run the installer:
    • Linux as user with sudo rights: sudo ./dgc-linux-jobserver-only-2025.08.0-x.sh
      Linux as root user: ./dgc-linux-jobserver-only-2025.08.0-x.sh
    • Linux as standard user: ./dgc-linux-jobserver-only-2025.08.0-x.sh
  4. Follow the command-line wizard. If you don't enter a value, the value between brackets or the value in capital is used.
    Note 
    • The path to your PostgreSQL 14.9 installation differs per Linux operating system. In the following example, the path is of a default installation on CentOS 7.
    • The amount of time it takes to upgrade your environment depends on the size of your repository. The larger the database, the more time it takes to upgrade.
    Verifying archive integrity...  100%   All good.
    Uncompressing DGC Installer  100%
    Specify the installation directory [/opt/collibra]:
    
    /opt/collibra contains a previous installation. Do you want to perform an update? [y/N]
    y
    Before you can schedule an upgrade, you need to:
    - Create a backup of the entire environment.
    - In Collibra Console, stop all running services on this node.
    Have you completed these steps? [yes,NO]
    
    yes
    Specify the postgresql 14 path [/usr/pgsql-14]:
    
    2022-09-26 15:15:00.542 - SUCCESS - Check umask settings
    2022-09-26 15:15:00.552 - SUCCESS - Create installation and data directories
    
    ...
    2022-09-26 15:15:34.063 - SUCCESS - Start Console
    2022-09-26 15:15:34.064 - COMPLETED - Installation finished in 33881ms.
    
  5. Start the Jobserver.