- 12 Nov 2024
-
DarkLight
-
PDF
server
- Updated on 12 Nov 2024
-
DarkLight
-
PDF
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