Install Gateway Manager

Gateway Manager is a platform application that enables secure connections between Itential Platform and your Itential Automation Gateway (IAG) deployments.

Version compatibility

Gateway Manager is compatible with IAG 5.1.0+, Itential Platform 2023.2.17+, and Itential Platform 6.0.4+.

Download the Gateway Manager artifact

Download the Gateway Manager artifact from the Itential repository.

Before copying the example installation commands, replace <version> with the version number of the Gateway Manager artifact that you downloaded.

Installation by Platform version

The installation process varies depending on your platform version.

Itential Platform 6 installation

For Platform 6 installations, use the following RPM installation command:

$
rpm -Uh app-gateway_manager-<version>.noarch.rpm

The system installs the application in this default directory:

$
/opt/itential/platform/services

Itential Platform 2023.2 installation

For Itential Platform 2023.2 installations, you must specify a custom installation directory using the --prefix flag:

$
rpm -Uh --prefix=/YOUR/INSTALL/DIR app-gateway_manager-<version>.noarch.rpm

Replace YOUR/INSTALL/DIR with your installation directory. Your install directory might look like:

$
/opt/itential/current/node_modules/@itential

If you installed Itential Platform using the bin installer, Platform might be running under the pronghorn user. In that case, run the following command:

$
sudo chown -R pronghorn:pronghorn /YOUR/INSTALL/DIR/app-gateway_manager

Post-installation

After installation completes, Gateway Manager becomes available as a platform application and can be accessed from the Itential Platform Dashboard under the Administration collection.

Before you can connect your gateway deployments to Gateway Manager, you must create and upload a certificate to enable mutual TLS authentication between IAG and Gateway Manager. This certificate ensures secure platform connectivity.

To get started, create and upload Gateway Manager certificates.

User authorization group

Before proceeding with the IAG installation, verify that at least one group associated with your user has the proper Gateway Manager roles. For detailed information about these roles, see the RBAC in Gateway Manager page.

To view your existing groups:

1. Navigate to the Itential Platform Dashboard
2. Click Admin Essentials in the left navigation bar
3. Click Authorization
4. Click Groups