Команды call EcoSwitch Documentation / Интерфейс командной строки / Команды операционного режима / Команды call
- call aaa
- call aaa change-password
- call aaa change-user-role
- call aaa create-user-role
- call ааа create-user
- call ааа delete-role
- call ааа delete-user
- call rdp-firmware
- call rdp-firmware download
- call rdp-firmware install
- call rdp-firmware list
- call rdp-firmware reboot
- call rdp-firmware remove
- call rdp-firmware reset-tries
- call rdp-firmware set-active
- call rdp-firmware set-factory
- call rdp-firmware set-stable
- call netflow clear-statistic
- call ecofilter-balancer
- call ecofilter-balancer acl-external-dump
- call ecofilter-balancer acl-external-find-record
- call ecofilter-balancer download-certificate-key
- call ecofilter-balancer list-certificate-key
- call ecofilter-balancer remove-certificate-key
- call ecofilter-balancer set-bypass-ecofilter-unit
- call ecofilter-balancer sniffer
- call ecofilter-balancer sniffer set
- call ecofilter-balancer sniffer del
- call ecofilter-balancer sniffer start
- call ecofilter-balancer sniffer stop
Описание
Группа команд call позволяет выполнять удалённый вызов процедур:
- call aaa – управление AAA;
- call rdp-firmware – управление прошивкой;
- call <DEVICE_NAME> – мониторинг процессов, проходящих в рамках Устройства.
Режим
Команды доступны в операционном режиме.
Вызов команды
call {aaa <procedure> | rdp-firmware <procedure> | DEVICE_NAME <procedure>}
call aaa
Описание
AAA (Authentication, Authorization and Accounting) – система аутентификации авторизации и учета событий. Она предлагает различные методы идентификации пользователя, авторизации, а также сбора и отправки информации на сервер.
Группа команд call aaa позволяет выполнять управление ААА:
- call aaa change-password – смена пароля пользователя;
- call aaa change-user-role – cмена роли пользователя;
- call ааа create-user – создание пользователя;
- call ааа create-user-role – создания роли пользователя;
- call ааа delete-role – удаление роли пользователя;
- call ааа delete-user – удаление пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call {change-password <PARAMS> | change-user-role <PARAMS> | create-user <PARAMS> | create-user-role <PARAMS> | delete-role <PARAMS> | delete-user <PARAMS>}
call aaa change-password
Описание
Команда call aaa change-password позволяет сменить пароль пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa change-password user <USER_NAME> password <NEW_ PASSWORD>
Параметры команды
Название | Тип | Описание |
---|---|---|
user | Строка | Имя пользователя |
password | Строка | Новый пароль пользователя |
Пример
Консоль | Комментарий |
---|---|
admin> call aaa change-password user user_1 password Pass159!753 | Смена пароля пользователя |
call aaa change-user-role
Описание
Команда call aaa change-user-role позволяет сменить роль пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa change-user-role user <USER_NAME> new-role <NEW_ROLE>
Параметры команды
Название | Тип | Описание |
---|---|---|
user | Строка | Имя пользователя |
new-role | Строка | Новая роль пользователя |
Пример
Консоль | Комментарий |
---|---|
admin> call aaa change-user-role user user_1 new-role operator | Смена роли пользователя |
call aaa create-user-role
Описание
Команда call aaa create-user-role позволяет создать роль пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa create-user-role role <NEW_ROLE> description <TEXT> allow-view <SUBSYSTEM_NAME> allow-view-and-config <SUBSYSTEM_NAME>
Параметры команды
Название | Тип | Описание |
---|---|---|
role | Строка | Название роли пользователя |
description | Строка | Описание роли пользователя. Например, перечисление прав доступа роли. Вместо пробелов используйте символ нижнего подчеркивания "_" или дефис "-" |
allow-view | Строка | Название разделов конфигурации, к которым роли предоставляется право просмотра: 'mng-if, aaa, ntp ...' или 'all' - для выбора всех подсистем |
allow-view-and-config | Строка | Название разделов конфигурации, к которым роли предоставляется права просмотра и конфигурирования: 'mng-if, aaa, ntp ...' или 'all' - для выбора всех подсистем |
Пример
Консоль | Комментарий |
---|---|
admin> call aaa create-user-role role role_1 description rights_ntp_and_mng-if allow-view ntp allow-view-and-config mng-if | Создание роли пользователя |
call ааа create-user
Описание
Команда call aaa create-user позволяет создать нового пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa create-user user <USER_NAME> role <ROLE_NAME> password <PASSWORD>
Параметры команды
Название | Тип | Описание |
---|---|---|
user | Строка | Имя пользователя |
role | Строка | Название роли пользователя |
password | Строка | Пароль пользователя |
Пример
Консоль | Комментарий |
---|---|
admin> call aaa create-user user user_1 role operator password Pass159!753 | Создание нового пользователя |
call ааа delete-role
Описание
Команда call aaa delete-role позволяет удалить роль, созданную пользователем. Для удаления роли необходимо задать значение параметра <role> – имя роли пользователя.
Если удаляемая роль уже назначена пользователю, то выводится сообщение об ошибке со списком пользователей, которым назначена эта роль. Поэтому, перед удалением, необходимо назначить на другие роли или удалить пользователей, имеющих данную роль.
Для принудительного удаления роли, назначенной пользователям, необходимо использовать опцию – force. Пользователи, потерявшие роль в результате использования опции force, становятся неактивными до назначения им новой роли.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa delete-role {role <ROLE_NAME>} [force]
Пример
Консоль | Комментарий |
---|---|
admin> call aaa delete-role role role_1 force | Удаление роли пользователя |
call ааа delete-user
Описание
Команда call aaa delete-user позволяет удалить пользователя. Для выполнения команды необходимо указать параметр удаления <user> – имя пользователя.
Режим
Команда доступна в операционном режиме.
Вызов команды
call aaa delete-user user <USER_NAME>
Пример
Консоль | Комментарий |
---|---|
admin> call aaa delete-user user user_1 | Удаление пользователя |
call rdp-firmware
Описание
В Устройстве есть несколько видов встроенного программного обеспечения (прошивки).
Factory – заводская версия программного обеспечения, не подлежит изменению. Factory представляет собой базовую версию с ограниченной функциональностью.
Для полноценной работы Устройства необходима установка второго уровня программного обеспечения – image. Базовая версия прошивки image поставляется предустановленной на Устройство.
На одном Устройстве одновременно может быть установлена прошивка factory и не более двух прошивок image.
Группа команд call rdp-firmware позволяет выполнить настройку прошивки:
- call rdp-firmware download – скачивание прошивки;
- call rdp-firmware install – установка скачанной прошивки;
- call rdp-firmware list – вывод списка скачанных прошивках и их состоянии;
- call rdp-firmware reboot – перезагрузки Устройства;
- call rdp-firmware remove – удаление скачанной прошивки;
- call rdp-firmware reset-tries – сброс счётчика неудачных перезагрузок для текущей прошивки;
- call rdp-firmware set-active – установка активной прошивки;
- call rdp-firmware set-factory – установка заводской прошивки;
- call rdp-firmware set-stable – установка стабильного состояния прошивки.
Режим
Команда доступна в операционном режиме.
Вызов команды
call {download <PARAMS> | install <PARAMS> | list <PARAMS> | reboot <PARAMS> | remove <PARAMS> | reset-tries <PARAMS> | set-active <PARAMS> | set-factory <PARAMS> | set-stable <PARAMS>}
call rdp-firmware download
Описание
Команда call rdp-firmware download позволяет скачать прошивку с FTP или TFTP-сервера и сохранить ее на устройство с именем <file_name>.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware download from-url <URL> to-file <file_name>
Параметры команды
Название | Тип | Описание |
---|---|---|
from-url | Строка | Адрес сервера скачивания |
to-file | Строка | Имя файла прошивки |
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware download from-url ftp://user:password@xxx.xxx.xxx.xxx/ to-file filename | Скачивание образа прошивки с FTP-сервера для обновления с текущей версии и сохранение под именем filename. Доступ к FTP-серверу осуществляется через порт управления (MGMT). Система EcoDPIOS-LB сама определит, какой файл на сервере подходит для скачивания и обновления |
admin> call rdp-firmware download from-url ftp://user:password@xxx.xxx.xxx.xxx/ filename to-file filename | Скачивание файла с FTP-сервера и сохранение под именем filename, если он подходит для текущей платформы и возможно обновление до этой версии. Доступ к FTP-серверу осуществляется через порт управления (MGMT) |
admin> call rdp-firmware download from-url tftp://xxx.xxx.xxx.xxx/ to-file filename | Скачивание образа прошивки с TFTP-сервера для обновления с текущей версии и сохранение под именем filename. Доступ к TFTP-серверу осуществляется через порт управления (MGMT). Система EcoDPIOS-LB сама определит, какой файл на сервере подходит для скачивания и обновления. |
admin> call rdp-firmware download from-url tftp://xxx.xxx.xxx.xxx/filename to-file filename | Скачивание файла с TFTP-сервера и сохранение под именем filename, если он подходит для текущей платформы и возможно обновление до этой версии. Доступ к TFTP-серверу осуществляется через порт управления (MGMT). |
call rdp-firmware install
Описание
Команда call rdp-firmware install позволяет установить предварительно скаченную на Устройство прошивку.
Для указания имени скаченной прошивки вводится параметр – from-file.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware install from-file <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware install from-file image A | Установка скачанной прошивки |
call rdp-firmware list
Описание
Команда call rdp-firmware list позволяет выполнить вывод списка скачанных прошивках и их состоянии.
Для вывода детальной информации о скачанных прошивках необходимо ввести параметр <detail>.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware list <detail>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware list | Вывод списка скачанных прошивках и их состоянии. |
admin> call rdp-firmware list detail | Вывод детальной информации о скачанных образах и их состоянии.
Соответственно, образы могут подходить для установки или не подходить по разным причинам. В приведённом примере первый образ подходит, а второй несовместим с текущей платформой. |
call rdp-firmware reboot
Описание
Команда call rdp-firmware reboot позволяет выполнить перезагрузку Устройства.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware reboot {cancel | delay <NUM>}
Параметры команды
Название | Тип | Описание |
---|---|---|
cancel | Команда | Отмена перезагрузки |
delay | Число | Задержка перезагрузки в минутах |
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware reboot cancel | Отмена перезагрузки Устройства |
admin> call rdp-firmware reboot delay 5 | Перезагрузка Устройства |
call rdp-firmware remove
Описание
Команда call rdp-firmware remove позволяет удалить скачанную прошивку.
Для указания имени скаченной прошивки вводится параметр – file.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware remove file <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware remove file image A | Удаление скачанной прошивки |
call rdp-firmware reset-tries
Описание
Команда call rdp-firmware reset-tries позволяет сбросить счетчик неудачных перезагрузок прошивки.
Для указания имени скаченной прошивки вводится параметр – image.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware reset-tries image <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware rest-tries image A | Сброс счетчика неудачных перезагрузок прошивки |
call rdp-firmware set-active
Описание
Команда call rdp-firmware set-active позволяет установить активную прошивку.
Для указания имени активной прошивки вводится параметр – image.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware set-active image <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware set-active image A | Установка активной прошивки |
call rdp-firmware set-factory
Описание
Команда call rdp-firmware set-factory позволяет установить заводскую прошивку.
Для указания имени заводской прошивки вводится параметр – image.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware set-factory image <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware set-factory image factory | Установка заводской прошивки |
call rdp-firmware set-stable
Описание
Команда call rdp-firmware set-stable позволяет установить стабильное состояние прошивки.
Для указания имени прошивки вводится параметр – image.
Режим
Команда доступна в операционном режиме.
Вызов команды
call rdp-firmware set-stable image <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call rdp-firmware set-stable image A | Установка стабильного состояния прошивки |
call netflow clear-statistic
Описание
Команда call netflow clear-statistic позволяет выполнить очистку статистики по потоку данных.
Режим
Команда доступна в операционном режиме.
Вызов команды
call netflow clear-statistic
Пример
Консоль | Комментарий |
---|---|
admin> call netflow clear-statistic | Очистка статистики по потоку данных. |
call ecofilter-balancer
Описание
Группа команд call ecofilter-balancer позволяет проводить удалённый вызов процедур:
- call ecofilter-balancer acl-external-dump – формирование и скачивание файла с данными о проведенном мониторинге трафика, поступающего из внешних источников;
- call ecofilter-balancer acl-external-find-record – поиск по записям фильтрации трафика, поступающего из внешних источников;
- call ecofilter-balancer download-certificate-key – скачивание сертификата или ключа из исходного url-адреса;
- call ecofilter-balancer list-certificate-key – просмотр списка сертификатов и ключей;
- call ecofilter-balancer remove-certificate-key – удаление скаченного сертификата или ключа;
- call ecofilter-balancer set-bypass-ecofilter-unit – задать условие, по которому необходимо отводить трафик от фильтра;
- call ecofilter-balancer sniffer – мониторинг входящего и выходящего трафика, проходящего через Устройство.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer {acl-external-dump <PARAMS> | acl-external-find-record address <PARAMS> | download-certificate-key <PARAMS> | list-certificate-key | remove-certificate-key <PARAMS> | set-bypass-ecofilter-unit | sniffer <PARAMS>}
call ecofilter-balancer acl-external-dump
Описание
Команда call ecofilter-balancer acl-external-dump позволяет выполнить формирование и отправку файла с данными о проведенном мониторинге трафика, поступающего из внешних источников.
Для отправки файла на FTP-сервер вводится параметр – to-uri.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer acl-external-dump to-uri <ftp://uri/path/filename>
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer acl-external-dump ftp://uri/path/filename | Формирование и скачивание файла с данными о проведенном мониторинге трафика, поступающего из внешних источников, на Устройстве. |
call ecofilter-balancer acl-external-find-record
Описание
Команда call ecofilter-balancer acl-external-find-record позволяет выполнить поиск по записям фильтрации трафика, поступающего из внешних источников.
Для указания искомой записи вводится параметр – address в формате <IP/LPM:Port>.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer acl-external-find-record address <IP/LPM:Port>
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer acl-external-find-record address 2001::0/64:1000 | Поиск по записям фильтрации трафика, поступающего из внешних источников. |
call ecofilter-balancer download-certificate-key
Описание
Команда call ecofilter-balancer download-certificate-key позволяет выполнить скачивание сертификата или ключа из исходного url-адреса.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecodds download-certificate-key from-url <URL> to-file <file_name>
Параметры команды
Название | Тип | Описание |
---|---|---|
from-url | Строка | Исходный url-адреса |
to-file | Строка | Имя файла сертификата или ключа |
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer download-certificate-key from-url ftp://admin:admin_pass@10.149.131.60/cert/clientcert.pem to-file clientcert.pem | Скачивание сертификата или ключа из исходного url-адреса. |
call ecofilter-balancer list-certificate-key
Описание
Команда call ecofilter-balancer list-certificate-key позволяет выполнить просмотр списка сертификатов и ключей.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer list-certificate-key
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer list-certificate-key | Просмотр списка сертификатов и ключей. |
call ecofilter-balancer remove-certificate-key
Описание
Команда call ecofilter-balancer remove-certificate-key позволяет выполнить удаление скачанного сертификата или ключа.
Для указания имени скаченного сертификата или ключа вводится параметр – file.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer remove-certificate-key file <file_name>
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer remove-certificate-key file Key | Удаление скаченного сертификата или ключа. |
call ecofilter-balancer set-bypass-ecofilter-unit
Описание
Команда call ecofilter-balancer set-bypass-ecofilter-unit позволяет переключать режимы работы группы балансировки <ecofilter-unit>.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer set-bypass-ecofilter-unit unit <NAME> {auto | bypass | primary}
Параметры команды
Название | Тип | Описание |
---|---|---|
unit | Строка | Имя группы балансировки трафика <ecofilter-unit> |
auto | Строка | Направлять трафик на группу балансировки, если она активна. Если не активна, то включается режим bypass. |
bypass | Строка | Пропускать трафик прозрачно через линк напрямую и не заворачивается на группу балансировки. |
primary | Строка | Заворачивать трафик на группу балансировки принудительно. |
Пример
Консоль | Комментарий |
---|---|
call ecofilter-balancer set-bypass-ecofilter-unit U1 bypass | Назначение условия, по которому необходимо фильтровать трафик. |
call ecofilter-balancer sniffer
Описание
Группа команд call ecofilter-balancer sniffer позволяет выполнять мониторинг входящего и выходящего трафика, проходящего через Устройство:
- call ecofilter-balancer sniffer set – настройка интересующего трафика для мониторинга;
- call ecofilter-balancer sniffer del – удаление настройки интересующего трафика для мониторинга;
- call ecofilter-balancer sniffer start – запуск мониторинга;
- call ecofilter-balancer sniffer stop – остановка мониторинга.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer sniffer {set <PARAMS> | del <PARAMS> | start <PARAMS> | stop}
call ecofilter-balancer sniffer set
Описание
Команда call ecofilter-balancer sniffer set позволяет настроить группу параметров для мониторинга трафика, проходящего через Устройство.
Название группы параметров <NAME> присваивается произвольное значение (например, sniffer-match-1). В командах следует указывать только значение имени группы параметров.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer sniffer set name <NAME> port <NAME> ipv4-dst ipv4-src ipv6-dst ipv6-src tcp-dst-port tcp-src-port udp-dst-port udp-src-port udplite-dst-port udplite-src-port
Параметры команды
Название | Тип | Описание |
---|---|---|
port | Строка | Номер порта |
ipv4-dst | Строка | Назначение IPv4 в форматах:
|
ipv4-src | Строка | Источник IPv4 в форматах:
|
ipv6-dst | Строка | Назначение IPv6 в форматах:
|
ipv6-src | Строка | Источник IPv6 в форматах:
|
tcp-dst | Строка | Порт назначения TCP |
tcp-src | Строка | TCP-порт источника |
udp-dst | Строка | Порт назначения UDP |
udp-src | Строка | Порт источника UDP |
udplite-dst | Строка | Порт назначения UDPlite |
udplite-src | Строка | Исходный порт UDPlite |
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer sniffer set name p1-1-match port p1-1 | Настройка параметров для мониторинга трафика, проходящего через порт Устройства |
call ecofilter-balancer sniffer del
Описание
Команда call ecofilter-balancer sniffer del позволяет удалить настройку группы параметров для мониторинга трафика, проходящего через Устройство. Для выполнения команды необходимо указать параметр удаления <NAME> – имя группы параметров для мониторинга трафика, заданный командой call ecofilter-balancer sniffer set.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer sniffer del <NAME>
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer sniffer del sniffer-match-1 | Удаление настройки группы параметров для мониторинга трафика |
call ecofilter-balancer sniffer start
Описание
Команда call ecofilter-balancer sniffer start позволяет настроить параметры запуска мониторинга трафика, проходящего через Устройство.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer sniffer start target-address <IP-address> target-port <NUM> limit-by-packets <NUM> limit-by-time <SEC>
Параметры команды
Название | Тип | Описание |
---|---|---|
target-address | IP-адрес | IP-aдрес, с которого осуществляется мониторинг трафика |
target-port | Число | Номер порта, через который проходит интересующий трафик. Диапазон допустимых значений от 1 и более. По умолчанию 37008. |
limit-by-packets | Число | Количество пакетов данных, разрешенных к отправке. После достижения лимита команда будет остановлена. |
limit-by-time | Секунды | Время, в течение которого будет осуществляться отправка пакетов данных. После достижения лимита команда будет остановлена. |
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer sniffer start target-address 192.168.100.100 target-port 49 limit-by-packets 10 limit-by-time 2000 | Запуск мониторинга трафика, проходящего через Устройство |
call ecofilter-balancer sniffer stop
Описание
Команда call ecofilter-balancer sniffer stop позволяет выполнить остановку мониторинга трафика, проходящего через Устройство.
Режим
Команда доступна в операционном режиме.
Вызов команды
call ecofilter-balancer sniffer stop
Пример
Консоль | Комментарий |
---|---|
admin> call ecofilter-balancer sniffer stop | Oстановка мониторинга трафика, проходящего через Устройство |