В данном разделе описываются глобальные команды управления ECSS-10. Глобальные команды выполняются без указания пути.
alias
Данная команда предназначена для добавления/удаления/просмотра алиаса команды.
Используется для длинных команд, которые часто используются.
Для просмотра информации о созданных алиасах команд указать list.
Для просмотра информации о созданных алиасах команд для экспорта указать export.
Для добавления нового алиаса команды указать add.
Для удаления алиаса команды указать del.
Путь команды:
alias
Синтаксис:
alias add <ALIAS>=<CMD>
alias del <ALIAS>
alias list
alias export
Параметры:
<ALIAS> - имя алиаса команды, включая путь к алиасу;
<CMD> - команда, включая путь к команде.
Пример:
Добавить алиас команды "domain/eltex.local/cocon/add-user" c именем "add-user".
ssw@[mycelium@ecss3]:/$ alias add add-user=domain/d.local/cocon/add-user ok
В результате выполнения команды в корневой каталог будет добавлена команда "add-user" с функционалом команды "domain/eltex.local/cocon/add-user".
Добавить алиас команды "domain/d.local/sip/sip3/user declare" с именем "domain/user_d".
ssw@[mycelium@ecss3]:/$ alias add domain/user_d = domain/d.local/sip/sip3/user declare ok
В результате выполнения команды в каталог "/domain" будет добавлена команда "user_d" с функционалом команды "domain/d.local/sip/sip3/user declare".
cd
Данной командой производится изменение рабочего каталога.
Путь команды:
cd
Синтаксис:
сd [<PATH>]
Параметры:
<PATH> - путь к каталогу.
Если использовать команду без указания параметра, то переход будет в корневой каталог.
Если в качестве параметра указать комбинацию ../, то переход будет на уровень выше.
Пример:
ssw@[mycelium@ecss3]:/# cd cluster/tts/tts3/ ssw@[mycelium@ecss3]:/cluster/tts/tts3# ssw@[mycelium@ecss3]:/cluster/tts/tts3# cd ../ ssw@[mycelium@ecss3]:/cluster/tts# ssw@[mycelium@ecss3]:/cluster/tts# cd ssw@[mycelium@ecss3]:/#
configure-clear
Команда возврата из режима конфигурирования.
Путь команды:
configure-clear
Синтаксис:
configure-clear
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ configure-clear Successfully clear the configuration mode. [exec at: 14.12.2015 12:37:46, exec time: 44ms, nodes: mycelium1@ecss1] admin@[mycelium1@ecss1]:/$
configure-info
Команда просмотра информации о пользователе, который находится в режиме конфигурирования системы:
- Id - идентификационный номер пользователя;
- User - имя пользователя;
- Auto-unlock time - время автоматического выхода из режима конфигурирования.
Путь команды:
configure-info
Синтаксис:
configure-info
Параметры:
Команда не содержит аргументов.
Пример:
Выход из режима настройки системы:
admin@[mycelium1@ecss1]:/[CONFIG]$ configure-info Configuration locks: -----------------T-----T-------------------T-----------¬ ¦ Id ¦User ¦ Auto-unlock time ¦ Locks ¦ +----------------+-----+-------------------+-----------+ ¦980526d5f6940ab2¦admin¦14.12.2015 12:46:41¦system lock¦ L----------------+-----+-------------------+------------ [exec at: 14.12.2015 12:41:41, exec time: 10ms, nodes: mycelium1@ecss1] admin@[mycelium1@ecss1]:/[CONFIG]$
configure-start
Команда для перехода в режим конфигурирования системы ECCS-10.
Если режим конфигурирования активен, то выполнять настройку может только пользователь, который активировал режим. Для других пользователей будет доступен только мониторинг системы.
В режиме конфигурирования внешний вид строки подсказки будет изменен на:
admin@[mycelium1@ecss1]:/[CONFIG]$
Путь команды:
configure-start
Синтаксис:
configure-start
Параметры:
Команда не содержит аргументов.
Пример:
Вход в режим настройки системы:
admin@[mycelium1@ecss1]:/$ configure-start Successfuly entered in the configuration mode for system. [exec at: 14.12.2015 12:27:28, exec time: 61ms, nodes: mycelium1@ecss1] admin@[mycelium1@ecss1]:/[CONFIG]$
configure-stop
Команда для выхода из режима конфигурирования системы ECCS-10.
Путь команды:
configure-stop
Синтаксис:
configure-stop
Параметры:
Команда не содержит аргументов.
Пример:
Выход из режима настройки системы:
admin@[mycelium1@ecss1]:/[CONFIG]$ configure-stop Successfully exit from the configuration mode. [exec at: 14.12.2015 12:28:48, exec time: 19ms, nodes: mycelium1@ecss1] admin@[mycelium1@ecss1]:/$
exec
Данная команда позволяет запустить на исполнение команды CLI из файла.
Путь команды:
exec
Синтаксис:
exec [-<OPTIONS>] <HOST> <PATH-TO-FILE>
Параметры:
<OPTIONS> - ключ, который задает способ вывода информации, способ остановки вывода и другое:
Вывод информации:
- v - подробный вывод;
- s - не показывать вывод команд, включая ошибки;
- g - показывать имена выполняемых команд и ошибки;
- e - показывать только ошибки.
Настройка остановки:
- E - по первой ошибке;
- A - по достижению конца файла.
Другие ключи:
- w - спрашивать подтверждение перед выполнением каждой команды;
- P - читать пароли из файла со скриптом (по умолчанию пароли читаются из консоли);
- i - при необходимости взаимодействия с пользователем читать данные из консоли (по умолчанию из файла читается все кроме паролей).
<HOST> - имя хоста, где находится файл;
<PATH-TO-FILE> - путь к файлу на хосте <host>.
Пример:
ssw@[mycelium@ecss3]:/$ exec -s ecss1 /home/ssw/import.cocon
exit
Данной командой завершается сеанс работы пользователя с интерфейсом командной строки CLI.
Путь команды:
exit
Синтаксис:
exit
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[mycelium_mgmt@ecss3]:/# exit bye
locate
Команда поиска местоположения команды по подстроке в имени команды, директории.
Путь команды:
locate
Синтаксис:
locate <STRING>
Параметры:
<STRING> - подстрока в имени команды, директории.
Пример:
ssw@[mycelium@ecss3]:/$ locate al/set /cluster/tts/tts3/properties/general/set /domain/eltex.local/set /domain/d.local/set /cluster/mediator/md3/properties/cocon_http_terminal/set
ls
Данной командой осуществляется просмотр списка команд и каталогов, которые содержатся в текущем каталоге.
Путь команды:
ls
Синтаксис:
ls [-Flags] [<PATH>]
Параметры:
-Flags - флаг (опциональный параметр, по умолчанию на экран выводятся команды и имена каталогов):
- d - просмотр списка каталогов;
- f - просмотр списка команд;
- a - отображать скрытые элементы;
- l - просмотр подробной информации:
- group - группа пользователей, которые могут выполнить команду;
- destination - место, где команда выполняется (имя ноды или имя группы нод);
- owner - владелец команды;
- is_executable - в случае если отображается информация о команде, "*" означает, что текущий пользователь может выполнить эту команду;
в случае если отображается информация о каталоге, "*" означает, что в каталоге содержатся доступные для выполнения пользователем команды. - name - имя команды.
<PATH> - путь к рабочему каталогу. Опциональный параметр.
Пример:
ssw@[mycelium@ecss3]:/# ls domain/eltex.local/ss/ activate deactivate info permissions ssw@[mycelium@ecss3]:/# ls -f cd exit ls man pwd shell-colors shell-exec-time shell-trace who ssw@[mycelium@ecss3]:/# ls -l domain/d.local/access-type/ ecss-d.local-domain-admin storage.ds3 ds * declare ecss-d.local-domain-admin storage.ds3 ds * info ecss-d.local-domain-admin storage.ds3 ds * remove
man
Данной командой осуществляется просмотр информации о команде и ее параметрах.
Путь команды:
man
Синтаксис:
man [<PATH>/]<COMMAND>
Параметры:
<PATH> - путь к рабочему каталогу;
<COMMAND> - команда, для которой запрашивается информация.
Пример:
ssw@[megaco3@ecss3]:/# man cluster/adapter/bridge3/remove Remove bridge by name Usage: remove <BRIDGE_NAME> <BRIDGE_NAME> - the name of the bridge
pwd
Команда просмотра рабочей директории.
Путь команды:
pwd
Синтаксис:
pwd
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[mycelium@ecss3]:/domain/eltex.local/ss# pwd /domain/eltex.local/ss
shell
Данной командой запускается командный интерпретатор с правами указанного пользователя.
Путь команды:
shell
Синтаксис:
shell [-u <LOGIN>]
Параметры:
[-u <LOGIN>] - имя учетной записи пользователя.
Пример:
ssw@[mycelium@ecss3]:/$ shell -u support [shell] password for support: support@[myceliym@ecss3]:/$
shell-options
Данной командой для терминала назначается цветовая схема, команда при подключении, формат командной строки, режим отображения времени исполнения команд.
Путь команды:
shell-options
Синтаксис:
shell-options <login-commands <COMMANDS>>
shell-options <prompt [Format]>
shell-options <exec-time [Flag]>
shell-options <auto-logout-timeout [Timeout]>
shell-options <colors [Color]>
shell-options <history-size [Size]>
shell-options <use-unicode [Flag]>
shell-options <public-key [Key]>
Параметры:
<subcommand [OPTIONS]>:
colors [Flag] - задает режим цветовой схемы:[Flag] - назначаемое действие:
- black, white – использовать цветовую схему при выполнении команды ls;
- off|false – не использовать.
Если параметр не указывать, на экран будет выведена информация о текущем состоянии.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options color off [shell] Colors: disabled
<login-commands <COMMANDS>> - команды, выполняемые при подключении пользователя к консоли;
<COMMANDS> - список команд CLI, разделяемых знаком точка с запятой (;), для отключения команд можно указать "undefined".
Пример:
ssw@[mycelium@ecss3]:/$ shell-options login-commands /node/uptime; /node/check-services
<prompt [FORMAT]> - задает формат приглашения командной строки:
[FORMAT] - набор макросов форматтеров:
- \l - username (login name);
- \n - node name;
- \p - текущий полный путь (current full path);
- \d - имя текущей директории (current directory name);
- \e - пустой макрос;
- \_ - пробельный символ.
Формат приглашения командной строки по умолчанию: \l@[\n]:\p.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options prompt \l\_My_Own_Text\_[\p] ssw My_Own_Text [/]$:
<exec-time [FLAG]> - управление режимом вывода времени выполнения команды:
[FLAG] - назначаемое действие:
- on - вывод времени выполнения команды включен;
- off - вывод времени выполнения команды выключен.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options exec-time off
<use-unicode [FLAG]> - управление режимом вывода unicode-символов (если значение равно false - то unicode символы будут пытаться перевестись в ASCII):
[FLAG] - назначаемое действие:
- on - использовать unicode;
- off - использовать только ASCII.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options use-unicode on
<auto-logout-timeout [Timeout]> - время бездействия, после которого абонента автоматически выкинет из консоли управления / Web-конфигуратора:
Timeout :: infinity | [60..4294967] секунд.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options auto-logout-timeout 1800
<history-size [Size]> - размер истории введенных команд CoCon-а для данного пользователя.
Size :: 60..200 секунд.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options history-size 150
<public-key [Key]> - ключ для авторизации в CoCon-а по SSH.
Key :: SSH Public key.
Пример:
ssw@[mycelium@ecss3]:/$ shell-options public-key ssh-rsa sdfgskdlfgjslkdfjglskdjfglsdjfglksjdflgkjsdlkfgjslkdfgsdf antoniy@ryabkov
sleep
Отложить выполнение shell на заданный интервал времени.
Путь команды:
sleep
Синтаксис:
sleep <NUMBER>[<SUFFIX>] ...
Параметры:
<NUMBER> - пауза на заданный интервал времени;
<SUFFIX> - s - интервал времени секунда (используется по умолчанию); m - минута; h - час; d - день.
Пример:
ssw@[mycelium@ecss3]:/$ sleep 10s
sudo
Команда позволяет пользователю, который не является привилегированным (root), выполнять команды от имени root.
Если команда не доступна пользователю, будет выдано сообщение: "You have no rights to do this".
При выполнении команды система запросит ввести повторно пароль пользователя для входа в систему (не пароль пользователя root).
Путь команды:
sudo
Синтаксис:
sudo [-u <UserName>] <Command>
sudo [-u <UserName>] -s
sudo -c <UserName>
Параметры:
[-u <UserName>] - имя пользователя (login name), под правами которого запускать команду/командный интерпретатор;
<Command> - имя команды, включая путь к команде;
-s - режим запуска командного интерпретатора (не команды);
-c <UserName> - проверить, есть ли у пользователя <UserName> права администратора ROOT.
Пример:
barmin@[ecss_mycelium@immortal]:/$ sudo /cocon/passwd sveta [sudo] password for barmin: Enter password: Confirm password: Password for user "sveta" has been successfully changed [exec at: 16.03.2012 16:03:28, exec time: 4s 205ms]
system-status
Команда просмотра системной информации:
- Node - имя ноды;
- Release - версия ПО определенной ноды;
- Erlang nodes -
- Mnesia nodes -
- Uptime - время с моменты запуска ноды в работу.
В таблице "Alarms list" выводится список предупреждений, активных в системе.
Путь команды:
system-status
Синтаксис:
system-status
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ system-status Checking... ┌─┬───────────────┬───────────────────────┬───────────────┬─────────────┬───────┐ │ │ Node │ Release │ Erlang nodes │Mnesia nodes │Uptime │ ├─┼───────────────┼───────────────────────┼───────────────┼─────────────┼───────┤ │ │core1@ecss1 │ecss_core-3.4.2.369 │core1@ecss1 │not running │11m 44s│ │ │ds1@ecss1 │ecss_ds-3.4.2.146 │ds1@ecss1 │ds1@ecss1 │7h 1m │ │ │md1@ecss1 │ecss_mediator-3.4.2.164│md1@ecss1 │md1@ecss1 │7h │ │ │megaco1@ecss1 │ecss_pa_megaco-3.4.2.50│megaco1@ecss1 │megaco1@ecss1│7h │ │ │mycelium1@ecss1│ecss_mycelium-3.4.2.55 │mycelium1@ecss1│not running │7h 1m │ │ │sip1@ecss1 │ecss_pa_sip-3.4.2.165 │sip1@ecss1 │sip1@ecss1 │2h 38m │ └─┴───────────────┴───────────────────────┴───────────────┴─────────────┴───────┘ All services are started. Alarms list on md1: ┌────┬────────┬─────┬─────┬────────┬───────┐ │Date│Severity│Cause│Class│Instance│Message│ ├────┼────────┼─────┼─────┼────────┼───────┤ └────┴────────┴─────┴─────┴────────┴───────┘ Selected: 0 Total: 0
whereami
Команда используется для вывода имени ноды@хоста, к которому подключен пользователь.
Путь команды:
whereami
Синтаксис:
whereami
Пример:
ssw@[mycelium@ecss3]:/$ whereami mycelium@ecss3
whereis
Команда используется для поиска в таблице путей и имен файлов заданной команды (строгое совпадение).
Путь команды:
whereis
Синтаксис:
whereis <CMD_NAME>
Параметры:
<CMD_NAME> - команда, путь к которой необходимо найти.
Пример:
ssw@[mycelium@ecss3]:/$ whereis add /domain/d.local/statistics/add /domain/d.local/access-group/add /cluster/storage/ds3/licence/add /domain/eltex.local/statistics/add /domain/eltex.local/access-group/add /cluster/mediator/md3/statistics/add /cluster/adapter/megaco3/gateways/add
who
Данная команда позволяет просмотреть список пользователей, которые работают с устройством.
Путь команды:
who
Синтаксис:
who
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[mycelium@ecss3]:/# who Login Node Login date ssw mycelium@ecss3 2011-10-18 11:35:31 ssw mycelium@ecss3 2011-10-18 16:11:52 ssw mycelium@ecss3 2011-10-19 10:45:04
whoami
Данная команда позволяет просмотреть имя пользователя, под которым вы работаете в системе.
Путь команды:
whoami
Синтаксис:
whoami
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[mycelium@ecss3]:/$ whoami ssw