Upgrade the software unattendedly

Similar to an unattended installation, you can also upgrade the software in an unattended way. To upgrade to version 5.7 or newer, you have to add the Search and Monitoring services.

Prerequisites

The prerequisites of a normal installation.
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.
If you are upgrading on Linux systems, you must first have installed PostgreSQL 14.9 prior to the upgrade.

The node that will run the Search service, must pass the following bootstrap checks:

Type	Check description	Minimum value	Applies for installation type	Setting name
User limit	Maximum number of open file descriptors	65536	Without root permissions With root permissions, using System V init daemon	nofile
	Maximum number of open threads/processes	4096		nproc
	Maximum file size	unlimited		fsize
Kernel parameter	Maximum virtual memory areas	262144	All	vm.max_map_count

For more information on these settings, see the Settings section.

Note

If you use a configuration file, you can edit the necessary parameters of your existing services, for example to edit a TCP port.
In version 5.5 or newer, there is a database port, with default value 4414 for the Jobserver. If you want to use a different port after the upgrade, add the Jobserver database port in the configuration file.
Upgrading to 5.7.0 or newer, requires you to add the Search and Monitoring services on one of the nodes.

Linux

Open a terminal session.
Go to the directory with the installer.

Run the following command:

Tip

If you use a configuration file, you can replace --upgrade-config by -uc.
Use the full path to the configuration file, even if it is in the same directory as the installer.

OS Command

Linux (root)

OS	Command
Linux (root)	Upgrade with the default options: `sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation` Upgrade with a configuration file: `sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/config` Upgrade and add a service: `sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/extra-service`
Linux (non-root)	Upgrade with the default options: `./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation` Upgrade with a configuration file: `./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/config` Upgrade and add a service: `./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/extra-service.cfg`

Upgrade with the default options:

sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation

Upgrade with a configuration file:

sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/config

Upgrade and add a service:

sudo ./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/extra-service

Linux (non-root)

Upgrade with the default options:

./dgc-linux-5.9.2-2.sh -- \
--upgrade /path/to/installation

Upgrade with a configuration file:

./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/config

Upgrade and add a service:

./dgc-linux-5.9.2-2.sh -- \ --upgrade /path/to/installation \ --upgrade-config /path/to/extra-service.cfg

Windows

Open the command prompt.
Go to the directory with the installer.

Run the following command:

Tip

If you use a configuration file, you can replace --upgrade-config by -uc.
Use the full path to the configuration file, even if it is in the same directory as the installer.

OS	Command
Windows	Upgrade with the default options: `setup.bat --upgrade \path\to\installation` Upgrade with a configuration file: `setup.bat --upgrade /path/to/installation \ --upgrade-config /path/to/config` Upgrade and add a service: `setup.bat --upgrade /path/to/installation \ --upgrade-config /path/to/extra-service.cfg`

What's next?

All Collibra DGC services will be upgraded and be readily available upon the upgrade completion.