iagctl server

Start the gateway server.

The iagctl server command launches a gateway server that other gateway clients can connect to. Before you run this command, set the gateway application mode to server using the GATEWAY_APPLICATION_MODE configuration variable.

Syntax

$
iagctl server [flags]

Usage notes

Connect to Gateway Manager

You can connect your IAG deployment to Gateway Manager and Itential Platform by enabling GATEWAY_CONNECT_ENABLED and setting a certificate with the GATEWAY_CONNECT_CERTIFICATE_FILE configuration variable.

When the gateway connects successfully, you’ll see a log message: connected to gateway manager at {{host:port}}.

Admin user creation

On the first launch of iagctl server, the gateway logs temporary credentials for the admin account. The log entry resembles the following:

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

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

For more information on resetting passwords, see Manage users and credentials.

Admin user password recovery

If you forget the admin account credentials, you can recover the account by running iagctl server --recover-admin-user. This process requires access to the server with two terminals open. The gateway prompts you to enter a new password for the admin user.

Examples

Start the gateway server

$
iagctl 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        Start a recovery process if the admin user credentials are lost.

Options inherited from parent commands

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