В данном разделе описываются глобальные команды управления 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]$

Выход из режима конфигурирования будет выполнен автоматически через 5 минут при отсутствии активности пользователя.

Путь команды:

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.

Команда доступна только для пользователей группы ECSS-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

Быстрые ссылки

Дерево страниц

alias

cd

configure-clear

configure-info

configure-start

configure-stop

exec

exit

locate

ls

man

pwd

shell

shell-options

sleep

sudo

system-status

whereami

whereis

who

whoami

Быстрые ссылки

Дерево страниц

/root - глобальные команды

alias

cd

configure-clear

configure-info

configure-start

configure-stop

exec

exit

locate

ls

man

pwd

shell

shell-options

sleep

sudo

system-status

whereami

whereis

who

whoami