Installation Guide > Installing DataConnect > Installing DataConnect Runtime Engine on Linux
Was this helpful?
Installing DataConnect Runtime Engine on Linux
The following topics provide installation instructions for deploying DataConnect Runtime Engine in stand-alone deployments.
Note:  When you are using Integration Manager, installing the DataConnect Runtime Engine separately is not required because it is installed as part of the Integration Manager installation process.
Minimum System Requirements for Linux
Before installing the DataConnect Runtime Engine, you must meet the following minimum system requirements.
Operating System and Software Requirements
• Red Hat Enterprise Linux 7.9 and 8 (64-bit U.S. English edition)
• GTK Version 3
Note:  The libnsl.so.1 library is no longer being distributed with RH 8.1 or above versions. You need to install this library separately when installing DataConnect on RH 8.1 or above versions. For more information on how to install libnsl.so.1, see https://access.redhat.com/solutions/4975641.
Note:  DataConnect contains an embedded Adoptium OpenJDK 11.0.12+7.
Hardware Requirements
• 64-bit processor, x86-64, 2 GHz or faster
• At least 2 GB free hard drive space to install DataConnect
• 8 GB high-speed RAM
Runtime Engine Requirements
In addition to the minimum requirements for your operating system, each additional running Runtime Engine on the same machine requires the following:
• 2 GB high speed RAM
• 1–2 available processor cores
• A valid engine license
Note:  These minimum requirements assumes that the DataConnect engine has full access to available resources and is executing in a dedicated physical or virtual server. Installing Open JDK is not required because it is installed during Runtime Engine installation.
Install DataConnect Runtime Engine on Linux
To install DataConnect Runtime Engine on Linux
1. Download the DataConnect Runtime Engine on Linux installer from Actian ESD to the system where you want to install DataConnect.
2. Open a terminal window at the download location.
3. Run the following command to set the installer as executable:
sudo chmod +x di.install.rpm.linux.di-standalone-engine-bin-<DataConnect_version>.rpm.bin
where <DataConnect_version> is the version number, for example, 12.0.0-13.
4. Run the following command to execute the installer:
sudo ./di.install.rpm.linux.di-standalone-engine-bin-<DataConnect_version>.rpm.bin
where <DataConnect_version> is the version number, for example, 12.0.0-13.
5. Accept the license agreement and then press Enter to install to the default location (/opt/Actian/di-standalone-engine-<DataConnect_version> such as /opt/Actian/di-standalone-engine-12.0.0-13.  Here 12.0.0-13 is the <DataConnect_version>).
Note:  The following are some important locations:
- Connector files - /opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9/connectors
- Component files - /opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9/Plug-Ins
- Configuration file - /opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9
A user group called “diusers” is created to manage permissions for using DataConnect. Any user who will be using DataConnect must be added to the diusers group. You can use the usermod command to add the users to the group. For example:
sudo usermod -a -G diusers myname
6. Set the environment variables by adding the following to /home/username/.bash_profile:
a. Set the DJLIB and LD_LIBRARY_PATH environment variables to the Runtime Engine directory:
export DJLIB=/opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9
export LD_LIBRARY_PATH=/opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9
where <DataConnect_version> is the version number, for example, 12.0.0-13.
b. Add the Runtime Engine directory to the PATH environment variable:
export PATH=/opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9:$PATH
where <DataConnect_version> is the version number, for example, 12.0.0-13.
7. Verify that the permission to update the engine configuration file is correct. If you need to correct it, run the following command:
sudo chmod 664 /opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9/cosmos.ini
where <DataConnect_version> is the version number, for example, 12.0.0-13.
8. Copy your DataConnect license file to /opt/Actian/di-standalone-engine-<DataConnect_version>/ folder and rename it, for example, as dc12.slc.
Uninstall DataConnect Runtime Engine on Linux
To uninstall DataConnect runtime engine on Linux
1. Open a terminal window.
2. Navigate to /opt/Actian/di-standalone-engine-<DataConnect_version>/install where <DataConnect_version> is the version number, for example, 12.0.0-13.
3. Run the following command:
sudo ./uninstall.sh
Last modified date: 02/09/2024