In UserGate LogAn, you can perform basic device configuration with the help of the command-line interface, or CLI. The administrator can use CLI to run diagnostic commands, such as ping, nslookup, or traceroute, configure the network interfaces and zones, as well as reboot or shut down the device.
CLI can be useful for troubleshooting network problems or when access to the web console is lost --- for example, due to an incorrectly set interface IP address or erroneous zone access control settings that block connections to the web interface.
You can connect to the CLI using the standard VGA/keyboard ports (if physically present on the UserGate LogAn equipment), via the serial port, or via SSH over the network.
To connect to the CLI using a monitor and keyboard, follow these steps:
|
Task |
Description |
|---|---|
|
Step 1. Connect a monitor and keyboard to the UserGate LogAn device. |
Connect a monitor to a VGA (HDMI) port and a keyboard to a USB port. |
|
Step 2. Log in to the CLI. |
Log in to the CLI using the login name and password for a user with Full administrator permissions (the default is Admin). If the UserGate LogAn device has not undergone initial setup, use Admin as the login and utm as the password for accessing the CLI. |
To connect to the CLI using the serial port, follow these steps:
|
Task |
Description |
|---|---|
|
Step 1. Connect to the UserGate LogAn device. |
Use a special serial cable or a USB-Serial adapter to connect your computer to the UserGate LogAn device. |
|
Step 2. Launch a terminal. |
Launch a terminal that supports serial port connection, such as Putty for Windows or minicom for Linux. Establish a serial port connection using 115200 8n1 as the connection parameters. |
|
Step 3. Log in to the CLI. |
Log in to the CLI using the login name and password for a user with Full administrator permissions (the default is Admin). If the UserGate LogAn device has not undergone initial setup, use Admin as the login and utm as the password for accessing the CLI. |
To connect to the CLI using the SSH protocol, follow these steps:
|
Task |
Description |
|---|---|
|
Step 1. Allow CLI (SSH) access for the selected zone. |
Allow SSH access for the CLI protocol in the settings for the zone to which you want to connect for CLI management. The TCP port 2200 will be opened. |
|
Step 2. Launch an SSH terminal. |
Launch an SSH terminal on your computer, such as SSH for Linux or Putty for Windows. Specify UserGate LogAn's address as the IP address, 2200 as the connection port, and the login of a user with Full administrator permissions as the CLI login name (the default is Admin). For Linux, the connection command should look like this: ssh Admin@IPUserGateLogAn -p 2200 |
|
Step 3. Log in to the CLI. |
Log in to the CLI using the password for the user specified in the previous step. If the UserGate LogAn device has not undergone initial setup, use Admin as the login and utm as the password for accessing the CLI. |
The full list of commands is presented below:
|
Name |
Description |
|---|---|
|
help |
Lists the available commands. |
|
exit quit Ctrl+D |
Log out of the CLI. |
|
date |
View the current server time. |
|
gateway |
View or configure the gateway settings. For detailed information, see "gateway help". |
|
iface |
A set of commands used to view and configure network interface settings. For detailed information, see "iface help". |
|
license |
View the license information. |
|
netcheck |
Check the availability of a 3rd party HTTP/HTTPS server. netcheck [-t TIMEOUT] [-d] URL Options: -t: the maximum timeout for a server response. -d: request the website's content. Only headers are requested by default. |
|
nslookup |
Determine the IP address from a host name. |
|
ping |
Ping a specific host. |
|
radmin |
Enable or disable remote server access for UserGate LogAn technical support. |
|
radmin_e |
Enable or disable remote server access for UserGate LogAn technical support in case of a UserGate LogAn server freeze. |
|
reboot |
Reboot the UserGate LogAn server. |
|
route |
Create, modify, or delete a route. |
|
shutdown |
Shut down the UserGate LogAn server. |
|
traceroute |
Traceroute the connection to a specific host. |
|
zone |
A set of commands used to view and configure zone settings. For detailed information, see "zone help". |