Skip to main content

Actian Integration Manager Worker

This section describes how to install, configure, and use the Actian Integration Manager Worker.

Why and when is this installation required?​

Installing a separate Integration Manager Worker (worker service) is optional. The Worker service is already included by default when you install Integration Manager. A separate Worker service installation is only required when the you also want to install additional workers on other machines.

Quick Start Installation​

Windows Installation​

Prerequisites​​

  • Windows Operating System
  • Windows 10 Enterprise or later, Windows Server 2016 or later
  • Windows user account with "Run as Administrator" privileges
  • 64-bit processor, 2.90GHz
  • 16 GB installed memory (RAM)
  • DataConnect v12 License file (typically *.slc)
  • RabbitMQ Messaging Broker

What Will Be Installed​​

  • Actian Integration Manager Worker (Windows Service)
  • DataConnect v12 Embedded Engine
  • AdoptJDK 11 Embedded JRE

Installation​​

  1. Make sure RabbitMQ Messaging Broker has been installed and running locally or remotely to configure the Integration Manager Worker.

  2. Download Actian Integration Manager Worker for Windows from Actian ESD: ESD - Electronic Software Distribution.

  3. Right-click the downloaded installer file (integration-worker-3.3.x-xx.exe) and select "Run as Administrator".

    note

    If you have a previous 3.x.x version installed, you will be prompted to uninstall first. Uninstalling will shutdown running services and prepare for library updates, it will NOT remove or alter ProgramData (conf files, logs, etc.). See Uninstallation below.

  4. Accept the License Agreement.

  5. Select the installation path (default: C:\Program Files\Actian\IntegrationWorker).

  6. Select the shared data path (default: C:\ProgramData\Actian\IntegrationWorker).

  7. Installation should take less than a minute.

Configuration/Reconfiguration​​

The application.properties file can be used for a variety of configurations to tailor Integration Manager Worker to your requirements and environment. See Application Property Reference for a description of available properties.

note

If you have a previous installation of Integration Worker, none of your existing property values will be changed.

  1. Locate the application.properties file (default: C:\ProgramData\Actian\IntegrationWorker\conf\application.properties).

  2. Configure Messaging Configuration and Worker Configuration in the properties file, replacing the placeholder property values below with the required values for your environment.

    • Worker Configuration

      # Worker Configuration
      worker.destinationId=<your-destination-id>
      Messaging Configuration

    • Messaging Configuration

      queue.host= <rabbitmq-host>
      queue.port= <rabbitmq-port>
      queue.username= <rabbitmq-username>
      queue.password= <rabbitmq-password>
      queue.ssl.enabled= true

  3. Confirm or alter the path to your DataConnect v12 license file using the property engine.licensePath (default: C:\ProgramData\Actian\IntegrationWorker\license\cosmos.slc).

    note

    If you were previously using Integration Manager v2 and DataConnect v11, you will need to alter this value before executing any integrations. DataConnect v11 and v12 licenses are not interchangeable.

  4. Any change to the application.properties file will require a restart of the service.

    1. Go to Windows → Administrative Tools → Services.
    2. Right-click Actian Integration Manager Worker and select Restart.
    note

    Configuration file changes will survive uninstallation/reinstallation.

Service Logs & Monitoring​​

  • You can monitor service activity and get important additional information from the log file (default: C:\ProgramData\Actian\IntegrationWorker\logs\IntegrationWorker.log)
  • You can retrieve DataConnect Engine log files by Job Id in the job history folder (default: C:\ProgramData\Actian\IntegrationWorker\history\job)
note

Log file data will survive uninstallation/reinstallation.

Uninstallation​​

To uninstall Integration Manager Worker, execute uninstaller.exe in the program directory (default C:\Program Files\Actian\IntegrationWorker).

Testing and Running a Job on the Worker​

  1. Ensure that the Integration Manager Worker service is started and connected to the RabbitMQ Broker.
  2. Login to Integration Manager console and configure a Job.
  3. Change the run location to the configured <your-destination-id>.
  4. Run the Job.
  5. Verify that the job has run successfully, and verify the logs.