Install IAG RPM/DEB package

The RPM/DEB installation method provides a traditional binary installation approach for Linux environments, offering native package management integration and systemd service control.

Step 1: Download the installation package

Download the appropriate IAG installer package for your Linux distribution from Nexus. The installers are available in the automation-gateway5-releases repository under Linux server-installers.

For example, RPM-based systems: iagctl-5.1.0-amd64-server.rpm
For example, DEB-based systems: iagctl-5.1.0-amd64-server.deb

If downloading to a different machine, transfer the package to your target server:

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

Step 2: Install the package

Update the version and arch to reflect the version you downloaded before running the example installation commands.

Debian installation

$ sudo apt install ./iagctl-<version>-<arch>-server.deb

RPM installation

$ sudo dnf localinstall ./iagctl-<version>-<arch>-server.rpm

Step 3: Configure user permissions

Add your user to the itential group to access installed files:

$ sudo usermod -aG itential $USER

Log out and back in to ensure group changes take effect.

Step 4: Verify installation

Confirm the gateway server is running:

$ sudo systemctl status iagctl

Expected Output:

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

Post-installation tasks

IAG is now installed. However, it is not yet connected to Gateway Manager or Itential Platform. For information on establishing these connections and other configuration procedures, see the subsequent steps.