Quick Start Installation

Windows

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)

What Will Be Installed

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

Installation

1. Download Actian Integration Manager from https://esd.actian.com/.

2. Right-click the downloaded installer file (integration-manager-3.x.x.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.

3. Accept the License Agreement.

4. Select the installation path (default: C:\Program Files\Actian\IntegrationManager).

5. Select the shared data path (default: C:\ProgramData\Actian\IntegrationManager).

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 to your requirements and environment. See Application Property Reference for a description of available properties.

note

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

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

2. Confirm or alter the path to your DataConnect v12 license file using the property engine.licensePath (default: C:\ProgramData\Actian\IntegrationManager\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.

3. To run Integration Manager on a different port, set the property server.port (default: 8080).

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

   • Go to Windows → Administrative Tools → Services.
   • Right-click Actian Integration Manager and select Restart.

note

Configuration file changes will survive uninstallation/reinstallation.

Service Logs & Monitoring

1. You can monitor service activity and get important additional information from the log file (default: C:\ProgramData\Actian\IntegrationManager\logs\IntegrationManager.log)

2. You can retrieve DataConnect Engine log files by Job Id in the job history folder (default: C:\ProgramData\Actian\IntegrationManager\history\job)

   note

   Log file data will survive uninstallation/reinstallation.

Uninstallation

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

Linux

Linux Installation

Prerequisites

1. Linux Operating System
   • Red Hat Enterprise Linux 7.9 and 8 (64-bit U.S. English edition)
   • GTK Version 3
   • You need to install libnsl.so.1 separately on RHEL 8.1 or above versions.
   • Linux user account with sudo privileges
2. 64-bit processor, 2.90GHz
3. 16 GB Installed memory (RAM)
4. DataConnect v12 License file (typically *.slc)

What Will Be Installed

1. Actian Integration Manager (Linux Daemon)
2. Actian Integration Manager Worker (Linux Daemon, optional usage)
3. DataConnect v12 Embedded Engine
4. AdoptJDK 11 Embedded JRE

Installation

1. Download Actian Integration Manager for Linux from Actian ESD: https://esd.actian.com/.
2. Locate the downloaded rpm file (integration-manager-3.x.x.noarch.rpm).
3. Switch to root user: sudo su
4. The libnsl library required by DataConnect was removed from the base install of RedHat starting with RedHat 8.1. If you are running a version of RedHat or Amazon Linux that does not include the libnsl library, run the following command: yum install libnsl.
5. Install rpm with yum: yum install integration-manager-3.x.x.noarch.rpm
6. Confirm the installation path (default: /opt/actian/integration-manager).
7. Confirm the shared data path (default: /etc/opt/actian/integration-manager).
8. 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 to your requirements and environment. See Application Property Reference for a description of available properties.

1. Locate the application.properties file (default: /etc/opt/actian/integration-manager/conf/application.properties)

   note

   Note that if you have a previous installation of Integration Manager, none of your existing property values will be changed.

2. Confirm or alter the path to your DataConnect v12 license file using the property engine.licensePath (default: /etc/opt/actian/integration-manager/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.

3. You can also run Integration Manager on a different port using the property server.port (default: 8080).

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

note

Configuration file changes will survive uninstallation/reinstallation.

Service Logs & Monitoring

1. You can monitor service activity and get important additional information from the log file (default: /etc/opt/actian/integration-manager/logs/integration-manager.log)

2. You can retrieve DataConnect Engine log files by Job Id in the job history folder (default: /etc/opt/actian/integration-manager/history/job)

   note

   Log file data will survive uninstallation/reinstallation.

Start, Stop, Status, Uninstall

• Start: sh -x /etc/init.d/imservice start
• Stop: sh -x /etc/init.d/imservice stop
• Status: sh -x /etc/init.d/imservice status
• Uninstall: yum uninstall integration-manager-3.x.x.noarch.rpm

Docker

Docker Installation

Integration Manager can be installed using a Docker image via Docker Desktop and Docker CLI.

Prerequisites

• DataConnect Cloud or Avalanche Subscription
• Docker Hub account
• Access to the Actian Docker Hub. Create a New Case to request access to the Actian Docker Hub.

Install Docker Desktop

1. Download Docker Desktop from https://hub.docker.com/.

2. Run the Docker Desktop installer using recommended settings.

3. Launch Docker Desktop and sign in.

4. Click the Hub tab.

5. Select actian in the hub dropdown.

6. Enter manager in the search field.

7. Ensure that you have access to the actian/integration-manager-standalone image:

   

8. Create the following Docker Compose file with the name docker-compose.yaml:

   version: '3.8'
   volumes:
     job_logs:
     conf_props:
     h2_dir:
     repo_dir:
     license_path:
       driver: local
       driver_opts:
         type: none
         device: <path to license file, such as ./src/main/license>
         o: bind
   services:
     im_service:
       image: actian/integration-manager-standalone:3.3.0-SNAPSHOT
       user: root
       privileged: true
       hostname: im-manager
       volumes:
         - conf_props:/opt/Actian/conf
         - license_path:/opt/Actian/volume
         - h2_dir:/opt/Actian/embedded/data
         - job_logs:/opt/Actian/local/work/job
         - repo_dir:/opt/Actian/repository
       ports:
         - 8080:8080
       command: sh -c "tail -f /dev/null"

9. Save the docker-compose.yaml file to local folder.

10. Update the device property to point to the path of your cosmos.slc license file, relative to the folder containing the docker-compose.yaml file.

11. The image specified above is 3.3.0-SNAPSHOT. You can specify any image listed in the Tags column:

    

    note

    If latest is listed for the image, specifying image: actian/integration-manager-standalone:latest will pull the latest image.

12. If desired, you can use a different port. To use port 8085, for example, you would change the above port entry to 8085:8080.

13. Open a command prompt and navigate to the folder containing the docker-compose.yaml file.

14. Run the following command:

    docker compose up

15. The Integration Manager service should now be running in your Docker container.

    note

    The link in Docker shown below to localhost:8080 (or whichever port you specified) will not work. To access Integration Manager, go to http://localhost:8080/ui/.

    

Configuration

Docker Desktop exposes directories containing configuration files, including the application.properties file, which can be used for a variety of configurations to tailor Integration Manager and Agent to your requirements and environment. See Application Property Reference for a description of available properties.

To modify the application.properties file in Docker Desktop, do the following:

1. In Docker Desktop, click Volumes in the left pane, then click docker_conf_props:

   

2. Double-click application.properties:

   

3. Make any desired edits, then click the disk icon to save changes.

   

Service Logs & Monitoring

You can monitor service activity and get important additional information from the log file in Docker Desktop. Do the following:

1. In Docker Desktop, click Containers in the left pane.

2. Click the Integration Manager service:

   

3. The Logs tab is displayed: