Step 1: Install IAG5 Server

Prerequisites

You will need the following to complete this guide:

• An Itential Automation Service account. To create a new trial account, go here: Itential Automation Service Trial Sign-up
• A Linux environment in which you can install either RPM or DEB installer packages.
  • Your Linux server must have a publicly visible host name.
  • Your Linux server must be able to connect to the public internet via port 443 and the WSS protocol.

1. Download the Itential Automation Gateway 5 Server Installer

The first step is to download a .deb or .rpm Itential Automation Gateway 5 (IAG5) installer package from Itential Cloud by following these steps:

1. Log in to your Automation Service account.
2. Go to Administration → Downloads
3. Wait for the list of downloadable packages to refresh
4. Select IAG 5 Server Installer package for either Debian or RPM and your CPU architecture
   (You must use one of the .deb or .rpm installers for this tutorial, not the .bin distributions)

2. Install IAG5

Next, you will install IAG5 using the package manager for your Linux distribution. In the example below we are using version 5.0.1 of the packages.

If you did not download the package onto your Linux server, copy it there now. Here is an example using the scp command to copy the package to your server.

scp /path/to/installer <your-user>@<server-hostname-or-ip>:/tmp

For Debian:

If you are using apt as your package manager run the following command:

sudo apt install ./iagctl-5.0.1-<arch>.deb

For RPM:

If you are using rpm as your package manager run the following command:

sudo dnf localinstall ./iagctl-5.0.1-amd64.rpm

3. Verify the Installation

Once the package is installed, you must give your user the proper permissions to view the installed files by running the following command:

sudo usermod -aG itential-admins $USER

Log out of the system and then back in to ensure the group changes take effect.

You should now have a running iagctl systemd service. Confirm by running the following command:

sudo systemctl status iagctl

sudo tail -n 15 /var/log/gateway/gateway.log

sudo journalctl -fu iagctl.service

2024-09-27T15:18:39Z INF using configuration file at /etc/gateway/gateway.conf
2024-09-27T15:18:39Z INF using local store database file at gateway.db
2024-09-27T15:18:39Z INF starting gateway server
2024-09-27T15:18:39Z INF working directory is /etc/gateway
2024-09-27T15:18:39Z INF

===================
 CREATED TEMPORARY ADMIN
 username: admin
 password: admin
===================


2024-09-27T15:18:39Z INF starting grpc server on [::]:50051/tcp

_
You now have a running IAG5 server.
_