Skip to content

DataConnect Runtime Engine on Windows

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

Info

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

Requirements

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

RequirementDetails
Operating System64-bit U.S. English edition of Microsoft Windows 10 or Windows 11
Processor64-bit processor, x86-64, 2 GHz or faster
RAM16 GB minimum
Runtime EnvironmentEmbedded OpenJDK Runtime Environment (Temurin-17.0.13+11); installing OpenJDK separately is not required

Installation Steps

On Windows, the standalone Runtime Engine is installed through the DataConnect Windows installer — there is no separate Runtime Engine download.

To install the Runtime Engine on Windows:

  1. Download the DataConnect installer (actian-dc-studio-installer-<version>-win64.exe) from Actian ESD and run it. See DataConnect Studio on Windows for the full installer walkthrough.

  2. On the Installation Type screen, choose Standalone Engine (Integration Engine runtime with Data Quality Engine, Design SDK, and Client SDK — no UI), then complete the installer.

The installation creates the following directory structure:

  • Program files: C:\Program Files\Actian\di-standalone-engine-<version>
  • Configuration and data: C:\ProgramData\Actian\DataConnect\di-standalone-engine-<version>

Environment Variables

After installation, configure the required environment variables:

  1. Set DJLIB variable:

    • Variable: DJLIB
    • Value: C:\ProgramData\Actian\DataConnect\di-standalone-engine-<version>
    • Purpose: Provides cosmos.ini file location to the engine

  2. Update PATH variable:

    • Add this path before any other DataConnect engines:
    • C:\Program Files\Actian\di-standalone-engine-<version>\runtime\di9
    • Purpose: Allows the UI to find the engine to use

Batch File Alternative

You can create a batch file to set environment variables and launch Eclipse:

@echo off
set path=C:\Program Files\Actian\di-standalone-engine-<version>\runtime\di9;%path%
set DJLIB=C:\ProgramData\Actian\DataConnect\di-standalone-engine-<version>

License Configuration

  1. Open the cosmos.ini configuration file:

    • Location: C:\ProgramData\Actian\DataConnect\di-standalone-engine-<version>\cosmos.ini

  2. Set the LicenseFile variable to your license file location: 

    LicenseFile=C:\ProgramData\Actian\DataConnect\di-standalone-engine-<version>\cosmos.slc

  3. Place your DataConnect v14 license file (.slc file) in the specified location.

Note

Alternative License Configuration: If you have DataConnect installed, you can configure the license through the UI:

  1. Enable the DataConnect perspective
  2. Go to Help → About DataConnect
  3. Click Browse and specify the 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 Command Prompt 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 on Windows:

Method 1: Using Windows Settings (Windows 10/11)

  1. Go to Settings → Apps → Installed apps
  2. Find DataConnect Runtime Engine in the list
  3. Click the three-dot menu and select Uninstall
  4. Follow the uninstall wizard prompts

Method 2: Using Control Panel

  1. Go to Control Panel → Programs and Features
  2. Right-click DataConnect Runtime Engine
  3. Select Uninstall
  4. Follow the uninstall wizard prompts

Method 3: Using Uninstaller

Navigate to the installation directory and run the uninstaller:

C:\Program Files\Actian\di-standalone-engine-<version>\uninstall.exe