Single node installation of Collibra DGC 5.9.0 on Linux

This section describes the Linux installation of the Collibra Data Governance Center's services on a single node. Environments that run on a single node should only be used for testing purposes. For production environments, install the services on multiple nodes.

Keep in mind that the installer has no graphical user interface, the full installation procedure is executed via the command line.

Important If you do the installation on RHEL/Rocky Linux or Suse, see the services section of the installation guide. This is also valid if you install without root permissions.

Prerequisites

You have downloaded the installer for your operating system.
You have installed PostgreSQL 14.9.

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.

Steps

Use this drop-down to select your operating system:

Note If you want to configure the init daemon on Linux systems, you have to execute an unattended installation. For more information, go to the unattended installation configuration parameters.

Tip

There is no graphical user interface for the installer. The full installation procedure is executed via the command line.

For each question, the default selection is always suggested between square brackets. Press Enter to accept the default selection. If there is a Yes or No question, the upper-case character is the default selection, for example, in [Y/n] the default selection is Yes.

Run the installer:
- Linux as user with sudo rights: sudo ./dgc-linux-5.9.2-2.sh
  Linux as root user: ./dgc-linux-5.9.2-2.sh
- Linux as standard user: ./dgc-linux-5.9.2-2.sh
- Window: setup.bat
Enter the Installation directory and press Enter.
- Default location on Linux as root or user with sudo privileges: /opt/collibra
- Default location on Linux as standard user: ~/collibra
- Default location on Windows: C:\collibra
Enter the Data directory and press Enter.
- Default location on Linux as root or user with sudo privileges: /opt/collibra_data
- Default location on Linux as standard user: ~/collibra_data
- Default location on Windows: C:\collibra_data
Press Enter to each of the presented components that you want to install.
If you don't want to install a specific component, press n followed by Enter.
You must select at least Data Governance Center, Repository, Monitoring, Search and Management Console.
Note The Jobserver service is only required if you are ingesting data with Data Catalog. See Add a Jobserver to the Collibra Platform service for more information.
Press Enter to confirm your selection.
Enter the location where PostgreSQL 14.9 is installed.

If you selected the Jobserver in step 4, enter the Jobserver service settings and click Next.

Setting	Description
Jobserver port	The TCP port to access the Jobserver service. The default port is 4404.
Jobserver database port	The TCP port to access the Jobserver database. The default port is 4414.
Jobserver monitoring port	The TCP port that is used by the monitoring service to monitor the Jobserver service. The default port is 4424.
Jobserver Spark monitoring port	The TCP port that is used by the monitoring service to monitor the Jobserver Spark service. The default port is 4434.

If you run multiple environments on one node, all ports must be unique for each environment.

Enter the Collibra service settings and click Next.

Setting	Description
DGC port	The TCP port to access your Collibra DGC environment via your web browser. The default port is 4400.
DGC Shutdown port	The TCP port to stop the Collibra service. The default port is 4430.
DGC minimum memory	The minimum amount of memory in megabytes for the Collibra service. This must be at least 1024 MB and no greater than 32 768 MB (32 GB).
DGC maximum memory	The maximum amount of memory in megabytes that can be assigned to the Collibra service. This must be at least 2048 MB and no greater than 32 768 MB (32 GB).

If you run multiple environments on one node, all ports must be unique for each environment.

Enter the port of the Monitoring service and click Next.The default port is 4407.

Enter the Console service settings.

Setting	Description
Console port	The TCP port to access your Collibra Console via your web browser. The default port is 4402.
Console database port	The TCP port to access the Collibra Console database. This is the database where the data and configuration of Collibra Console is stored. The default port is 4420.

If you run multiple Collibra Console instances on one node, this port must be unique for each instance.

Enter the Search service settings and click Next.

Setting	Description
Search http port	The TCP port to access the Search service via REST API. The default port is 4421.
Search transport port	The TCP port for the communication between the DGC and the Search service. The default port is 4422.
Search memory	The amount of memory in megabytes that is assigned to the Search service. The default value is 1024.

If you run multiple environments on one node, all ports must be unique for each environment.

Enter the Agent service settings and click Next.

Setting	Description
Agent port	The TCP port that is used by Collibra Console to manage the services of an environment. The default port is 4401. If you run multiple agents on one node, this port must be unique for each agent.
Node address	The hostname of the node on which the Agent service is running. You cannot use a loopback address if you want to use the node in a multinode environment. Warning Do not use the loopback address.

Setting

Description

Agent port

The TCP port that is used by Collibra Console to manage the services of an environment.
The default port is 4401.

If you run multiple agents on one node, this port must be unique for each agent.

Node address

The hostname of the node on which the Agent service is running.

You cannot use a loopback address if you want to use the node in a multinode environment.

Warning Do not use the loopback address.

Enter the Repository service settings and click Next.

Setting	Description
Repository port	The TCP port to access the repository service. It is only used by the Collibra service and the Collibra agent. The default port is 4403. If you run multiple environments on one node, all ports must be unique for each environment.
Repository admin password (*)	The password that is used by the agent to access the Repository service.
Confirm repository admin password	The password as entered in the Repository admin password field.
Repository dgc password (*)	The password that is used by the Collibra service to access the repository.
Confirm repository dgc password	The password as entered in the Repository dgc password field.
Repository memory	The amount of memory for the Repository service in megabytes. This must be at least 512 MB and no greater than 16 384 MB (16 GB).

Note (*) These passwords can contain the following characters:

lowercase letters
uppercase letters
numbers
the following special characters: #?!@$%&*-

The installation of the components starts. When completed, you return to the command line.

What's next?

Start your environment for the first time.