server
  • 12 Nov 2024
  • Dark
    Light
  • PDF

server

  • Dark
    Light
  • PDF

Article summary

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 Itential Cloud

Gateways contain the functionality to connect to Itential Cloud services if GATEWAY_COMMANDER_ENABLED is enabled and an Itential provided certificate is present and set by the GATEWAY_COMMANDER_CERTIFICATE_FILE configuration variable.

If you have successfully connected to the Itential Commander, you will see a log message that says connected to commander 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. The user can then reset the password using the login flow described here.

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

CLI References

For all CLI commands see → Command References Index


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.