В текущем разделе описываются команды управления учётными записями пользователей cocon- и web-конфигуратора.
Описание по управлению пользователями приведено в Части 3 Система управления ECSS-10, в разделе Управление пользователями.
add-user
Команда для создания новой учетной записи пользователя:
- имя пользователя (login);
- пароль пользователя(enter password/confirm password);
- группа пользователей.
Группы пользователей:
- ECSS-ADMIN – группа администраторов системы (ECSS global administrator). Содержит команды управления системой ECSS-10.
- ECSS-USER – группа пользователей системы (ECSS global user). Содержит команды мониторинга системы ECSS-10.
- ECSS-DOMAIN-ADMIN – группа администраторов виртуальной АТС (Administrator of <domain_name>). Содержит команды управления определенной виртуальной АТС.
- ECSS-DOMAIN-USER – группа пользователей виртуальной АТС (User of <domain_name>). Содержит команды мониторинга определенной виртуальной АТС.
Путь команды:
cocon/add-user
Синтаксис:
add-user [<UserName>]
Параметры:
<UserName> - имя пользователя.
Пример:
Добавить пользователя "admin_ssw" как администратора софтсвича
/cocon/add-user Login: admin_ssw Enter password: Confirm password: ECSS global user: [n]/y ?> y ECSS global administrator: [n]/y ?> y User user has been successfully created
Добавить пользователя "domain_ssw" как администратора домена "office.local".
/cocon/add-user domain_ssw Enter password: Confirm password: ECSS global user: [n]/y ?> n There are following domains in the system: d.local eltex.local office.local Select the domains administrated and used by the user: User of d.local: [n]/y ?> n User of eltex.local: [n]/y ?> n User of office.local: [n]/y ?> y Administrator of office.local: [n]/y ?> y User admin has been successfully created
add-user-to-group
Данной командой пользователю назначается группа пользователей, команды которой он сможет исполнять.
Группы пользователей:
- ecss-admin – группа администраторов системы. Содержит команды управления системой ECSS-10.
- ecss-user – группа пользователей системы. Содержит команды мониторинга системы ECSS-10.
- ecss-<domain_name>-domain-admin – группа администраторов виртуальной АТС с именем <domain_name>. Содержит команды управления виртуальной АТС с именем <domain_name>.
- ecss-<domain_name>-domain-user – группа пользователей виртуальной АТС с именем <domain_name>. Содержит команды мониторинга виртуальной АТС с именем <domain_name>.
Путь команды:
cocon/add-user-to-group
Синтаксис:
add-user-to-group <USER> <GROUP>
Параметры:
<USER> - имя пользователя;
<GROUP> - группа пользователя.
Пример:
Назначить пользователю с именем "tester" группу пользователей системы.
/cocon/add-user-to-group tester ecss-user Successful
del-role-from-user
Данной командой осуществляется удаление роли пользователя. Если пользователя не существует, то команда завершится ошибкой.
Путь команды:
cocon/del-role-from-user
Синтаксис:
del-role-from-user <ROLE> <USER_1> [<USER_2> ...]
Параметры:
<ROLE> - роль пользователя;
<USER> - имя пользователя.
Пример:
admin@[mycelium1@ecss1]:/$ cocon/del-role-from-user user2 Roles sucessfully removed from users.
del-user
Команда для удаления учетной записи из системы.
Путь команды:
cocon/del-user
Синтаксис:
del-user <UserName>
Параметры:
<UserName> - имя пользователя.
Пример:
/cocon/del-user tester User "tester" has been successfully deleted
del-user-from-group
Данной командой осуществляется удаление пользователя из заданной группы пользователей.
Путь команды:
cocon/del-user-from-group
Синтаксис:
add-user-to-group <USER> <GROUP>
Параметры:
<USER> - имя пользователя;
<GROUP> - группа пользователей.
Пример:
/cocon/del-user-from-group tester ecss-user Successfull
kill
Данной командой осуществляется принудительное завершение сессии пользователя. Команда доступна администратору системы.
Путь команды:
/cocon/kill
Синтаксис:
kill [-u <LOGIN>] <ID>
Параметры:
- <LOGIN> - имя пользователя в сессии;<ID>
- <ID> - CoCon session id (определить нужный id сессии можно из команды /who)
Пример:
support@[mycelium1@ecss1]:/$ who ID Login Node IP:Port Login date Initiator 1ma admin md1@ecss1 127.0.0.1:44454 2019-03-22 21:03:26 web-configurator 6a admin mycelium1@ecss1 192.168.1.12:33906 2019-03-22 21:03:06 ssh at any:8023 3m admin mycelium1@ecss1 192.168.1.12:33260 2019-03-22 20:45:23 ssh at any:8023 76 support mycelium1@ecss1 192.168.1.12:34116 2019-03-22 21:04:14 ssh at any:8023 [exec at: 22.03.2019 21:18:27, exec time: 4ms, nodes: mycelium1@ecss1] support@[mycelium1@ecss1]:/$ support@[mycelium1@ecss1]:/$ cocon/kill -u 1ma 3m 6a 76 support@[mycelium1@ecss1]:/$ cocon/kill 1ma ok [exec at: 22.03.2019 21:29:45, exec time: 66ms, nodes: mycelium1@ecss1]
list
Отображается список пользователей cocon- и web-конфигураторов, а также принадлежность пользователя к группе пользователей.
Записи в таблице могут быть упорядочены и отфильтрованы по любому параметру по убыванию или возрастанию, ограничены по количеству выводимых строк.
Путь команды:
cocon/list
Синтаксис:
list users|groups [where <filter>] [order by <column> [asc|desc]] [last|first <N>]
Параметры:
[where <filter>] - при указании команды "where" задается условие отбора записей в таблице:
<filter> - условие отбора записей, задается в виде <сolumn> = <value> [, <filter>], где
<column> - название колонки, по которой производится отбор, принимает значения:
- login - имя пользователя;
- group - группа пользователей.
<value> - значение, по которому совершается отбор.
[order by <column> [asc|desc]] - при указании команды "order by" задается условие сортировки записей в таблице:
<column> - название колонки, по которой будет сортировка записей, принимает значения: login, group.
[asc|desc] - способ сортировки:
- asc - по возрастанию;
- desc - по убыванию.
[last|first <N>] - ограничение по количеству выводимых строк:
- last - выводить последние N-строк таблицы;
- first - выводить первые N-строк таблицы;
- <N> - количество строк.
Пример:
/cocon/list users where login=user -------------------------------------- |Login| Groups | |-----+------------------------------| |user |ecss-admin | | |ecss-d.local-domain-admin | | |ecss-d.local-domain-user | | |ecss-eltex.local-domain-admin | | |ecss-eltex.local-domain-user | | |ecss-office.local-domain-admin| | |ecss-office.local-domain-user | | |ecss-user | --------------------------------------
nodes-summary
Команда предназначена для сбора данных из всех запущенных нод.
Путь команды:
/cocon/nodes-summary
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ cocon/nodes-summary Node Heartbeat UserDB AuditDB LDAP params MySQL params sip1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 restfs1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 mycelium1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 megaco1@ecss1 5000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 md1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 ds1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 core1@ecss1 3000ms mysql(+) mysql(+) - audit@cocon.mysql.ecss:3 306 For more information see /node/<Node>/cocon-info command [exec at: 21.02.2017 15:51:25, exec time: 517ms, nodes: core1@ecss1,ds1@ecss1,md 1@ecss1,megaco1@ecss1,mycelium1@ecss1,restfs1@ecss1,sip1@ecss1]
passwd
Команда для изменения текущего пароля пользователя, используемого при входе в систему.
Путь команды:
cocon/passwd
Синтаксис:
passwd [<UserName>]
Параметры:
<UserName> - имя пользователя.
Пример:
Изменить пароль для пользователя ssw.
/cocon/passwd ssw Enter password: Confirm password: Password for user "ssw" has been successfully changed