Для перехода в режим конфигурации интерфейса командной строки используется команда:
Admin@nodename> configure
В режиме конфигурации приглашение командной строки будет выглядеть следующим образом:
Admin@nodename#
Команды интерфейса командной строки имеют следующую структуру:
<action> <level> <filter> <configuration_info>
Где:
<action> — действие, которое необходимо выполнить;
<level> — уровень контекста конфигурации, который соответствует одному из разделов структуры конфигурации в веб-интерфейсе SWG;
<filter> — идентификатор объекта, к которому происходит обращение;
<configuration_info> — значение параметров, которые необходимо применить к объекту.
|
Наименование |
Описание |
|---|---|
|
<action> |
В режиме конфигурации доступны следующие действия:
Например, для просмотра информации о всех интерфейсах необходимо выполнить команду: Admin@nodename# show network interface
С использованием следующей команды производится переход на уровень network interface. Текущий уровень будет отображен под командной строкой:
После перехода на уровень network interface для отображения всех интерфейсов используется команда show без указания уровня:
Для возвращения c уровня network interface обратно на общий уровень режима конфигурации необходимо набрать команду end два раза:
Для возврата на самый верхний уровень конфигурации с помощью одной команды можно использовать команду top:
|
|
<level> |
Уровни контекста конфигурации в командной строке повторяют разделы конфигурации в веб-интерфейсе UserGate SWG:
|
|
<filter> |
Идентификатор объекта, к которому происходит обращение. Идентификация происходит по имени объекта. Если имеются объекты с одинаковыми именами или удобнее идентифицировать объект по другому параметру, то используются круглые скобки, в которых необходимо указать параметры(<configuration_info>). В результате будет найден объект, для которого совпали все поля, указанные в круглых скобках. Например, необходимо вывести информацию об интерфейсе port0 на другом узле кластера. Если использовать команду: Admin@nodename# show network interface adapter port0
Будет отображена информация об интерфейсе port0 текущего узла SWG. Чтобы отобразить информацию об интерфейсе port0 другого узла (например, с именем another_node), необходимо в скобках явно указать имя узла: Admin@nodename# show network interface adapter ( node-name another_nodename interface port0 )
Важно! Круглые скобки должны быть отделены пробелами с обеих сторон
|
|
Указание параметра с аргументом. Параметр — имя поля, для которого нужно установить аргумент. Аргумент может быть одиночным или множественным. Одиночный аргумент — значение, соответствующее параметру. Если строка содержит пробелы, то необходимо использовать кавычки. Например, необходимо создать группу с именем VPN users: Admin@nodename# create users group "VPN users"
Множественные аргументы используются для установки множества значений какого-либо параметра. Параметры записываются в квадратных скобках и разделяются пробелами. Например, необходимо в группу VPN users добавить пользователей user1 и user2. Параметру users необходимо задать аргумент [ user1 user2 ]: Admin@nodename# set users group "VPN users" users [ user1 user2 ]
Важно! Квадратные скобки должны быть отделены пробелами с обеих сторон
|
Команды имеют следующую структуру:
Admin@nodename# execute <command-name>
Список команд раздела execute.
|
Команда |
Описание |
|---|---|
|
cache |
Очистка кэша LDAP-записей:
|
|
check-geoip |
Проверка географической принадлежности IP-адреса по текущей базе GeoIP:
|
|
clear-cli-history |
Удаление истории команд интерфейса CLI. Можно удалить историю всех введенных команд интерфейса CLI или только команд в одном из режимов работы интерфейса (в режиме конфигурации или в режиме диагностики):
|
|
configurate-cluster |
Генерация секретного кода, необходимого для добавления нового узла в кластер конфигурации:
Где:
Важно! Для использования этой команды необходимо наличие лицензии на модуль Cluster
|
|
date |
Просмотр текущих значений даты и времени на узле:
|
|
dig |
Проверка записи DNS домена:
В команде можно использовать следующие параметры:
|
|
factory-reset |
Возврат устройства в первоначальное состояние.
Все данные и параметры будут утеряны. Версия ПО не изменится: сохранится версия, актуальная на момент запуска команды |
|
firewall |
Применение всех правил межсетевого экрана с обрывом текущих сессий:
|
|
license |
Команда регистрации продукта имеет следующую структуру: Admin@nodename# execute license activate <pin-code>
В качестве <pin-code> укажите код активации продукта |
|
logs |
Команда разовой отправки журналов по имеющемуся правилу экспорта журналов:
|
|
mc-force-disconnect |
Команда аварийного отключения узла от MC, с которым он был интегрирован. В зависимости от выбранного аргумента импортированные из MC объекты сохраняются локально или удаляются:
|
|
netcheck |
Проверка доступности стороннего HTTP или HTTPS-сервера. Могут быть использованы следующие параметры:
|
|
ping |
Проверка доступности определенного узла. Можно задать следующие параметры:
|
|
reboot |
Перезагрузка устройства:
|
|
restore-mac |
Восстановление mac-адреса интерфейса:
|
|
shutdown |
Выключение устройства:
|
|
termination |
Закрытие сессий администраторов или пользователей:
Подробнее — в разделе «Настройка сессий администраторов» |
|
traceroute |
Трассировка соединения до определенного узла. Параметры команды:
|
|
update |
Обновление:
|
Часть представленных выше команд, кроме команд обновления, регистрации продукта, управления сессиями администраторов и очистки кэша, также доступны в режиме диагностики и мониторинга. Для их выполнения используется команда:
Admin@nodename> <command-name>
Импорт доступен в разделах «Настройки», «Пользователи», «Сеть», «Политики сети», «Политики безопасности», «Глобальный портал».
В разделе «Настройки» (settings) можно импортировать сертификаты. Подробнее — в разделе «Настройка сертификатов».
В разделах «Пользователи» (users), «Сеть» (network), «Политики сети» (network-policy), «Политики безопасности» (security-policy), «Глобальный портал» (global-portal) можно импортировать правила, написанные на UPL. При использовании импорта, все существующие правила будут заменены на указанные.
В разделе «Пользователи» (users) можно импортировать правила captive-портала. Подробнее о правилах — в разделе «Captive-портал».
В разделе «Сеть» (network) можно импортировать правила DNS. Подробнее — в разделе «Настройка правил DNS».
В разделе «Политики сети» (network-policy) можно импортировать правила межсетевого экрана, NAT и маршрутизации, пропускной способности, балансировки нагрузки. Подробнее о правилах читайте в соответствующих разделах: «Настройка правил межсетевого экрана», «Настройка правил NAT и маршрутизации», «Настройка правил пропускной способности». «Настройка балансировки нагрузки».
В разделе «Политики безопасности» (security-policy) можно импортировать правила контентной фильтрации, веб-безопасности, инспектирования SSL, сценариев, ICAP-правил. О добавлении правил читайте в соответствующих разделах: «Настройка фильтрации контента», «Настройка веб-безопасности», «Настройка инспектирования SSL», «Настройка сценариев», «Настройка правил ICAP».
В разделе «Глобальный портал» (global-portal) можно импортировать правила веб-портала и reverse-прокси. Подробнее о создании правил — в разделах: «Настройка веб-портала» и «Настройка правил reverse-прокси».
Команда для экспорта сертификатов.
Вы можете экспортировать сертификаты, всю цепочку сертификатов и CSR:
Admin@nodename# export settings certificates <certificate-name>
Admin@nodename# export settings certificates <certificate-name> with-chain on
Подробнее об управлении сертификатами — в разделе «Настройка сертификатов».
Команда debug позволяет включить журналирование событий протоколов маршрутизации в режиме отладки. События записываются в debug-лог. Их просмотр также возможен в режиме мониторинга в консоли CLI (подробнее — в разделе «Диагностика и мониторинг»).
Для включения журналирования конкретного протокола маршрутизации используется команда:
Admin@nodename# debug <protocol> <parameters>
Поддерживаются следующие протоколы:
rip;
ospf
bgp;
igmp;
pim;
bfd;
msdp;
mroute — таблица мультикаст-маршрутизации;
ssmpingd — инструмент тестирования мультикаст-вещания.