Общие сведения

В программно-аппаратных комплексах (ПАК) UserGate, оснащенных модулем управления PMC (Platform Management Controller), доступен интерфейс командной строки PMC CLI. С помощью команд интерфейса вы можете просматривать состояние аппаратной платформы, настраивать параметры и режимы работы компонентов платформы, управлять доступом к платформе, восстанавливать работоспособность устройства.

О наличии модуля PMC на устройстве и типах портов для подключения — в документации на аппаратные платформы.

Подключение к PMC CLI

К интерфейсу командной строки PMC можно подключиться с помощью терминала через консольный порт устройства или удаленно с помощью протокола SSH.

Для подключения через консольный порт:

1. Подключите компьютер к устройству с помощью консольного кабеля.

2. Запустите программу — эмулятор терминала, например Putty для Windows или minicom для Linux. Установите подключение через последовательный порт, указав параметры подключения: 115200, 8 n 1.

3. Во время загрузки устройства нажмите Enter, когда в консоли появится строка Hit 'Enter' key to stop autoboot: 3.

 4. Введите логин и пароль для доступа в интерфейс.

Если нажать комбинацию клавиш Сtrl + ], загрузка устройства продолжится в обычном режиме.

После трех неудачных попыток входа вводится обязательный 10-секундный тайм-аут перед каждой следующей попыткой. Во время тайм-аута можно сбросить настройки PMC до первоначальных, нажав комбинацию клавиш Ctrl+e.

PMC login: 111
Password:
You have exceeded the number of attempts, 10 seconds timeout...
 
All configuration will be cleared and device will be reset. Continue? (y/n):

Для подключения с помощью протокола SSH:

1. Запустите на компьютере SSH-терминал, например SSH для Linux или Putty для Windows.

2. Укажите IP-адрес устройства, порт для подключения (по умолчанию — порт 22, в версии 7.5.0 и выше — 2220), имя пользователя (по умолчанию — admin, в версии 7.5.0 и выше — Admin).

Пример команды подключения для Linux: ssh Admin@<IP-address> -p 2220.

3. Войдите в CLI, используя пароль пользователя, указанного на предыдущем шаге. 

На интерфейс командной строки PMC можно переключиться из интерфейса UGOS CLI:

• Если вы подключены к UGOS CLI через консольный порт, нажмите комбинацию Ctrl + ] для переключения в PMC CLI. Для возвращения в UGOS CLI снова нажмите Ctrl + ].

• Если вы подключены к UGOS CLI с помощью SSH, нажмите комбинацию Ctrl + ] для переключения в PMC CLI. Для возвращения в UGOS CLI выполните команду aux.

Режимы работы PMC CLI

PMC CLI имеет два режима работы: режим просмотра и режим конфигурирования. 

После авторизации пользователь попадает в режим просмотра. В этом режиме могут выполняться команды просмотра состояния устройства и команды мониторинга сетевого окружения.

Символ приглашения командной строки в режиме просмотра имеет вид:

PMC>

Подробнее о командах, доступных в режиме просмотра, — в разделе «Режим просмотра PMC CLI».

Для переключения на режим конфигурирования используется команда configure. В режиме конфигурирования символ приглашения в командной строке меняется на: #. Вернуться в режим просмотра можно с помощью команды exit.  

PMC> configure
PMC#
PMC# exit        
PMC>

В режиме конфигурирования помимо команд режима просмотра доступны команды управления компонентами платформы и настройки параметров устройства.

Подробнее о командах, доступных в режиме конфигурирования, — в разделе «Режим конфигурирования PMC CLI».

Формат команд

Команды действий, не относящихся к конфигурации устройства, имеют следующий формат:

<util> <util_parameters>

<util> — действия, не относящиеся к конфигурированию PMC:

• aux — переход в CLI основного продукта.

• autoboot — запуск команды автозагрузки.

• history — вывод истории команд.

• ping — отправка ICMP ECHO_REQUEST к узлам в сети.

• reset — перезагрузка PMC или конкретной периферии (debug).

• update — обновление компонентов ПО или вспомогательных элементов.

• version — вывод версии ПО.

• configure — вход в режим конфигурирования.

• exit — выход из режима конфигурирования и применение настроек. В режиме просмотра — выход из терминала.

<util_parameters> — дополнительные параметры выполняемых действий.

Пример:

PMC> ping 192.168.1.1

Команды конфигурации в PMC CLI имеют следующий формат:

<action> <level> <filter> <configuration_info>

• <action> — действие, которое необходимо выполнить (create, set, show, delete).

• <level> — уровень конфигурации (cli, platform, network, factory, datetime, users).

• <filter> — идентификатор объекта, к которому происходит обращение для выполнения действия <action>.

• <configuration_info> — значения параметров, которые необходимо применить к объекту <filter>.

Пример:

PMC# set network gateway 192.168.1.1

Горячие клавиши

В интерфейсе командной строки PMC вы можете использовать следующие горячие клавиши:

• Tab — вызов встроенной помощи, автодополнение команды:

  • Если нажать Tab в режиме ожидания, выводится полный список команд, доступных на текущем уровне.

  • Если нажать Tab на этапе ввода команды, отображается список возможных параметров команды с кратким описанием.

  • Если написать первые несколько букв команды и нажать «Tab», команда будет дополнена.

• Ctrl + C — отмена ввода текущей команды.

• ↑, ↓ — прокрутка истории ввода команд.

PMC loader

PMC loader (загрузчик) предназначен для восстановления работоспособности программно-аппаратного комплекса.

В режим загрузчика можно войти только при подключении через консольный порт, нажав клавишу Enter во время вывода строки в консоли устройства: (loader) Hit 'Enter' key to stop autoboot: 1.

Строка приглашения в режиме загрузчика имеет вид:

loader>

Загрузчик не обращается к энергонезависимой памяти, поэтому все параметры конфигурации в режиме загрузчика будут установлены по умолчанию. Если в режиме загрузчика необходим доступ к внешним сетевым ресурсам, например к TFTP-серверу для скачивания образа ПО командой update, установите актуальный IP-адрес вашего устройства с помощью команды set network ip. Подробнее о командах настройки сетевых параметров — в разделе «Управление сетевыми параметрами».

В загрузчике работает таймер неактивности: если в течение 45 секунд не вводилось никаких команд, устройство будет перезагружено.