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 8.3 (64-bit U.S. English edition)
Note:  The libnsl.so.1 library is no longer 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 Linux release has embedded OpenJDK Runtime Environment Temurin-17.0.11+9.
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
This topic describes how to install DataConnect Runtime Engine on Linux.
Note that <DataConnect_version> specifies the DataConnect version, for example, 12.0.0-13.
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
4. Run the following command to execute the installer:
sudo ./di.install.rpm.linux.di-standalone-engine-bin-<DataConnect_version>.rpm.bin
5. Accept the license agreement and then press Enter to install to the default location (/opt/Actian/di-standalone-engine-<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
b. Add the Runtime Engine directory to the PATH environment variable:
export PATH=/opt/Actian/di-standalone-engine-<DataConnect_version>/runtime/di9:$PATH
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
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
This topic describes how to uninstall DataConnect Runtime Engine on Linux.
Note that <DataConnect_version> specifies the DataConnect version, for example, 12.0.0-13.
To uninstall DataConnect runtime engine on Linux
1. Open a terminal window.
2. Navigate to /opt/Actian/di-standalone-engine-<DataConnect_version>/install.
3. Run the following command:
sudo ./uninstall.sh
Last modified date: 12/03/2024