Ask or search…
K

IT-Conductor Gateway Setup for Ubuntu/Linux x64

This is the first setup process after subscribing to the IT-Conductor service, following successful email validation, and accepting the End User Licensing Agreement (EULA).
The IT-Conductor Gateway allows 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:
sysctl -p
4. Navigate to the IT-Conductor menu: Support → Downloads → Gateway Downloads.
Figure 1: Gateway Installation Media Downloads
5. Download "itconductor-agent-6-71.x86_64.rpm" to a local directory.
Linux
Ubuntu
• Install the RPM package. You should see the following output:
# rpm -U itconductor-gateway-6-67.x86_64.rpm
Registering Service ...
Configuring Service Startup ...
IT-Conductor Gateway installed successfully
  • Install the Alien package.
$sudo apt-get install alien
  • Run the following command to convert RPM package to DEB package.
$sudo alien ./itconductor-gateway-6-67.x86_64.rpm
  • Install the .deb file. You can install the above .deb file using apt or dpkg command.
$sudo dpkg -i ./itconductor-gateway_6-68_amd64.deb
  • Execute post-install steps:
$sudo сp /opt/itconductor/init.d/itconductor-gateway.service /etc/systemd/system/itconductor-gateway.service
$sudo cp /opt/itconductor/conf/AGENT.XML.NEW /opt/itconductor/conf/AGENT.XML
$sudo systemctl enable itconductor-gateway
6. Edit "/opt/itconductor/conf/AGENT.XML" file. Replace the value holders as the following:
  • [ACCOUNTID] - This is the Service Account ID.
  • [APIKEY] - 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, navigate to the IT-Conductor menu: Management → Security → Service Accounts.
Figure 2: IT-Conductor Service Accounts
  • [GATEWAYID] - This is the ID for one of the Gateways created by your administrator earlier.
    • To obtain the Gateway ID, navigate to the IT-Conductor menu: Management → Resources → Gateways.
Figure 3: IT-Conductor Remote Gateways
If the proxy is used for connecting to the internet, update the values for the following keys:
<entry key="proxy">false</entry> <entry key="proxy.host">[PROXY Host]</entry> <entry key="proxy.port">[PROXY Port]</entry>
Additionally, if the proxy requires authentication, add the following lines:
<entry key="itconductor.agent.proxy.global">true</entry> <entry key="proxy.user">[PROXY User]</entry> <entry key="proxy.passwords">[PROXY Password]</entry>
Figure 4a: AGENT.XML Content Sample
Figure 4b: AGENT.XML Content Sample
7. Configure JRE; to verify that the default Java installation is Java 8 x64 JRE run the command below:
Linux
Ubuntu
# java -version
$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 the Gateway Maximum Heap Size. The default size is limited to 1500 MB.
  • Edit the "/opt/itconductor/conf/startup" file and add/replace the value to "xmx=4000m". This limits the heap size to 4000 MB.
9. Test the IT-Conductor cloud connectivity using the command below:
Linux
Ubuntu
# curl -k https://agents.itconductor.com
$curl -k https://agents.itconductor.com
Usually, the call returns IT-Conductor home page HTML content. If the host or corporate firewall blocks the connection, the error message will be displayed.
10. To start the gateway, use the command below:
Linux
Ubuntu
Systemd Based Linux Distributions
# service itconductor-gateway start
$sudo systemctl start itconductor-gateway
# systemctl start itconductor-gateway
11. To stop the gateway, use the command below:
Linux
Ubuntu
Systemd Based Linux Distributions
# service itconductor-gateway stop
$sudo systemctl start itconductor-gateway
# systemctl stop itconductor-gateway