iagctl server

Start the server

Synopsis

This command launches a gateway server that can be connected to/from other gateway clients. In order to run the iactl server
command, the gateway application mode will need to be set to server via configuration variable GATEWAY_APPLICATION_MODE.

Connecting to Gateway Manager

You can connect your IAG deployment to Gateway Manager and Itential Platform if GATEWAY_CONNECT_ENABLED is enabled and a certificate is present and set by the GATEWAY_CONNECT_CERTIFICATE_FILE configuration variable.

If you have successfully connected to Gateway Manager, you will see a log message that says connected to gateway manager at at {{host:port}}.

Admin User Creation

On the first launch of iactl server, an entry is placed into the logs with temporary credentials for the gateway admin account. The log entry will resembles the entry shown below.

 CREATED TEMPORARY ADMIN 
 username: admin 
 password: V1j*tiXS@q2ey!k21(mHjJ9@f70zit(%

A correctly configured gateway client can then connect to the server by running iactl login admin.

For more information on resetting passwords, see User login.

Admin User Password Recovery

If the admin account credentials are forgotten, one can recover the admin account by running iactl server --recover-admin-user.

This process will require access to the server with two terminals open. The user can then enter a new password that will be used by the admin user.

iagctl server [flags]

Examples

Start the Gateway Server

iactl server

Options

--cert-file string          Certificate file to use (default "/etc/gateway/gateway.crt")
-h, --help                  Help for server
--private-key-file string   Private key file to use (default "/etc/gateway/gateway.key")
--recover-admin-user        Starts a recovery process if the admin user credentials are lost

Options Inherited from Parent Commands

--config string   Path to the configuration file
--raw             Displays the result of the command in its raw format
--verbose         Enable verbose output