Command Line Interface --- CLI (Description)

In UGMC, 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 UGMC equipment), via the serial port, or via SSH over the network.

To connect to the CLI using a monitor and keyboard, follow these steps:

Name

Description

Step 1. Connect a monitor and keyboard to the UGMC 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 and password for a user with UGMC root administrator permissions (the default is Admin/system).

Note If the device has not undergone initial setup, use Admin as the login and usergate as the password for accessing the CLI.

To connect to the CLI using the serial port, follow these steps:

Name

Description

Step 1. Connect to the UserGate Management Center.

Use a special serial cable or a USB-Serial adapter to connect your computer to UGMC.

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 and password for a user with UGMC root administrator permissions (the default is Admin/system). If the UGMC device has not undergone initial configuration, Admin/system should be used as the login name and utm as the password in order to access the CLI.

To connect to the CLI using the SSH protocol, follow these steps:

Name

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 UGMC address as the IP address, 2200 as the connection port, and the login of a user with root administrator permissions as the CLI login name (the default is Admin/system). For Linux, the connection command should look like this:

ssh Admin/system@IPUserGateMC -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 UGMC device has not undergone initial configuration, Admin/system should be used as the login name and utm as the password in order to access the CLI.

After a successful login to the CLI, you can view the list of available commands using the help command. To get detailed help on any command, use this syntax:

help command

For example, to get detailed help on using the iface command to configure network interfaces, invoke this command:

help Iface

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

Включить или отключить удаленный доступ к серверу для технической поддержки UserGate.

radmin_e

To enable or disable remote access to the server for UserGate technical support in case the UGMC server hangs up.

reboot

Reboot the UserGate Management Center server.

route

Create, modify, or delete a route.

shutdown

Shut down the UGMC 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".