/domain/<DOMAIN>/alias/ - команды управления алиасами
В этом разделе описываются команды управления, которые относятся к созданию/удалению алиасов и настройке параметров (свойств) алиасов.
Описание параметров алиаса приведено в Таблице 1.
Параметры (свойства) алиасов определяются на нескольких уровнях:
- Уровень алиаса – настройки уровня действуют на определенный алиас (имя домена, имя интерфейса и адрес).
- Уровень домена и интерфейса – настройки уровня действует на все алиасы с заданными именем домена и именем интерфейса.
- Уровень домена и адреса - настройки действуют на все алиасы с заданным именем домена и адресом.
- Уровень домена - настройки действуют на все алиасы с заданным доменом.
- Глобальный уровень - действует на все алиасы системы.
Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе /domain/<DOMAIN>/alias/ и применяются только для определенной виртуальной АТС.
address-clean
Команда предназначена для очистки свойств алиасов на уровне домена и адреса.
Путь команды:
/domain/<DOMAIN>/alias/address-clean
Синтаксис:
address-clean <address range> [<property>] [--force]
Параметры:
<address range> - диапазон адресов (номеров) для фильтрации;
<property> - название свойства алиаса (параметр опциональный, если данный параметра не задан, то удаляются значения всех свойств контейнера).
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[core1@ecss1]:/$ domain/biysk.local/alias/address-clean 240469 regime Property regime is cleaned for aliases' addresses within domain biysk.local: 240469 Legend: *: Cleaning broken <empty>: Successfull clean [exec at: 05.03.2019 10:06:44, exec time: 83ms, nodes: ds1@ecss1]
address-info
Команда предназначена для вывода информации о свойствах алиасов на уровне домена и адреса.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Путь команды:
/domain/<DOMAIN>/alias/address-info
Синтаксис:
address-info <address range>
Параметры:
<address range> - диапазон адресов (номеров) для фильтрации контейнеров.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/address-info 240469 Addresses in domain: biysk.local ┌───────┬─┬────────────────┬────────────────────────────────────┐ │Address│W│ Property │ Value │ ├───────┼─┼────────────────┼────────────────────────────────────┤ │240469 │d│access_group │all │ │ │d│access_type │access_type0 │ │ │D│category │ordinarySubscriber │ │ │d│cdr_group │bsk3 │ │ │a│displayName │ntp │ │ │d│language │ru │ │ │d│media-profile │"default" │ │ │a│nai │nationalNumber │ │ │D│ni │private │ │ │D│npi │isdnTelephony │ │ │D│pin │"1111" │ │ │D│screening │networkProvided │ │ │D│ss\mgm\telephone│enabled │ │ │d│timetables\tt2 │Name: tt2 │ │ │ │ │Date type: HOLIDAY; Time: 8:00-17:00│ │ │D│timezone │'UTC+07:00' │ └───────┴─┴────────────────┴────────────────────────────────────┘ Legend: W: Where property is set: a: This is address property in domain A: This is global address property d: This is domain property D: This is default property Note: * char in W column means "Can't read address info". Error reason in value column in this case [exec at: 27.03.2019 07:52:07, exec time: 66ms, nodes: ds1@ecss1]
clean
Команда используется для очистки свойств алиаса.
Путь команды:
/domain/<DOMAIN>/alias/clean
Синтаксис:
clean _ | <address range> [[[* | <name group] _ |<name range>] <property>] [--force]
Параметры:
<address range> - диапазон адресов (номеров);
<name group> - группа ECSS-интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<name range> - диапазон ECSS-интерфейсов;
<property> - название свойства алиаса, значение которого необходимо удалить (параметр опциональный, если данный параметр не задан, то удаляются все свойства контейнера на уровне алиаса).
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/clean _ loc.gr 240469@biysk.local no_answer_timeout Property no_answer_timeout is cleaned for aliases within domain biysk.local: 240469 <-> 708c5c0b97c48e4d Legend: *: Cleaning broken <empty>: Successfull clean [exec at: 27.03.2019 07:55:02, exec time: 83ms, nodes: ds1@ecss1]
declare
Команда создает (декларирует) алиасы в текущем домене <DOMAIN>.
Путь команды:
/domain/<DOMAIN>/alias/declare
Синтаксис
declare <ADDRESS RANGE> <OWNER> <GROUP> <IFACE RANGE>
declare <address range> <name filter> <name range>
Параметры:
[-p | --Passive] - ключ -p или --passive. Если передан ключ -p или --Passive, то декларация будет проходить в пассивном режиме;
<address range> - диапазон адресов (номеров), который используется для создания алиасов;
<name filter> - фильтр диапазона ECSS-интерфейсов в формате <Owner> <Group>, где
<OWNER> - имя профиля владельца (символ "*" используется для указания всех профилей владельцев);
<GROUP> - имя группы (символ "*" используется для указания всех групп);
<name range> - диапазон ECSS-интерфейсов.
Если <name range> определяет только один интерфейс, а <address range> - больше одного адреса, то все адреса будут "связаны" с одним интерфейсом.
Если <address range> определяет только один адрес, а <name range> - больше одного интерфейса, то все интерфейсы будут "связаны" с одним адресом.
Во всех остальных случаях мощности <name range> и <address range> должны совпадать.
Пример:
Задекларировать алиасы на домене biysk.local по следующему правилу:
Номер абонента <-> Название интерфейса
400 <-> 240462@biysk.local
401 <-> 240464@biysk.local
402 <-> 240465@biysk.local
403 <-> 240466@biysk.local
admin@[core1@ecss1]:/$ domain/biysk.local/alias/declare 40{0-3} sip1 loc.gr 24046{2-6}@biysk.local
┌───────┬────────────────┬──────┐
│Address│ Iface │Result│
├───────┼────────────────┼──────┤
│400 │708c5beda8cd39d0│ok │
│401 │708c5bf76388b92e│ok │
│402 │708c5c01bd7b9764│ok │
│403 │708c5eea9833646d│ok │
└───────┴────────────────┴──────┘
[exec at: 05.03.2019 14:22:20, exec time: 151ms, nodes: ds1@ecss2]
domain-clean
Команда очистки свойств алиасов, установленных на уровне домена.
Путь команды:
/domain/<DOMAIN>/alias/domain-clean [--force]
Синтаксис:
clean-domain [<property>]
Параметры:
<DOMAIN> - имя домена маршрутизации;
<property> - название свойства алиаса, значение которого необходимо удалить (параметр опциональный, если данный параметр не задан, то удаляются все свойства контейнера на уровне домена).
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[core1@ecss1]:/$ domain/biysk.local/alias/domain-clean nai Aliases' domain property nai for domain biysk.local clean result: cleaned [exec at: 05.03.2019 15:07:11, exec time: 66ms, nodes: ds1@ecss1]
domain-info
Просмотр информации о свойствах алиасов, установленных на уровне домена.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Путь команды:
/domain/<DOMAIN>/alias/domain-info
Синтаксис:
domain-info
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/domain-info ┌───────────┬─┬────────────────┬────────────────────────────────────┐ │ Domain │W│ Property │ Value │ ├───────────┼─┼────────────────┼────────────────────────────────────┤ │biysk.local│d│access_group │all │ │ │d│access_type │access_type0 │ │ │D│category │ordinarySubscriber │ │ │d│cdr_group │bsk3 │ │ │d│language │ru │ │ │d│media-profile │"default" │ │ │D│nai │subscriberNumber │ │ │D│ni │private │ │ │D│npi │isdnTelephony │ │ │D│pin │"1111" │ │ │D│screening │networkProvided │ │ │D│ss\mgm\telephone│enabled │ │ │d│timetables\tt2 │Name: tt2 │ │ │ │ │Date type: HOLIDAY; Time: 8:00-17:00│ │ │D│timezone │'UTC+07:00' │ └───────────┴─┴────────────────┴────────────────────────────────────┘ Legend: W: Where property is set: d: This is domain property D: This is default property Note: * char in W column means "Can't read domain info". Error reason in value column in this case [exec at: 27.03.2019 07:56:10, exec time: 83ms, nodes: ds1@ecss1]
extended-info
Данная команда предназначена для просмотра расширенных настроек алиасов.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Путь команды:
/domain/<DOMAIN>/alias/extended-info
Синтаксис:
extended-info <Address> <Name>
Параметры:
<Address> - адрес (номер) алиаса;
<Name> - имя алиаса.
Пример:
import-regime
Данная команда позволяет импортировать режимы доступа абонента из файла.
Путь команды:
/domain/<DOMAIN>/alias/import-regime
Синтаксис:
import-regime <NODE> <FILE> [-<Flag>]
Параметры:
<NODE> - имя ноды подсистемы DS;
<FILE> - имя файла (файл располагается по пути: /{DATA_ROOT}/regime - для команды уровня кластера;
/{DATA_ROOT}/regime/domain - для команды уровня домена);
<Flag> - флаг, при указании которого будет доступен следующий функционал:
-l | -log - сохранять результат выполнения команды в log-файл. Имя log-файла формируется из имени <FILE>, добавлением расширения ".log".
Формат файла (для команды уровня домена): АДРЕС_АБОНЕНТА РЕЖИМ_ОБСЛУЖИВАНИЯ
Address_1 Regime_1
Address_2 Regime_2
...
Address_N Regime_N
Формат файла логов:
% В случае, если не удалось распарсить строку Номер_Строки: Строка;2;Время_Выполнения_Команды % В случае успешного импорта режима для абонента Address Имя_Домена;Address;1;Время_Выполнения_Команды % В случае, если не удалось импортировать режим для абонента Address (например в случае, если алиас или указанный режим не существуют). Имя_Домена;Address;0;Время_Выполнения_Команды
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/alias/import-regime ds1@ecss1 regime.2 10.03.2019 10:35:05: Successfully imported: 2. Successfully imported regimes to the 2 aliases. [exec at: 10.03.2019 10:35:05, exec time: 308ms, nodes: ds1@ecss1]
info
Команда для просмотра информации о свойствах алиасов.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Путь команды:
domain/<DOMAIN>/alias/info
Синтаксис:
info <ADDRESS RANGE> [[<IFACE GROUP> <IFACE RANGE>] <PROPERTY>]
info [--iface-id | --iface-name] _ |<address range> [[[* | <iface group>] _ | <name range>] <property>]
Параметры:
--iface-id - уникальный идентификтор алиаса отображается в столбце "Iface";
--iface-name - имя интерфейса, отображается в столбце "Iface";
<address range> - диапазон адресов;
<iface group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<name range> - диапазон имен интерфейсов;
<property> - название свойства алиаса, опциональный параметр.
<ADDRESS RANGE> - диапазон адресов (номеров);
<IFACE GROUP> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<IFACE RANGE> - диапазон интерфейсов;
<PROPERTY> - название свойства алиаса, опциональный параметр.
Пример:
Просмотр информации о свойствах алиасов:
admin@ds1@ecss1:/$ domain/biysk.local/alias/info 240101 Aliases in domain biysk.local ┌───────┬──────────────────┬─┬─┬──────────────────────────┬──────────────────────────────┐ │Address│ Iface │A│W│ Property │ Value │ ├───────┼──────────────────┼─┼─┼──────────────────────────┼──────────────────────────────┤ │240101 │240101@biysk.local│ │ │user_agent │"Yealink SIP-T28P 2.73.14.3" │ │ │ │ │ │uid │063015220291f84f │ │ │ │ │D│timezone │'UTC+07:00' │ │ │ │ │ │terminal_type │smart │ │ │ │ │ │teleconference\role │"manager" │ │ │ │ │ │teleconference\password │240101 │ │ │ │ │ │subscriber_portal\password│240101 │ │ │ │ │ │subscriber_portal\login │"240101" │ │ │ │ │D│ss\mgm\telephone │enabled │ │ │ │ │p│screening │networkProvided │ │ │ │ │ │s4b\password │12345 │ │ │ │ │ │profile │"user_default" │ │ │ │ │D│pin │"1111" │ │ │ │ │p│npi │isdnTelephony │ │ │ │ │p│ni │private │ │ │ │ │p│nai │subscriberNumber │ │ │ │ │d│media-profile │"default" │ │ │ │ │ │last_incoming_call_info │Version: 1 │ │ │ │ │ │ │Digits: 3854448567 │ │ │ │ │ │ │Call reference: 2118834335 │ │ │ │ │ │ │Date time: 2020/05/17 08:36:57│ │ │ │ │ │last_dial_number │"89913699011" │ │ │ │ │ │isIfaceActive │true │ │ │ │ │d│cdr_group │bsk3 │ │ │ │ │p│category │ordinarySubscriber │ │ │ │ │ │billing_password │240101 │ │ │ │ │d│access_type │access_type0 │ │ │ │ │p│access_group │all │ └───────┴──────────────────┴─┴─┴──────────────────────────┴──────────────────────────────┘ Legend: A: "Is active" alias flag: *: Passive alias <Empty>: Active alias W: Where property is set: a: This is address property in domain A: This is global address property d: This is domain property D: This is default property i: This is iface property in domain g: This is global property p: This is alias'es profile's property <Empty>: This is alias property Note: * char in W column means "Can't read alias info". Error reason in value column in this case [exec at: 26.05.2020 10:23:32, exec time: 10ms, nodes: ds1@ecss1
Пример, если информация о паролях скрыта:
admin@ds1@ecss1:/$ domain/biysk.local/alias/info 240101 Aliases in domain biysk.local ┌───────┬──────────────────┬─┬─┬──────────────────────────┬──────────────────────────────┐ │Address│ Iface │A│W│ Property │ Value │ ├───────┼──────────────────┼─┼─┼──────────────────────────┼──────────────────────────────┤ │240101 │240101@biysk.local│ │ │user_agent │"Yealink SIP-T28P 2.73.14.3" │ │ │ │ │ │uid │063015220291f84f │ │ │ │ │D│timezone │'UTC+07:00' │ │ │ │ │ │terminal_type │smart │ │ │ │ │ │teleconference\role │"manager" │ │ │ │ │ │teleconference\password │******** │ │ │ │ │ │subscriber_portal\password│******** │ │ │ │ │ │subscriber_portal\login │"240101" │ │ │ │ │D│ss\mgm\telephone │enabled │ │ │ │ │p│screening │networkProvided │ │ │ │ │ │s4b\password │******** │ │ │ │ │ │profile │"user_default" │ │ │ │ │D│pin │"1111" │ │ │ │ │p│npi │isdnTelephony │ │ │ │ │p│ni │private │ │ │ │ │p│nai │subscriberNumber │ │ │ │ │d│media-profile │"default" │ │ │ │ │ │last_incoming_call_info │Version: 1 │ │ │ │ │ │ │Digits: 3854448567 │ │ │ │ │ │ │Call reference: 2118834335 │ │ │ │ │ │ │Date time: 2020/05/17 08:36:57│ │ │ │ │ │last_dial_number │"89913699011" │ │ │ │ │ │isIfaceActive │true │ │ │ │ │d│cdr_group │bsk3 │ │ │ │ │p│category │ordinarySubscriber │ │ │ │ │ │billing_password │******** │ │ │ │ │d│access_type │access_type0 │ │ │ │ │p│access_group │all │ └───────┴──────────────────┴─┴─┴──────────────────────────┴──────────────────────────────┘ Legend: A: "Is active" alias flag: *: Passive alias <Empty>: Active alias W: Where property is set: a: This is address property in domain A: This is global address property d: This is domain property D: This is default property i: This is iface property in domain g: This is global property p: This is alias'es profile's property <Empty>: This is alias property Note: * char in W column means "Can't read alias info". Error reason in value column in this case [exec at: 26.05.2020 10:27:36, exec time: 12ms, nodes: ds1@ecss1]
iface-clean
Команда очистки свойств алиасов, установленных на уровне домена и интерфейса.
Путь команды:
/domain/<DOMAIN>/alias/iface-clean
Синтаксис:
iface-clean * | <iface group> _ | <iface range> [<property>] [--force]
Параметры:
<iface group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<iface range> - диапазон интерфейсов (символ "_" используется для указания всех интерфейсов);
<property> - название свойства алиаса, значение которого необходимо удалить (параметр опциональный, если данный параметр не задан, то удаляются все свойства контейнера на уровне интерфейса).
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/iface-clean loc.gr 240469 [iface-clean] You are going to clean all customized alias-iface's properties. Are you sure?: yes/no ?> yes Cleaned aliases' interfaces within domain: biysk.local Legend: *: Cleaning broken <empty>: Successfull clean [exec at: 01.03.2019 14:57:40, exec time: 3s 237ms, nodes: ds1@ecss2]
iface-info
Просмотр информации о свойствах алиасов, установленных на уровне домена и интерфейса.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Путь команды:
/domain/<DOMAIN>/alias/iface-info
Синтаксис:
iface-info <iface-group> <iface range>
Параметры:
<iface-group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<iface range> - диапазон интерфейсов (символ "*" используется для указания всех интерфейсов).
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/iface-info loc.gr 240800@biysk.local Alias ifaceses' properties for domain biysk.local: ┌────────────────┬─┬────────────────┬────────────────────────────────────┐ │ Interface │W│ Property │ Value │ ├────────────────┼─┼────────────────┼────────────────────────────────────┤ │845caff2d7c81dd6│d│access_group │all │ │ │d│access_type │access_type0 │ │ │D│category │ordinarySubscriber │ │ │d│cdr_group │bsk3 │ │ │d│language │ru │ │ │d│media-profile │"default" │ │ │D│nai │subscriberNumber │ │ │D│ni │private │ │ │D│npi │isdnTelephony │ │ │D│pin │"1111" │ │ │D│screening │networkProvided │ │ │D│ss\mgm\telephone│enabled │ │ │d│timetables\tt2 │Name: tt2 │ │ │ │ │Date type: HOLIDAY; Time: 8:00-17:00│ │ │D│timezone │'UTC+07:00' │ └────────────────┴─┴────────────────┴────────────────────────────────────┘ Legend: W: Where property is set: d: This is domain property D: This is default property i: This is iface property in domain Note: * char in W column means "Can't read alias interface info". Error reason in value column in this case [exec at: 04.03.2019 13:40:03, exec time: 168ms, nodes: ds1@ecss2]
list
Команда возвращает список алиасов, определенных в виртуальной АТС и определенных в виртуальной АТС для определенного адреса.
Путь команды:
/domain/<DOMAIN>/alias/list
Синтаксис:
команда уровня виртуальной АТС:
list [<address range>]
Параметры:
<address range> - диапазон адресов (номеров).
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/alias/list 24047{1-5}
Aliases of the ECSS domain: biysk.local
┌────┬──────────────────┬─────────┐
│Type│ Iface │Addresses│
├────┼──────────────────┼─────────┤
│sip │240475@biysk.local│ 240475 │
│sip │240474@biysk.local│ 240474 │
│sip │240473@biysk.local│ 240473 │
│sip │240471@biysk.local│ 240471 │
└────┴──────────────────┴─────────┘
Total: 4
Note:
Asterix (*) of the address is shows inactivity of the alias
[exec at: 10.03.2019 10:39:08, exec time: 83ms, nodes: ds1@ecss1]
move
Команда предназначена для перемещения алиаса с одного интерфейса на другой в рамках одного домена.
Если у создаваемого и существующего алиаса свойства различаются, то система выдаст пользователю запрос на выбор действия с данными различиями.
Путь команды:
/domain/<DOMAIN>/alias/move [--force]
Синтаксис:
move <address> <old name group> <old name> <new name group> <new name>
Параметры:
<address> - адрес алиаса, который необходимо переместить;
<old name group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<old name> - интерфейс алиаса, который необходимо переместить;
<new name group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/move 800 loc.gr 240801@biysk.local loc.gr 240800@biysk.local Alias in domain "biysk.local" with address "800" successfully changed iface from "7395c860da0945d8" to "845caff2d7c81dd6". [exec at: 04.03.2019 13:23:58, exec time: 110ms, nodes: ds1@ecss1]
remove
Команда для удаления алиасов из системы.
Путь команды:
/domain/<DOMAIN>/alias/remove
Синтаксис:
remove [-i | a] [(<Name range> <address range>) | (<range>)] [ --force]
Параметры:
-i - для удаления алиасов, достаточно указать диапазон интерфейсов <Name range>;
-a - для удаления алиасов, достаточно указать диапазон адресов <address range>.
Параметр опциональный, если данный флаг не установлен, то для удаления алиаса должен быть задан диапазон интерфейсов <Name range> и диапазон адресов <address range>.
<Name range> - диапазон интерфейсов;
<address range> - диапазон адресов;
--force - выполнение команды без запроса подтверждения.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/remove 240462@biysk.local 400 Aliases are removed from ECSS domain biysk.local: 400 -> 708c5beda8cd39d0 [exec at: 06.03.2019 16:06:45, exec time: 83ms, nodes: ds1@ecss2]
set
Командой устанавливаются свойства алиасов.
Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.
Путь команды:
/domain/<DOMAIN>/alias/set
Синтаксис:
set _|<address range> *|<iface group> _|<name range> <property> <value>
Параметры:
<address range> - диапазон адресов (номеров);
<iface group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<name range> - диапазон имен интерфейсов;
<property> - название свойства алиаса, значение которого необходимо установить, список параметров приведен в Приложении А. Набор параметров алиасов или во вкладке ниже.
<value> - значение свойства, список значений приведен в Приложении А. Набор параметров алиасов или во вкладке ниже.
Пример:
admin@[core1@ecss1]:/$ domain/biysk.local/alias/set 400 loc.gr 240462@biysk.local nai nationalNumber There are aliases within domain biysk.local affected by settings property nai: 400 <-> 708c5beda8cd39d0 Legend: a: Setup alias address i: Setup alias inteface !: Setup broken. Alias allready exists *: Setup broken. Alias not exists L: Setup broken. No free subscriber licences. x: Setup broken. Unexpected error <empty>: Successfull setup [exec at: 05.03.2019 16:26:08, exec time: 133ms, nodes: ds1@ecss2]
set-for-address
Командой устанавливаются свойства алиасов на уровне домена и адреса.
Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.
Путь команды:
/domain/<DOMAIN>/alias/set-for-address
Синтаксис:
set-for-address <address range> <property> <value>
Параметры:
<address range> - диапазон адресов (номеров);
<property> - название свойства алиаса, значение которого необходимо установить, список параметров приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
<value> - значение свойства, список значений приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/set-for-address 240462 regime accsusp Affected addresses in domain: biysk.local 240462 [exec at: 06.03.2019 15:08:47, exec time: 91ms, nodes: ds1@ecss1]
set-for-domain
Данной командой устанавливается значение свойства алиасов на уровне домена.
Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.
Путь команды:
/domain/<DOMAIN>/alias/set-for-domain
Синтаксис:
set-for-domain <property> <value>
Параметры:
<DOMAIN> - имя домена маршрутизации;
<property> - название свойства алиаса, значение которого необходимо установить, список параметров приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
<value> - значение свойства, список значений приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/set-for-domain regime accsusp ok [exec at: 06.03.2019 15:30:41, exec time: 91ms, nodes: ds1@ecss2]
set-for-iface
Данной командой устанавливаются свойства алиасов на уровне домена и интерфейса.
Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.
Путь команды:
/domain/<DOMAIN>/alias/set-for-iface
Синтаксис:
set-for-iface *|<iface group> _|<iface range> <property> <value>
Параметры:
<iface group> - группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<iface range> - диапазон интерфейсов;
<property> - название свойства алиаса, значение которого необходимо установить, список параметров приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
<value> - значение свойства, список значений приведен в Приложении А, Набор параметров алиасов или во вкладке ниже.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/set-for-iface loc.gr 240462@biysk.local category hotelsSubscriber Affected ifaces in domain: biysk.local 708c5beda8cd39d0 [exec at: 06.03.2019 15:38:37, exec time: 141ms, nodes: ds1@ecss2]
statistics
Команда предназначена для просмотра статистики регистраций алиасов.
Путь команды:
/domain/<DOMAIN>/alias/statistics
Синтаксис:
statistics
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/statistics Aliases registrations in the domain: biysk.local ┌─────┬────────────┬──────────────┐ │Type │Active users│Inactive users│ ├─────┼────────────┼──────────────┤ │SIP │200 │143 │ │- │- │- │ │Total│200 │143 │ └─────┴────────────┴──────────────┘ [exec at: 06.03.2019 09:28:00, exec time: 91ms, nodes: ds1@ecss2]
subscribers-limit
Команда для просмотра количества используемых абонентских лицензий в текущий момент времени, ограничения по количеству, и наличие свободных лицензий на алиасы (абоненты) в рамках storage-кластера.
Путь команды:
/domain/<DOMAIN>/alias/subscribers-limit
Синтаксис:
subscribers-limit
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/subscribers-limit Licence alias limit: 2000 Licence virtual alias limit: infinity Active, declared aliases in the domain: 329 Active, declared virtual aliases in the domain: 0 --------------------------------- Avaliable aliases: infinity Avaliable virtual aliases: infinity [exec at: 04.03.2019 16:36:43, exec time: 83ms, nodes: ds1@ecss2]
user-agents
Команда, которая сформирует реестр используемого на софтсвиче абонентского оборудования.
Путь команды:
/domain/<DOMAIN>/alias/user-agents
Синтаксис:
/user-agents [<FLAGS>]
Параметры:
<FLAGS> :: ключи вывода (short | full | with_iface | with_alias | with_ip | sort <COLUMN> <SORT_TYPE>);
- --short - краткий вывод и количество активных/всего;
- --full - полный вывод всех полей(алиас, интерфейс). Символ * в последнем столбце показывает активную регистрацию в данный момент;
- --with_real_ip - отображение реального ip-адреса;
- --with_iface - отображение интерфейсов;
- --with_alias - отображение алиасов;
- --with_ip - отображение ip-адреса;
- --with_id - отображение id или номера строки;
inactive - показывает только неактивных UA;
active - показывает только активных UA;
limit <COUNT> - отображает только лимитированное количество строк;
sort <COLUMN> <SORT_TYPE> - сортировка по столбцу <COLUMN> порядок сортировки задается в <SORT_TYPE>;
<COLUMN> :: user_agent | amount | iface | alias - имя столбца;
<SORT_TYPE> :: asc | desc - порядок сортировки(asc - по возрастанию, desc - по убыванию) ;
Вывод команды без параметров аналогичен ключу --short;
Вывод команды с параметрами --with_iface --with_alias --with_ip аналогичен ключу --full
В столбце "Status" символом "*" отмечены зарегистрированные(активные) интерфейсы
Примеры:
Команда запущена без параметров - показывается короткий вид таблицы.
admin@mycelium1@ecss1:/$ domain/biysk.local/alias/user-agents ┌──────────────────────────────────────────────────────────┬──────┐ │ User Agent │Amount│ ├──────────────────────────────────────────────────────────┼──────┤ │Asterisk PBX 11.6-cert1 │2 │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │1 │ │Brcm-Callctrl/v1.10.3 M5T SIP Stack/4.1.2.2 │88 │ │Brcm-Cctk/v2.2.0 M5T SIP Stack/4.1.10.16 │65 │ │HUAWEI-EchoLife HG8240R/V1R003C80S001 │2 │ │HUAWEI-EchoLife HG8245/V1R006C00S212 │55 │ │HUAWEI-EchoLife HG8245H/V3R015C10S155 │9 │ │Linksys/PAP2T-5.1.6(LS) │1 │ │NTE-RG-1402G build 6.3.1 SN:TG07029246 sofia-sip/1.12.10 │1 │ │NTE-RG-1402G-W build 6.3.1 SN:TG09025597 sofia-sip/1.12.10│1 │ │NTE-RG-1402G-W build 6.3.1 SN:TG09039940 sofia-sip/1.12.10│1 │ │Oktell 2.11.0 │1 │ │RG-1402G/1.8.1 SN/VI0C000069 sofia-sip/1.12.10 │2 │ │RG-1404GF-W/1.11.0 SN/VI25002012 sofia-sip/1.12.10 │3 │ │RV6699v3.2.35 │1 │ │RV6699v3.2.38 │17 │ │TA200 44.19.12.306 │2 │ │TAU-2M.IP/2.0.0.229 SN/VI39052600 sofia-sip/1.12.10 │1 │ │TAU-2M.IP/2.1.0.38 SN/VI39052670 sofia-sip/1.12.10 │2 │ │TAU-4M.IP/2.1.0.38 SN/VI4D001354 sofia-sip/1.12.10 │3 │ │TAU-72 build 2.13.0 sofia-sip/1.12.10 │23 │ │TAU-72 build 2.13.1 sofia-sip/1.12.10 │1 │ │TAU-72 build 2.13.1-d0cdbae sofia-sip/1.12.10 │100 │ │TAU-72 build 2.17.0.45 sofia-sip/1.12.10 │58 │ │TAU-72 build 2.18.0.35 sofia-sip/1.12.10 │15 │ │TAU-8.IP/2.0.0 SN/VI33009921 sofia-sip/1.12.10 │2 │ │TAU-8.IP/2.1.0 SN/VI33010015 sofia-sip/1.12.10 │2 │ │TAU-8.IP/2.3.0 SN/VI33010013 sofia-sip/1.12.10 │6 │ │TAU-8.IP/2.3.0 SN/VI33013153 sofia-sip/1.12.10 │7 │ │TAU-8.IP/2.3.0 SN/VI33022125 sofia-sip/1.12.10 │4 │ │TAU-8.IP/2.4.2 SN/VI33022937 sofia-sip/1.12.10 │6 │ │TAU-8.IP/2.4.2 SN/VI33043089 sofia-sip/1.12.10 │2 │ │TAU-8.IP/2.5.0 SN/VI33034583 sofia-sip/1.12.10 │8 │ │TAU-8.IP/2.5.0 SN/VI33034666 sofia-sip/1.12.10 │4 │ │TAU-8.IP/2.6.0 SN/VI33024114 sofia-sip/1.12.10 │6 │ │TAU-8.IP/2.6.0 SN/VI33042769 sofia-sip/1.12.10 │4 │ │VP-12P/1.4.0.93 SN/VI4B000942 sofia-sip/1.12.10 │1 │ │Yealink SIP-T19P 31.72.14.5 │1 │ │Yealink SIP-T28P 2.73.14.3 │2 │ │Yealink SIP-W52P 25.73.15.1 │1 │ │dlink 12-3896-11869-1.4.2.176-SP9440S │2 │ └──────────────────────────────────────────────────────────┴──────┘ Total user agents types amount: 41 Total user agents amount: 513 [exec at: 13.05.2019 16:18:49, exec time: 346ms, nodes: ds1@ecss2]
Вывод команды в полном режиме(--full).
admin@mycelium1@ecss1:/$ domain/biysk.local/alias/user-agents --full --sort user_agent desc ┌───────────────────────────────────────────────────┬──────┬──────────────────┬─────────────┬──────┐ │ User Agent │Alias │ Iface │ IP │Status│ ├───────────────────────────────────────────────────┼──────┼──────────────────┼─────────────┼──────┤ │Yealink SIP-T28P 2.73.14.3 │240101│240101@biysk.local│192.168.2.26 │ * │ │Yealink SIP-T28P 2.73.14.3 │240244│240244@biysk.local│192.168.2.26 │ * │ │VP-12P/1.4.0.93 SN/VI4B000942 sofia-sip/1.12.10 │240467│240467@biysk.local│ │ │ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │240473│240473@biysk.local│192.168.2.26 │ * │ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │600 │240466@biysk.local│ │ │ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │240466│240466@biysk.local│192.168.2.26 │ * │ │TAU-2M.IP/2.0.0.229 SN/VI39005419 sofia-sip/1.12.10│240465│240465@biysk.local│192.168.2.200│ * │ │TAU-2M.IP/2.0.0.229 SN/VI39005419 sofia-sip/1.12.10│240464│240464@biysk.local│192.168.2.200│ * │ │RG-1404GF-W/1.11.0 SN/VI25002012 sofia-sip/1.12.10 │240474│240474@biysk.local│192.168.2.26 │ * │ │RG-1404GF-W/1.11.0 SN/VI25002012 sofia-sip/1.12.10 │240470│240470@biysk.local│192.168.2.26 │ * │ │RG-1402G/1.8.1 SN/VI0C000069 sofia-sip/1.12.10 │240475│240475@biysk.local│ │ │ │RG-1402G/1.8.1 SN/VI0C000069 sofia-sip/1.12.10 │240471│240471@biysk.local│ │ │ │MicroSIP/3.15.6 │240007│240007@biysk.local│ │ │ │Brcm-Callctrl/v1.10.3 M5T SIP Stack/4.1.2.2 │240469│240469@biysk.local│192.168.2.26 │ * │ │Brcm-Callctrl/v1.10.3 M5T SIP Stack/4.1.2.2 │240462│240462@biysk.local│192.168.2.26 │ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │240599│240599@biysk.local│192.168.2.26 │ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │240699│240699@biysk.local│192.168.2.26 │ * │ ... │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │240501│240501@biysk.local│192.168.2.26 │ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │240500│240500@biysk.local│192.168.2.26 │ * │ └───────────────────────────────────────────────────┴──────┴──────────────────┴─────────────┴──────┘ Total active user agents amount: 208 Total user agents types amount: 14 Total user agents amount: 213 [exec at: 17.07.2019 12:44:20, exec time: 310ms, nodes: ds1@ecss1]
Вывод команды с реальными ip-адресами, вывод ограничен 5-ю записями:
admin@mycelium1@ecss1:/$ domain/biysk.local/alias/user-agents --with_real_ip --limit 5 ┌─────────────────────────────────────┬────────────┬──────┐ │ User Agent │ Real IP │Status│ ├─────────────────────────────────────┼────────────┼──────┤ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1│10.22.128.19│ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1│10.22.128.19│ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1│10.22.128.19│ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1│10.22.128.19│ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1│10.22.128.19│ * │ └─────────────────────────────────────┴────────────┴──────┘ Total active user agents amount: 209 Total user agents types amount: 13 Total user agents amount: 212 [exec at: 16.09.2019 16:46:15, exec time: 258ms, nodes: ds1@ecss1]
where
Команда поиска алиасов по адресу.
Путь команды:
/domain/<DOMAIN>/alias/where
Синтаксис:
where <DOMAIN> <ADDRESS RANGE>
Параметры:
<ADDRESS RANGE> - диапазон адресов (номеров) для поиска.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/where 240469 Aliases: ┌───────┬───────────┬────────────────┬──────────────────┬────────────┬──────┬──────┐ │Address│ Domain │ Iface │ Iface name │Display name│Active│Binded│ ├───────┼───────────┼────────────────┼──────────────────┼────────────┼──────┼──────┤ │240469 │biysk.local│708c5c0b97c48e4d│240469@biysk.local│ntp │true │true │ └───────┴───────────┴────────────────┴──────────────────┴────────────┴──────┴──────┘ Note: Binded column show is iface exists or not. [exec at: 04.03.2019 15:54:15, exec time: 75ms, nodes: ds1@ecss1]
who
Команда поиска алиаса по интерфейсу.
Путь команды:
/domain/<DOMAIN>/alias/who
Синтаксис:
who * | <owner> * | <group> * | <range>
Параметры:
<owner> - название владельца (символ "*" используется для указания всех владельцев);
<group> - название группы (символ "*" используется для указания всех групп);
<range> - диапазон интерфейсов ("портов"/"пучков") для поиска (символ "*" используется для указания всех интерфейсов для заданной группы, владельца).
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/alias/who sip1 loc.gr 240469@biysk.local Aliases: ┌────────────────┬───────────┬───────┬────────────┬──────┐ │ Iface │ Domain │Address│Display name│Active│ ├────────────────┼───────────┼───────┼────────────┼──────┤ │708c5c0b97c48e4d│biysk.local│240469 │ntp │true │ └────────────────┴───────────┴───────┴────────────┴──────┘ [exec at: 04.03.2019 15:48:30, exec time: 133ms, nodes: ds1@ecss2]