IT-Conductor Gateway Setup on Linux

The IT-Conductor Gateway enables communication between the customer's site network and the IT-Conductor cloud platform. It must be connected successfully before any private customer systems can be monitored by IT-Conductor.

Installation Instructions

1. Log in to the provisioned Gateway VM.

2. Configure TIME_WAIT socket recycling. Edit "/etc/sysctl.conf" and add the following entries before saving:

net.ipv4.tcp_fin_timeout = 20
net.ipv4.tcp_tw_reuse = 1
net.core.somaxconn = 65535

3. Reload the settings using the command below:

# sudo sysctl -p

4. In IT-Conductor, navigate to Support → Downloads → Gateway Downloads.

Figure 1: Gateway Installation Media Downloads

5. Download "itconductor-gateway-x-xx.xxx" to a local directory.

Linux

• Install the RPM package. You should see the following output:

# sudo rpm -U itconductor-gateway-x-xx.x86_64.rpm
Registering Service ...
Configuring Service Startup ...
IT-Conductor Gateway installed successfully

Ubuntu

• Install the DEB package. You can use dpkg or apt command:

$ sudo dpkg -i itconductor-gateway-6-81.deb
Registering Service ...
Configuring Service Startup ...
IT-Conductor Gateway installed successfully

or

$ sudo apt -i itconductor-gateway-6-71.deb
Registering Service ...
Configuring Service Startup ...
IT-Conductor Gateway installed successfully

6. Configure Gateway parameters:

# /opt/itconductor/gwconfig
IT-Conductor Gateway Configuration build: xxxxxxxxxxxx
Gateway ID [GATEWAYID]: xxxxxx
Account ID [ACCOUNTID]: xxxxxx
API Key [APIKEY]: xxxxxx
Proxy [false]:
Configuration saved

• Account ID - This is the Service Account ID.

• API Key - The API Key for the Service Account will be generated when the Service Account is created.

To obtain the Service Account ID and API Key in IT-Conductor, navigate to Management → Security → Service Accounts.

Figure 2: IT-Conductor Service Accounts

Then, select the account to display the configuration details, as shown in Figure 3.

Figure 3: IT-Conductor Service Account Properties

• Gateway ID - This is the ID for one of the Gateways created by your administrator earlier.

To obtain the Gateway ID in IT-Conductor, navigate to Management → Resources → Gateways.

Figure 4: IT-Conductor Remote Gateways

If the proxy is used for connecting to the internet, while running gwconfig utility choose Proxy=true:

# /opt/itconductor/gwconfig
IT-Conductor Gateway Configuration build: xxxxxxxxxxxx
Gateway ID [GATEWAYID]: xxxxxx
Account ID [ACCOUNTID]: xxxxxx
API Key [APIKEY]: xxxxxx
Proxy [false]: true
Proxy Host []: xxxxx
Proxy Port []: 8080
Configuration saved

7. Configure JRE. To verify that the default Java installation is Java 8 x64 JRE, run the command below:

Linux

# java -version

Ubuntu

$ java -version
$ sudo apt install openjdk-8-jre-headless

Figure 6: Ubuntu Java Version

After installation, run the following commands:

$java -version
openjdk version "1.8.0_312"
OpenJDK Runtime Environment (build 1.8.0_312-8u312-b07-0ubuntu1-b07)
OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)

You can download a tar version of OpenJDK JRE from the IT-Conductor site or from the Adoptium website.

• Extract the file to the "/opt/itconductor/" directory.

• Edit the "/opt/itconductor/conf/startup" file and replace the value to "java_path=./<JRE Directory>/bin/java".

8. Optionally configure Gateway custom Gateway Maximum Heap Size - the default size is calculated as: <system available memory> - 500MB.

• Edit the "/opt/itconductor/conf/startup" file, and replace the xmx value with "xmx=4000m". This limits the heap size to 4000 MB.

9. Test the IT-Conductor cloud connectivity using the command below:

# /opt/itconductor/gwupdate
IT-Conductor Gateway build: xxxxxxxxxx
Starting update...
Gateway.jar is up to date

Normally, the update either downloads the latest version of Gateway.jar or reports that it is up to date. If no connection can be established to the cloud service, an error message will be displayed.

10. To start the gateway, use:

# sudo systemctl start itconductor-gateway

11. To stop the gateway, use:

# sudo systemctl stop itconductor-gateway