Запуск консоли

Для перехода из режима разграничения доступа (S-Terra administrative console) в cisco-like консоль используется команда configure (см. документ «Консоль разграничения доступа». Раздел «Команды уровня администратора»).

 

Для всех АП, кроме ESR-ST, по этой команде осуществляется запуск cisco-like консоли. В зависимости от текущих настроек может быть запрошен логин и пароль пользователя ОС (подробнее смотрите документ «Консоль разграничения доступа», описание команды «создание пользователя», опция config-user). Изначально для входа в консоль установлен логин – cscons, пароль – csp.

 

На АП ESR-ST, после вввода команды configure, возможно использование двух консолей:

·       Cisco-like консоли (в документации для АП ESR-ST может именоваться как CGW CLI – Crypto Gateway CLI), при помощи которой настраивается IPsec. Логин для входа в консоль – cscons, пароль – password.

·       Собственной консоли АП ESR-ST – ESR CLI (Eltex Service Router CLI), в которой настраиваются сетевые интерфейсы (IP-адрес, маска подсети, MTU, состояние – включен/выключен, правила маршрутизации, имя хоста, а также создаются пользователи. Логин для входа в консоль – admin, пароль – password. Для работы с консолью ESR CLI пользуйтесь документацией – «Маршрутизаторы серии ESR. Справочник команд CLI».

В зависимости от введенного логина и пароля будет запущена соответствующая консоль.

 

Примечание: для работы консоли обязательно должен быть запущен сервис vpnsvc. Не останавливайте сервисы vpngate при работающей консоли, иначе она окажется неработоспособной.

Одним из первых действий при работе с cisco-like консолью устанавливаются параметры логирования, как и для сервиса vpnsvc (те же самые, что демонстрируются и выставляются с помощью утилиты log_mgr см. документ «Специализированные команды»).

При запуске для процесса cs_console выставляется значение переменной окружения PATH:

/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin.

Изменить значение переменной окружения PATH можно в файле cs_conv.ini (секция [env]), который расположен в каталоге /opt/VPNagent/bin.

 

Синхронизация 

При старте консоли происходит синхронизация описания CA-сертификатов в базе локальных настроек и Cisco-like конфигурации (команда trustpoint):

1.   Если в Cisco-like конфигурации присутствует сертификат, который отсутствует в базе локальных настроек (например, сертификат, удаленный с помощью команды cert_mgr remove), то этот сертификат автоматически удаляется из Cisco-like конфигурации с выдачей сообщения в лог. Если этот сертификат был последним в trustpoint, этот trustpoint автоматически удаляется.

2.   Если в базе локальных настроек присутствует сертификат, который отсутствует в Cisco-like конфигурации, то этот сертификат добавляется в Cisco-like конфигурацию командой truspoint с именем s-terra_technological_trustpoint. Если этот trustpoint отсутствует, он создается автоматически.

Также при старте консоли происходит синхронизация описания preshared ключей в базе локальных настроек и Cisco-like конфигурации:

1.   Если в Cisco-like конфигурации присутствует ключ, который отсутствует в базе локальных настроек (например, ключ, удаленный с помощью команды key_mgr remove), то этот ключ автоматически удаляется из Cisco-like конфигурации с выдачей сообщения в лог.

2.   Если значение ключа, указанного в Cisco-like конфигурации, поменялось в базе локальных настроек, то значение ключа также меняется и в Cisco-like конфигурации.

 

При запуске утилиты cs_console возможны ошибки, которые выдаются на консоль:

 

Таблица 1

Текст сообщения

Пояснение

ERROR: failed to read cs_conv.ini[: <reason>]

где <reason> (если присутствует) один из:

product was damaged or not installed

file has invalid format

integrity check failed

Не удалось прочитать файл настроек cs_conv.ini

Возможная причина:

продукт поврежден или некорректно установлен

файл имеет неправильный формат (вероятно допущена ошибка при редактировании)

не пройдена проверка целостности (одна из возможных причин – файл был отредактирован, при этом не был сделан вызов integr_mgr calc -f /opt/VPNagent/etc/cs_conv.ini)

ERROR: vpnsvc daemon is not running, cs_console will exit now!

Press ENTER to continue  

Ошибка: сервис vpnsvc не запущен. cs_console сейчас завершит работу.

Для продолжения нажмите ENTER…

(сообщение возникает, если во время работы cs_console был остановлен сервис vpnsvc)

ERROR: Could not initialize module manager.

Press ENTER to exit  

Ошибка: не удалось инициализировать module manager.

Для выхода нажмите ENTER…

(скорее всего, обозначает, что Продукт неправильно установлен или испорчен)

ERROR: Could not establish connection with daemon.

Press ENTER to exit  

Ошибка: не удалось установить связь с сервисом.

Для выхода нажмите ENTER…

(наиболее вероятная причина – попытка запуска cs_console при остановленном сервисе)

ERROR: Could not initialize resources.

Press ENTER to exit  

Ошибка: не удалось проинициализировать ресурсы.

Для выхода нажмите ENTER…

(скорее всего, обозначает, что Продукт неправильно установлен или испорчен)

ERROR: Could not initialize interfaces.

Press ENTER to exit  

Ошибка: не удалось проинициализировать интерфейсы.

Для выхода нажмите ENTER…

ERROR: Invalid XML file.

Press ENTER to exit...

Ошибка: неверный формат XML-файла.

Для выхода нажмите ENTER…

ERROR: Unable to get super-user privileges.

Press ENTER to exit...

Ошибка: невозможно получать права суперпользователя.

Для выхода нажмите ENTER…

ERROR: Internal error.

Press ENTER to exit...

Ошибка: внутренняя ошибка.

Для выхода нажмите ENTER…

Password required, but none set

Для входа в привилегированный режим требуется пароль, но он не задан в конфигурации.

 

Загрузка начальной конфигурации

Если при загрузке начальной конфигурации в какой-то из команд произошла ошибка:

·       Если для данной ошибки доступно специфическое сообщение (которое может быть выведено в случае подобной ошибки при ручном вводе команды), то это сообщение выдается на консоль.

·       На консоль выдается сообщение:

Warning: Command "<cmd>" processing failed

·       В лог выдается сообщение:

Command "<command_line>", processed with status FAIL

·       Команда игнорируется.

 

При старте cs_console читается файл /etc/ifaliases.cf.

cs_console воспринимает алиасы интерфейсов (параметр “name”) следующих форматов:

·       FastEthernet<n>/<m>,

·       GigabitEthernet<n>/<m>,

·       TenGigabitEthernet<n>/<m>, 

·       Async<n>, 

·       Port-channel<n>, Port-channel<n>/<m>, 

·       DP<n>, 

·       Bridge<n>, 

·       Tunnel<n>, 

·       Loopback<n>, 

·       E1port, 

·       Multilink, 

где <n> и <m> – произвольные неотрицательные числа. Пробелы в данных форматах не допускаются.

Интерфейс с алиасом “default” игнорируется без выдачи дополнительных сообщений.

Алиасы DP<n>, Bridge<n> и E1port отсутствуют в Cisco IOS.

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

Warning: Interface(s) <interface_list> ignored due to incompatible name format

где <interface_list> – список алиасов интерфейсов, которые проигнорированы cs_console.

Для работы cs_console необходимо, чтобы присутствовал хотя бы один интерфейс с подходящим алиасом. В противном случае cs_console завершит работу с выдачей сообщения об ошибке:

ERROR: At least one interface with compatible name must be present in file "/etc/ifaliases.cf".

Интерфейсы с алиасами Async, Port-channel, DP,Bridge, Tunnel, Loopback E1port и Multilink не могут настраиваться, т.е. для них нельзя выставить/удалить IP-адрес, настроить MTU, включить/отключить интерфейс и т.п. Нет никаких ограничений на ввод команд, которые транслируются в LSP (привязка ACL, inspect, crypto map, QoS и т.п.).

Информация с ненастраиваемых интерфейсов может быть отображена по команде show  run. Интерфейсы DP<n> по show  run показываются как:

interface DP1

! Warning: no physical interface found (pattern "10G_01")

 no ip address

 shutdown

!

Примечание: независимо от алиаса, настройка отключается для интерфейсов, в параметре "pattern" файла ifaliases.cf которых указан не конкретный физический интерфейс, а маска или перечисление.

Присутствующие на момент старта консоли физические сетевые интерфейсы распределяются по зачитанным логическим интерфейсам.

Если параллельно с запущенной cs_console были произведены действия, которые привели к появлению или исчезновению сетевых интерфейсов, то возможна рассинхронизация между реальным состоянием системы и его отображением в cs_console. При возникновении таких ситуаций, рекомендуется выйти и снова войти в cs_console.

Примечание: при работе на маршрутизаторах ESR-ST  после добавления или удаления виртуального сетевого интерфейса при помощи интерфейса командной строки (ESR CLI) маршрутизатора ESR-ST, необходимо выполнить cisco-like команду synchronize network-interfaces, чтобы синхронизировать список сетевых интерфейсов.

 

При старте cs_console производится проверка соответствия пользователей операционной системы и пользователей, указанных в Cisco-like конфигурации. Возможные ситуации и действия, выполняемые cs_console, описаны в Таблица 2.

Таблица 2

Присутствие пользователя в Cisco-like конфигурации

Присутствие пользователя в системе

Совпадение пароля в Cisco-like конфигурации и в системе

Указание cs_console в качестве shell у пользователя

Действие cs_console

+

+

+

+

Ничего не делается

+

+

 

*

Смена пароля в системе (Cisco-like конфигурация имеет приоритет)

+

+

*

 

Смена shell на cs_console

+

 

N/A

N/A

Создание пользователя (аналогично ручному вводу команды)

 

+

N/A

+

Только при соблюдении следующих условий:

а) Формат имени пользователя соответствует допустимому в команде username.

б) У пользователя установлен непустой пароль.

Добавление пользователя в Cisco-like конфигурацию. Использование зашифрованного пароля, зарегистрированного в системе. Выставление для пользователя минимального уровня привилегий (0).

Дополнительно в этом случае на консоль выдается предупреждение следующего вида:

% Warning: User(s) <user-list> were automatically added to configuration. Zero privilege level was assigned to them.

где <user-list> – список пользователей, автоматически добавленных в Cisco-like конфигурацию.

 

+

N/A

 

Ничего не делается

 

Примечания: 

Звездочка (*) обозначает, что для данной строки условие не важно.

N/A обозначает, что для данной строки условие неприменимо.

Если на старте выполняется какое-либо действие с пользователями, информация об этом действии выдается в лог.

Если при попытке сменить shell пользователя произошла какая-то ошибка, пользователь не добавляется в Cisco-like конфигурацию. На консоль выдается сообщение об ошибке:

% User "<username>" shell  change  failed.

Если при других действия произошла ошибка, пользователь также не добавляется в Cisco-like конфигурацию. На консоль выдается сообщение об ошибке, аналогичное сообщению, выдаваемому в подобной ситуации при попытке ручного добавления пользователя.