Skip to content

DataConnect Runtime Engine on Linux

This section describes how to install the DataConnect Runtime Engine as a standalone component on Linux.

Info

When to use Runtime Engine: Install the standalone Runtime Engine only if you need to run DataConnect without Integration Manager — it already includes the Runtime Engine, so this section does not apply if you have it.

Requirements

Before installing the DataConnect Runtime Engine, ensure your system meets the following requirements:

RequirementDetails
Operating SystemRed Hat Enterprise Linux 8.3 or later (64-bit U.S. English edition)
Processor64-bit processor, x86-64, 2 GHz or faster
RAM16 GB minimum
Runtime EnvironmentEmbedded OpenJDK Runtime Environment (Temurin-17.0.11+9); installing OpenJDK separately is not required

Important Library Requirement

The libnsl.so.1 library is not distributed with Red Hat Enterprise Linux 8.1 or above. You must install this library separately. For installation instructions, see the Red Hat solution article.

Per-Engine Requirements

Each additional Runtime Engine running on the same machine requires:

  • 2 GB high-speed RAM
  • 1-2 available processor cores
  • A valid engine license

Note

These requirements assume that the DataConnect engine has full access to available resources and is executing in a dedicated physical or virtual server.

Installation Steps

To install DataConnect Runtime Engine on Linux:

  1. Download the DataConnect Runtime Engine installer from Actian ESD.

    • Filename format: di.install.rpm.linux.di-standalone-engine-bin-<version>.rpm.bin

  2. Open a terminal window at the download location.

  3. Set the installer as executable: 

    sudo chmod +x di.install.rpm.linux.di-standalone-engine-bin-<version>.rpm.bin

  4. Execute the installer: 

    sudo ./di.install.rpm.linux.di-standalone-engine-bin-<version>.rpm.bin

  5. Accept the license agreement when prompted.

  6. Press Enter to install to the default location or specify a custom path:

    • Default location: /opt/Actian/di-standalone-engine-<version>

The installation creates the following directory structure:

  • Connector files: /opt/Actian/di-standalone-engine-<version>/runtime/di9/connectors
  • Component files: /opt/Actian/di-standalone-engine-<version>/runtime/di9/Plug-Ins
  • Configuration file: /opt/Actian/di-standalone-engine-<version>/runtime/di9/cosmos.ini

User Group Configuration

The installer creates a user group called diusers to manage permissions for using DataConnect.

To add users to the diusers group:

sudo usermod -a -G diusers <username>

Example:

sudo usermod -a -G diusers myname

Warning

All users who will be using DataConnect must be added to the diusers group.

Environment Variables

Configure the required environment variables by adding the following to /home/<username>/.bash_profile:

  1. Set the DJLIB and LD_LIBRARY_PATH environment variables: 

    export DJLIB=/opt/Actian/di-standalone-engine-<version>/runtime/di9
export LD_LIBRARY_PATH=/opt/Actian/di-standalone-engine-<version>/runtime/di9

  2. Add the Runtime Engine directory to the PATH environment variable: 

    export PATH=/opt/Actian/di-standalone-engine-<version>/runtime/di9:$PATH

Tip

Replace <version> with your actual DataConnect version number (e.g., 14.0.0).

License Configuration

  1. Verify that the configuration file has the correct permissions: 

    sudo chmod 664 /opt/Actian/di-standalone-engine-<version>/runtime/di9/cosmos.ini

  2. Copy your DataConnect v14 license file to the installation directory: 

    sudo cp /path/to/your/license.slc /opt/Actian/di-standalone-engine-<version>/cosmos.slc

  3. Update the cosmos.ini configuration file to reference your license file.

Note

License Compatibility: License files are version-specific. DataConnect v14 requires a v14 license file. Previous version licenses (v12 and earlier) are not compatible.

Verify Installation

To verify the Runtime Engine installation:

  1. Open a terminal window.

  2. Run the following command: 

    djengine -V

  3. The DJEngine version information should be displayed along with copyright and license details.

If the version information appears, the installation was successful.

Uninstalling Runtime Engine

To uninstall the DataConnect Runtime Engine:

  1. Open a terminal window.

  2. Navigate to the installation directory: 

    cd /opt/Actian/di-standalone-engine-<version>/install

  3. Run the uninstall script: 

    sudo ./uninstall.sh