/cluster/storage/<STORAGE>/alias/ — команды управления алиасами
В этом разделе описываются команды управления, которые относятся к созданию/удалению алиасов и настройке параметров (свойств) алиасов.
Описание параметров алиаса приведено в разделе Приложение А. Набор параметров алиасов или во вкладке ниже.
Приложение А. Набор параметров алиасов
Таблица 1 — Описание параметров алиаса
| Название параметра | Описание | Значения |
|---|---|---|
| access_group | группа доступа | значения берутся из таблицы групп доступа (список групп доступа можно посмотреть по команде domain/<some_domain>/access-group/ls-groups) |
| access_type | тип доступа для абонента (долговременные ограничения, которые вводятся при подключении абонента). Описание настройки содержится на этой странице /domain/<DOMAIN>/access-type- команды управления типами доступа. | значения берутся из таблицы типов доступа (список типов доступа можно посмотреть по команде domain/<some_domain>/access-type/info) |
| ai_<идентификатор тона> | автоинформатор | <Номер автоинформатора> [Идентификатор тона] |
| apri | индикатор ограничения предоставления номера вызывающего абонента | presentationAllowed |
| presentationRestricted | ||
| addressNotAvailable | ||
| spare | ||
| billing_id | индикатор установки User-Name(1) при использовании RADIUS | string |
| billing_password | индикатор установки User-Password(2) при использовании RADIUS | string |
| category_override | режим переопределения категории вызова | Если параметр выставлен в true — то категория вызова всегда переопределяется на ту категорию, что выставлена на уровне интерфейса (свойство category). |
| Если параметр выставлен в false — то категория вызова не переопределяется на ту категорию, что выставлена на уровне интерфейса (свойство category). | ||
| category | категория вызывающего абонента | unknownAtThisTime — 0 |
| operatorFrench — 1 | ||
| operatorEngish — 2 | ||
| operatorGerman — 3 | ||
| operatorRussian — 4 | ||
| operatorSpanish — 5 | ||
| reserved — 9 | ||
| ordinarySubscriber — 10 (АОН категория 1 — ОАО "Ростелеком") | ||
| subscriberWithPriority — 11 (АОН категория 4 — ООО "Эквант") | ||
| dataCall — 12 (АОН категория 8 — ОАО "АРКТЕЛ") | ||
| testCall — 13 | ||
| spare — 14 | ||
| payphone — 15 (АОН категория 6 — ЗАО "Компания ТрансТелеКом") | ||
| category0 — 224 | ||
| hotelsSubscriber — 225 (АОН категория 2 — ОАО "КОМСТАР-ОТС") | ||
| freeSubscriber — 226 | ||
| paidSubscriber — 227 (АОН категория 7 — ЗАО "Синтерра") | ||
| localSubscriber — 228 (АОН категория 3 — ОАО "Вымпелком" (ранее ООО "СЦС Совинтел")) | ||
| localTaksofon — 229 (АОН категория 9 — ОАО "Межрегиональный Транзит Телеком") | ||
| autoCallI — 240 | ||
| semiautoCallI — 241 | ||
| autoCallII — 242 | ||
| semiautoCallII — 243 | ||
| autoCallIII — 244 | ||
| semiautoCallIII — 245 | ||
| autoCallIV — 246 | ||
| semiautoCallIV — 247 | ||
| cdr_group | имя группы, используется для группировки cdr. Описание настройки содержится на этой странице /domain/<DOMAIN>/cdr/ — команды управления режимами генерации CDR | atom |
| displayName | имя абонента, которое будет передано на вызываемую сторону и отобразится у абонента при передаче CallerID | string |
| Email-адрес абонента, на который будет приходить письмо с нотификацией о пропущенном вызове. | string | |
| cn\email\release_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о пропущенном вызове через email | boolean |
| cn\email\release_call\template | Шаблон письма-нотификации о пропущенном вызове по email. В шаблоне письма можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| jabber\id | JID (Jabber-идентификатор) абонента, на который будет приходить сообщение с нотификацией о пропущенном вызове. | string |
| cn\jabber\release_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о пропущенном вызове через jabber | boolean |
| cn\jabber\release_call\template | Шаблон сообщения-нотификации о пропущенном вызове. В шаблоне сообщения можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| cn\jabber\incomming_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о входящем вызове через jabber | boolean |
| cn\jabber\incomming_call\template | Шаблон сообщения-нотификации о входящем вызове. В шаблоне сообщения можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| isActive | состояние алиаса | false — алиас не активен true — алиас активен |
| nai | идентификатор типа адреса | spare |
| subscriberNumber | ||
| unknown | ||
| nationalNumber | ||
| internationNumber | ||
| ni | индикатор номера | emergency — экстренные службы |
| intercity — абоненты междугородной сети | ||
| international — абоненты международной сети | ||
| local — абоненты местной сети | ||
| private — абоненты "своей" АТС | ||
| zone — абоненты зоновой сети | ||
| npi | индикатор плана нумерации | spare |
| isdnTelephony | ||
| dataNumberingPlan | ||
| telexNumberingPlan | ||
| reserved1 | ||
| reserved2 | ||
| reserved3 | ||
| conversation_timeout | длительность разговорного соединения | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| no_answer_timeout | время ожидания ответа данного абонента | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| o_response_timeout | тайм-аут подтверждения завершения номера | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| provider | код провайдера | [0-9] |
| regime | режим обслуживания для абонента (временные ограничения). Описание настройки содержится на этой странице /domain/<DOMAIN>/regime/ — команды управления режимами обслуживания абонентов | значения берутся из таблицы режимов обслуживания (список режимов обслуживания можно посмотреть по команде domain/<some_domain>/regime/info) |
| screening | индикатор контроля номера вызывающего абонента | userProvidedNotVerified |
| userProvidedVerifiedAndPassed | ||
| userProvidedVerifiedAndFailed | ||
| networkProvided | ||
| support_encoding | Отображение Display Name в зависимости от типа кодировки | utf-8 |
| latin1 | ||
| cp-1251 | ||
| line_count | Количество одновременных телефонных занятий, которые можно сделать с/на данного абонента. 
Значение данного параметра может быть перекрыто значениями параметров "line_count\in", "line_count\out".
| positive integer |
| line_count\in | Количество одновременных входящих телефонных занятий, которые можно сделать на данного абонента (алиас). | positive integer |
| line_count\out | Количество одновременных исходящих телефонных занятий, которые можно сделать с данного абонента (алиаса). | positive integer |
| ss\mgm\telephone | Возможность управлять услугами с ТА (активировать, деактивировать, проверять). По умолчанию — enabled | disabled | enabled |
| s4b\email | Email адрес учетной записи Skype for business | string |
| s4b\username | Username учетной записи Skype for business | string |
| s4b\password | Пароль от учетной записи Skype for business | string |
| pulse_telephone | Признак того, что данный ТА работает в импульсном режиме набора. По умолчанию — false. | boolean |
| placement | территориальный признак номера | string |
| language | Язык локали абонента | string (ru|en|de|fr|es) |
| api\call\enabled | активировать возможность управлять данным ТА через Call API. По умолчанию — false. | boolean |
| password | Пароль, используемый для входа в Phone desktop assistant | string |
Параметры (свойства) алиасов определяются на нескольких уровнях:
- Уровень алиаса — настройки уровня действуют на определенный алиас (имя домена, имя интерфейса и адрес).
- Уровень домена и интерфейса — настройки уровня действует на все алиасы с заданными именем домена и именем интерфейса.
- Уровень домена и адреса — настройки действуют на все алиасы с заданным именем домена и адресом.
- Уровень домена — настройки действуют на все алиасы с заданным доменом.
- Глобальный уровень — действует на все алиасы системы.
Для администратора системы команды выполняются на уровне кластера в разделе /cluster/storage/<CLUSTER>/alias/.
<CLUSTER> — имя кластера с ролью storage.
address-clean
Команда предназначена для очистки глобальных адресных свойств алиасов.
Путь команды:
/cluster/storage/<CLUSTER>/alias/address-clean
Синтаксис:
address-clean <ADDRESS RANGE> [<PROPERTY>] [--force]
Параметры:
<ADDRESS RANGE> — диапазон адресов (номеров) для фильтрации;
<PROPERTY> — название свойства алиаса (параметр опциональный, если данный параметра не задан, то удаляются значения всех свойств контейнера);
--force — выполнение команды без запроса подтверждения.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/address-clean biysk.local 240880 timezone Property timezone is cleaned for aliases' addresses within domain biysk.local: 240880 Legend: *: Cleaning broken <empty>: Successfull clean [exec at: 04.02.2019 14:18:05, exec time: 75ms, nodes: ds1@ecss2]
address-info
Командадля просмотра информации о глобальных адресных свойствах алиасов.
Путь команды:
/cluster/storage/<CLUSTER>/alias/address-info
Синтаксис:
address-info <DOMAIN> <ADDRESS RANGE>
Параметры:
<ADDRESS RANGE> — диапазон адресов (номеров) для фильтрации контейнеров.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/address-info biysk.local 240880
Addresses in domain: biysk.local
┌───────┬─┬────────────────┬────────────────────────────────────────────────────────────────────────┐
│Address│W│ Property │ Value │
├───────┼─┼────────────────┼────────────────────────────────────────────────────────────────────────┤
│240880 │d│access_group │all │
│ │d│access_type │access_type0 │
│ │D│category │ordinarySubscriber │
│ │d│cdr_group │bsk3 │
│ │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 │{ecss_timetable,tt2,[{ecss_timetable_filter,'HOLIDAY',{8,0},{17,0}}],[]}│
│ │a│timezone │'UTC+06: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: 04.02.2019 14:13:11, exec time: 83ms, nodes: ds1@ecss2]
copy
Команда используется для копирования свойств алиаса.
Путь команды:
/cluster/storage/<CLUSTER>/alias/copy
Синтаксис:
copy <SOURCE> <DESTINATION> [<PROPERTY>]
Параметры:
<SOURCE> — определяет контейнер свойств алиаса, из которого свойства будут копироваться (источник);
<DESTINATION> — определяет контейнер свойств алиаса, в которой свойства будут копироваться (приемник);
[<PROPERTY>] — свойство, которое будет копироваться. Данный параметр опционален. Если данный параметр не задан, то копируются все свойства контейнера <SOURCE>.
Параметры <SOURCE> и <DESTINATION> задаются в виде <Тип>\<Экземпляр>.
Параметр <Тип> определяет тип контейнера свойств алиаса, и может принимать следующие значения:
- a : адрес, в рамках домена;
- d : домен;
- i : интерфейс алиаса;
- l : алиас;
Данный параметр не является обязательным.
Если данный параметр не задан, то <Тип> равен l
Параметр <Экземпляр> определяет конкретный контейнер свойств алиаса. В зависимости от типа он может принимать следующие значения:
Для источника:
- Адрес, в рамках домена : a\<Домен>\<Адрес>
- Домен маршрутизации : d\<Домен>
- Интерфейс алиаса : i\<Домен>\<Интерфейс>
- Алиас : l\<Домен>\<Интерфейс>\<Адрес> или
\<Домен>\<Интерфейс>\<Адрес>
Для приемника
- Адрес, в рамках домена : a\<Домен>\<Диапазон адресов>
- Домен маршрутизации : d\<Домен>
- Интерфейс алиаса : i\<Домен>\<Диапазон интерфейсов>
- Алиас : l\<Домен>\<Диапазон интерфейсов>\<Диапазон адресов> или
\<Домен>\<Диапазон интерфейсов>\<Диапазон адресов>
Примеры:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/copy a\biysk.local\240800 a\biysk.local\240700 timezone Copy aliases' properties from address 240800 within domain biysk.local: ┌────────┬───────────┐ │Property│ Value │ ├────────┼───────────┤ │timezone│'UTC+06:00'│ └────────┴───────────┘ to addresses within domain biysk.local: ┌───────┬──────┐ │Address│Result│ ├───────┼──────┤ │240700 │ok │ └───────┴──────┘ [exec at: 04.02.2019 14:49:54, exec time: 75ms, nodes: ds1@ecss2]
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/alias/copy a\biysk.local\240901 a\front.office\901 Copy aliases' properties from address 240901 within domain biysk.local: No data to copy to addresses within domain front.office: ┌───────┬──────┐ │Address│Result│ ├───────┼──────┤ │901 │ok │ └───────┴──────┘ [exec at: 26.03.2019 13:28:02, exec time: 83ms, nodes: ds1@ecss1]
declare
Команда создает (декларирует) алиасы в текущем домене <DOMAIN>.
Путь команды:
/cluster/storage/<CLUSTER>/alias/declare
Синтаксис:
- команда уровня кластера:
declare [-p | --Passive] <DOMAIN> <ADDRESS RANGE> <OWNER> <GROUP> <IFACE RANGE>
Параметры:
[-p | --Passive] — ключ -p или --passive. Если передан ключ -p или --Passive, то декларация будет проходить в пассивном режиме;
<ADDRESS RANGE> — диапазон адресов (номеров), который используется для создания алиасов;
<OWNER> — фильтр интерфейсов по имени профиля владельца (символ "*" используется для указания всех профилей владельцев);
<GROUP> — фильтр интерфейсов по имени группы (символ "*" используется для указания всех групп);
<IFACE RANGE> — диапазон интерфейсов.
Если <iface range> определяет только один интерфейс, а <address range> — больше одного адреса, то все адреса будут "связаны" с одним интерфейсом.
Если <address range> определяет только один адрес, а <iface range> — больше одного интерфейса, то все интерфейсы будут "связаны" с одним адресом.
Во всех остальных случаях мощности <iface range> и <address range> должны совпадать.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/declare -p biysk.local 80{0-9} sip1 loc.gr 24080{0-9}@biysk.local
New passive aliases are declared in biysk.local:
800 <-> 7395c860da0945d8
801 <-> 7395c860da0945d8
802 <-> 7395c860da0945d8
803 <-> 7395c860da0945d8
804 <-> 7395c860da0945d8
805 <-> 7395c860da0945d8
806 <-> 7395c860da0945d8
807 <-> 7395c860da0945d8
808 <-> 7395c860da0945d8
809 <-> 7395c860da0945d8
Legend:
*: An alias already exists
L: Can't declare alias by licence limitation
x: Alias declaration broken
<empty>: Successfull alias declaration
[exec at: 04.02.2019 15:27:00, exec time: 108ms, nodes: ds1@ecss2]
domain-clean
Команда очистки свойств алиасов, установленных на уровне домена.
Путь команды:
/cluster/storage/<CLUSTER>/alias/domain-clean
Синтаксис:
domain-clean <DOMAIN> [<PROPERTY>] [--force]
Параметры:
<DOMAIN> — имя домена маршрутизации;
<PROPERTY> — название свойства алиаса, значение которого необходимо удалить (параметр опциональный, если данный параметр не задан, то удаляются все свойства контейнера на уровне домена);
--force — выполнение команды без запроса подтверждения.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/domain-clean biysk.local timezone Aliases' domain property timezone for domain biysk.local clean result: cleaned [exec at: 04.02.2019 15:46:26, exec time: 96ms, nodes: ds1@ecss1]
domain-info
Просмотр информации о свойствах алиасов, установленных на уровне домена.
Путь команды:
/cluster/storage/<CLUSTER>/alias/domain-info
Синтаксис:
- команда уровня кластера:
domain-info <DOMAIN>
Параметры:
<DOMAIN> — имя домена маршрутизации.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/domain-info biysk.local
┌───────────┬─┬────────────────┬────────────────────────────────────────────────────────────────────────┐
│ Domain │W│ Property │ Value │
├───────────┼─┼────────────────┼────────────────────────────────────────────────────────────────────────┤
│biysk.local│d│access_group │all │
│ │d│access_type │access_type0 │
│ │D│category │ordinarySubscriber │
│ │d│cdr_group │bsk3 │
│ │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 │{ecss_timetable,tt2,[{ecss_timetable_filter,'HOLIDAY',{8,0},{17,0}}],[]}│
│ │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: 04.02.2019 15:48:12, exec time: 133ms, nodes: ds1@ecss2]
import-regime
Данная команда позволяет импортировать режимы доступа абонента из файла.
Путь команды:
/cluster/storage/<CLUSTER>/alias/import-regime
Синтаксис:
import-regime <NODE> <FILE> [-<Flag>]
Параметры:
<NODE> — имя ноды подсистемы DS;<FILE> — имя файла (файл располагается по пути: /var/lib/ecss/regime);
<Flag> — флаг, при указании которого будет доступен следующий функционал:
- -l | -log — сохранять результат выполнения команды в log-файл. Имя log-файла формируется из имени <FILE>, добавлением расширения ".log".
Формат файла (для команды уровня кластера): ДОМЕН АДРЕС_АБОНЕНТА РЕЖИМ_ОБСЛУЖИВАНИЯ
Domain_1 Address_1 Regime_1 Domain_2 Address_2 Regime_2 ... Domain_N Address_N Regime_N
Формат файла логов:
% В случае, если не удалось распарсить строку
Номер_Строки: Строка;2;Время_Выполнения_Команды
% В случае успешного импорта режима для абонента Address
Имя_Домена;Address;1;Время_Выполнения_Команды
% В случае, если не удалось импортировать режим для абонента Address (например в случае, если алиас или указанный режим не существуют).
Имя_Домена;Address;0;Время_Выполнения_КомандыПример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/import-regime ds1@ecss1 regime.700.txt -l 04.02.2019 16:08:43: Successfully imported: 4. Successfully imported regimes to the 4 aliases. Log file: "/var/lib/ecss/regime/regime.700.txt.log" [exec at: 04.02.2019 16:08:43, exec time: 275ms, nodes: ds1@ecss1]
list
Команда возвращает список алиасов, определенных в виртуальной АТС и определенных в виртуальной АТС для определенного адреса.
Путь команды:
/cluster/storage/<CLUSTER>/alias/list
Синтаксис:
list <DOMAIN> [<ADDRESS RANGE>]
Параметры:
<ADDRESS RANGE> — диапазон адресов (номеров).
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/list biysk.local
Aliases of the ECSS domain: biysk.local
┌────┬──────────────────┬─────────┐
│Type│ Iface │Addresses│
├────┼──────────────────┼─────────┤
│sip │240814@biysk.local│ 240814 │
│sip │240475@biysk.local│ 240475 │
...
│ │ │* 804 │
└────┴──────────────────┴─────────┘
Total: 327
Note:
Asterix (*) of the address is shows inactivity of the alias
[exec at: 04.02.2019 16:31:54, exec time: 463ms, nodes: ds1@ecss1]
move
Команда предназначена для перемещения алиаса с одного интерфейса на другой в рамках одного домена.
Если у создаваемого и существующего алиаса свойства различаются, то система выдаст пользователю запрос на выбор действия с данными различиями.
Путь команды:
/cluster/storage/<CLUSTER>/alias/move
Синтаксис:
move <DOMAIN> <ADDRESS> <OLD IFACE GROUP> <OLD IFACE> <NEW IFACE GROUP> <NEW IFACE> [--force]
Параметры:
<ADDRESS> — адрес алиаса, который необходимо переместить;
<OLD IFACE GROUP> — группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<OLD IFACE> — интерфейс алиаса, который необходимо переместить;
<NEW IFACE GROUP> — группа интерфейсов (символ "*" используется для указания всех групп интерфейсов);
<NEW IFACE> — новый интерфейс, в который необходимо переместить алиас;
--force — выполнение команды без запроса подтверждения.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/move biysk.local 804 loc.gr 240801@biysk.local loc.gr 240880@biysk.local
END OF COMMAND
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/move biysk.local 804 loc.gr 240801@biysk.local loc.gr 240880@biysk.local
[move] In the domain "biysk.local" for iface "786fb0a23f2988b1" already exists aliases
with numbers: 240880 (active).
Would you like to continue moving alias?: yes/no ?> yes
Alias in domain "biysk.local" with address "804" successfully changed iface from "7395c860da0945d8" to "786fb0a23f2988b1".
[exec at: 04.02.2019 16:37:51, exec time: 3s 585ms, nodes: ds1@ecss1]
remove
Команда для удаления алиасов из системы.
Путь команды:
/cluster/storage/<CLUSTER>/alias/remove
Синтаксис:
remove <DOMAIN> [<FLAG> <RANGE>] | [<IFACE RANGE> <ADDRESS RANGE>] [--force]
Параметры:
<FLAG> — флаг, который устанавливает, какие операнды необходимо указать:
- -i — для удаления алиасов, достаточно указать диапазон интерфейсов <IFACE RANGE>;
- -a — для удаления алиасов, достаточно указать диапазон адресов <ADDRESS RANGE>;
- --force — выполнение команды без запроса подтверждения.
Параметр опциональный, если данный флаг не установлен, то для удаления алиаса должен быть задан диапазон интерфейсов <IFACE RANGE> и диапазон адресов <ADDRESS RANGE>.
<IFACE RANGE> — диапазон интерфейсов;
<ADDRESS RANGE> — диапазон адресов.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/remove biysk.local 240880@biysk.local 804 Aliases are removed from ECSS domain biysk.local: 804 -> 786fb0a23f2988b1 [exec at: 04.02.2019 16:42:05, exec time: 66ms, nodes: ds1@ecss2]
set-for-address
Командой устанавливаются глобальные адресные свойства алиасов — параметры по умолчанию для определенного номера абонента (группы номеров) вне зависимости от домена маршрутизации.
Путь команды:
/cluster/storage/<CLUSTER>/alias/set-for-address
Синтаксис:
set-for-address <DOMAIN> <ADDRESS RANGE> <PROPERTY> <VALUE>
Параметры:
<ADDRESS RANGE> — диапазон адресов (номеров);
<PROPERTY> — название свойства алиаса, значение которого необходимо установить.
<VALUE> — значение свойства.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/set-for-address biysk.local 2408{00-80} timezone UTC+06:00
Affected addresses in domain: biysk.local
240800 240801 240802 240803 240804 240805 240806
240807 240808 240809 240810 240811 240812 240813
240814 240815 240816 240817 240818 240819 240820
240821 240822 240823 240824 240825 240826 240827
240828 240829 240830 240831 240832 240833 240834
240835 240836 240837 240838 240839 240840 240841
240842 240843 240844 240845 240846 240847 240848
240849 240850 240851 240852 240853 240854 240855
240856 240857 240858 240859 240860 240861 240862
240863 240864 240865 240866 240867 240868 240869
240870 240871 240872 240873 240874 240875 240876
240877 240878 240879 240880
[exec at: 04.02.2019 14:10:00, exec time: 217ms, nodes: ds1@ecss1]
set-for-domain
Данной командой устанавливается значение свойства алиасов на уровне домена.
Путь команды:
/cluster/storage/<CLUSTER>/alias/set-for-domain
Синтаксис:
- команда уровня кластера:
set-for-domain <DOMAIN> <PROPERTY> <VALUE>
Параметры:
<DOMAIN> — имя домена маршрутизации;
<PROPERTY> — название свойства алиаса, значение которого необходимо установить;
<VALUE> — значение свойства.
Описание параметров алиаса приведено в разделе Приложение А. Набор параметров алиасов или во вкладке ниже.
Приложение А. Набор параметров алиасов
Таблица 1 — Описание параметров алиаса
| Название параметра | Описание | Значения |
|---|---|---|
| access_group | группа доступа | значения берутся из таблицы групп доступа (список групп доступа можно посмотреть по команде domain/<some_domain>/access-group/ls-groups) |
| access_type | тип доступа для абонента (долговременные ограничения, которые вводятся при подключении абонента). Описание настройки содержится на этой странице /domain/<DOMAIN>/access-type- команды управления типами доступа. | значения берутся из таблицы типов доступа (список типов доступа можно посмотреть по команде domain/<some_domain>/access-type/info) |
| ai_<идентификатор тона> | автоинформатор | <Номер автоинформатора> [Идентификатор тона] |
| apri | индикатор ограничения предоставления номера вызывающего абонента | presentationAllowed |
| presentationRestricted | ||
| addressNotAvailable | ||
| spare | ||
| billing_id | индикатор установки User-Name(1) при использовании RADIUS | string |
| billing_password | индикатор установки User-Password(2) при использовании RADIUS | string |
| category_override | режим переопределения категории вызова | Если параметр выставлен в true — то категория вызова всегда переопределяется на ту категорию, что выставлена на уровне интерфейса (свойство category). |
| Если параметр выставлен в false — то категория вызова не переопределяется на ту категорию, что выставлена на уровне интерфейса (свойство category). | ||
| category | категория вызывающего абонента | unknownAtThisTime — 0 |
| operatorFrench — 1 | ||
| operatorEngish — 2 | ||
| operatorGerman — 3 | ||
| operatorRussian — 4 | ||
| operatorSpanish — 5 | ||
| reserved — 9 | ||
| ordinarySubscriber — 10 (АОН категория 1 — ОАО "Ростелеком") | ||
| subscriberWithPriority — 11 (АОН категория 4 — ООО "Эквант") | ||
| dataCall — 12 (АОН категория 8 — ОАО "АРКТЕЛ") | ||
| testCall — 13 | ||
| spare — 14 | ||
| payphone — 15 (АОН категория 6 — ЗАО "Компания ТрансТелеКом") | ||
| category0 — 224 | ||
| hotelsSubscriber — 225 (АОН категория 2 — ОАО "КОМСТАР-ОТС") | ||
| freeSubscriber — 226 | ||
| paidSubscriber — 227 (АОН категория 7 — ЗАО "Синтерра") | ||
| localSubscriber — 228 (АОН категория 3 — ОАО "Вымпелком" (ранее ООО "СЦС Совинтел")) | ||
| localTaksofon — 229 (АОН категория 9 — ОАО "Межрегиональный Транзит Телеком") | ||
| autoCallI — 240 | ||
| semiautoCallI — 241 | ||
| autoCallII — 242 | ||
| semiautoCallII — 243 | ||
| autoCallIII — 244 | ||
| semiautoCallIII — 245 | ||
| autoCallIV — 246 | ||
| semiautoCallIV — 247 | ||
| cdr_group | имя группы, используется для группировки cdr. Описание настройки содержится на этой странице /domain/<DOMAIN>/cdr/ — команды управления режимами генерации CDR | atom |
| displayName | имя абонента, которое будет передано на вызываемую сторону и отобразится у абонента при передаче CallerID | string |
| Email-адрес абонента, на который будет приходить письмо с нотификацией о пропущенном вызове. | string | |
| cn\email\release_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о пропущенном вызове через email | boolean |
| cn\email\release_call\template | Шаблон письма-нотификации о пропущенном вызове по email. В шаблоне письма можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| jabber\id | JID (Jabber-идентификатор) абонента, на который будет приходить сообщение с нотификацией о пропущенном вызове. | string |
| cn\jabber\release_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о пропущенном вызове через jabber | boolean |
| cn\jabber\release_call\template | Шаблон сообщения-нотификации о пропущенном вызове. В шаблоне сообщения можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| cn\jabber\incomming_call\enabled | флаг, показывающий, активирована или нет отправка сообщения о входящем вызове через jabber | boolean |
| cn\jabber\incomming_call\template | Шаблон сообщения-нотификации о входящем вызове. В шаблоне сообщения можно использовать макропеременные: %CALLING%, %CALLED%, %TIME%, %DATE%, %CAUSE%, %DURATION%, %CALLERID%, %DISPLAYNAME% | string |
| isActive | состояние алиаса | false — алиас не активен true — алиас активен |
| nai | идентификатор типа адреса | spare |
| subscriberNumber | ||
| unknown | ||
| nationalNumber | ||
| internationNumber | ||
| ni | индикатор номера | emergency — экстренные службы |
| intercity — абоненты междугородной сети | ||
| international — абоненты международной сети | ||
| local — абоненты местной сети | ||
| private — абоненты "своей" АТС | ||
| zone — абоненты зоновой сети | ||
| npi | индикатор плана нумерации | spare |
| isdnTelephony | ||
| dataNumberingPlan | ||
| telexNumberingPlan | ||
| reserved1 | ||
| reserved2 | ||
| reserved3 | ||
| conversation_timeout | длительность разговорного соединения | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| no_answer_timeout | время ожидания ответа данного абонента | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| o_response_timeout | тайм-аут подтверждения завершения номера | (disabled | [0ms; 1d] (например: 23h 59m 59s 999ms) ) |
| provider | код провайдера | [0-9] |
| regime | режим обслуживания для абонента (временные ограничения). Описание настройки содержится на этой странице /domain/<DOMAIN>/regime/ — команды управления режимами обслуживания абонентов | значения берутся из таблицы режимов обслуживания (список режимов обслуживания можно посмотреть по команде domain/<some_domain>/regime/info) |
| screening | индикатор контроля номера вызывающего абонента | userProvidedNotVerified |
| userProvidedVerifiedAndPassed | ||
| userProvidedVerifiedAndFailed | ||
| networkProvided | ||
| support_encoding | Отображение Display Name в зависимости от типа кодировки | utf-8 |
| latin1 | ||
| cp-1251 | ||
| line_count | Количество одновременных телефонных занятий, которые можно сделать с/на данного абонента.
Значение данного параметра может быть перекрыто значениями параметров "line_count\in", "line_count\out".
| positive integer |
| line_count\in | Количество одновременных входящих телефонных занятий, которые можно сделать на данного абонента (алиас). | positive integer |
| line_count\out | Количество одновременных исходящих телефонных занятий, которые можно сделать с данного абонента (алиаса). | positive integer |
| ss\mgm\telephone | Возможность управлять услугами с ТА (активировать, деактивировать, проверять). По умолчанию — enabled | disabled | enabled |
| s4b\email | Email адрес учетной записи Skype for business | string |
| s4b\username | Username учетной записи Skype for business | string |
| s4b\password | Пароль от учетной записи Skype for business | string |
| pulse_telephone | Признак того, что данный ТА работает в импульсном режиме набора. По умолчанию — false. | boolean |
| placement | территориальный признак номера | string |
| language | Язык локали абонента | string (ru|en|de|fr|es) |
| api\call\enabled | активировать возможность управлять данным ТА через Call API. По умолчанию — false. | boolean |
| password | Пароль, используемый для входа в Phone desktop assistant | string |
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/alias/set-for-domain biysk.local language ru ok [exec at: 04.02.2019 16:45:02, exec time: 91ms, nodes: ds1@ecss2]
statistics
Команда предназначена для просмотра статистики регистраций алиасов.
Путь команды:
/cluster/storage/<CLUSTER>/alias/statistics
Синтаксис:
statistics
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/alias/statistics biysk.local Aliases registrations in the domain: biysk.local ┌─────┬────────────┬──────────────┐ │Type │Active users│Inactive users│ ├─────┼────────────┼──────────────┤ │SIP │210 │126 │ │- │- │- │ │Total│210 │126 │ └─────┴────────────┴──────────────┘ [exec at: 05.02.2019 08:35:26, exec time: 82ms, nodes: ds1@ecss1]
subscribers-limit
Команда для просмотра количества используемых абонентских лицензий в текущий момент времени, ограничения по количеству, и наличие свободных лицензий на алиасы (абоненты) в рамках storage-кластера.
Путь команды:
/cluster/storage/<CLUSTER>/alias/subscribers-limit
Синтаксис:
subscribers-limit
Параметры:
Команда не содержит аргументов.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/alias/subscribers-limit Licence alias limit: 2000 Licence virtual alias limit: infinity Active, declared aliases in the domain: 327 Active, declared virtual aliases in the domain: 0 --------------------------------- Avaliable aliases: 1673 Avaliable virtual aliases: infinity [exec at: 05.02.2019 08:37:55, exec time: 125ms, nodes: ds1@ecss2]
user-agents
Команда, которая сформирует реестр используемого на софтсвиче абонентского оборудования.
Путь команды:
/cluster/storage/<CLUSTER>/alias/user-agents
Синтаксис:
/user-agents [<DOMAIN> | <FLAGS>]
Параметры:
<DOMAIN> :: имя домена;
<FLAGS> :: ключи вывода (short | full | with_iface | with_alias | with_domain | with_ip | sort <COLUMN> <SORT_TYPE>);
- --short — краткий вывод и количество активных/всего;
- --full — полный вывод всех полей(алиас, интерфейс, домен). Символ * в последнем столбце показывает активную регистрацию в данный момент;
- --with_domain — отображение имен доменов;
- --with_iface — отображение интерфейсов;
- --with_alias — отображение алиасов;
- --with_real_ip — отображение реального ip адреса;
- --with_ip — отображение ip адреса;
- --with_id — отображение id или номера строки;
- --inactive — отображает неактивных UA;
- --active — отображает активных UA;
- limit <COUNT> — вывод только <COUNT> числа строк ;
- sort <COLUMN> <SORT_TYPE> — сортировка по столбцу <COLUMN> порядок сортировки задается в <SORT_TYPE>;
<COLUMN> :: user_agent | domain | amount | iface | alias | ip | real_ip — Имена столбцов;
<SORT_TYPE> :: asc | desc — метод сортировки (по возрастанию или убыванию);
- asc — от меньшего к большему (A -> Z)
- desc — от большего к меньшему (Z -> A)
<COUNT> :: 1,2,3, .. — положительное целое число;
Вывод команды без параметров аналогичен ключу --short;
Вывод команды с параметрами --with_iface --with_alias --with_domain --with_ip аналогичен ключу --full
В столбце "Status" символом "*" отмечены зарегистрированные(активные) интерфейсы
Примеры:
Команда запущена без параметров — показывается короткий вид таблицы (ВСЕ домены)
admin@mycelium1@ecss1:/$ cluster/storage/ds1/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:40:58, exec time: 350ms, nodes: ds1@ecss1]
Можно указать только один домен. Но все равно этот флаг будет обработан, если пользователь явно его укажет.
Если первым был указан какой либо флаг, то ввести домен больше будет нельзя и покажется вывод для ВСЕХ доменов (согласно флагам):
Вывод команды в полном режиме для всех доменов:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/alias/user-agents --full --sort alias desc ┌───────────────────────────────────────────────────┬───────────┬──────┬──────────────────┬─────────────┬──────┐ │ User Agent │ Domain │Alias │ Iface │ IP │Status│ ├───────────────────────────────────────────────────┼───────────┼──────┼──────────────────┼─────────────┼──────┤ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │biysk.local│600 │240466@biysk.local│ │ │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │biysk.local│240699│240699@biysk.local│192.168.2.26 │ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │biysk.local│240698│240698@biysk.local│192.168.2.26 │ * │ ... │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │biysk.local│240500│240500@biysk.local│192.168.2.26 │ * │ │RG-1402G/1.8.1 SN/VI0C000069 sofia-sip/1.12.10 │biysk.local│240475│240475@biysk.local│ │ │ │RG-1404GF-W/1.11.0 SN/VI25002012 sofia-sip/1.12.10 │biysk.local│240474│240474@biysk.local│192.168.2.26 │ * │ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │biysk.local│240473│240473@biysk.local│192.168.2.26 │ * │ │RG-1402G/1.8.1 SN/VI0C000069 sofia-sip/1.12.10 │biysk.local│240471│240471@biysk.local│ │ │ │RG-1404GF-W/1.11.0 SN/VI25002012 sofia-sip/1.12.10 │biysk.local│240470│240470@biysk.local│192.168.2.26 │ * │ │Brcm-Callctrl/v1.10.3 M5T SIP Stack/4.1.2.2 │biysk.local│240469│240469@biysk.local│192.168.2.26 │ * │ │VP-12P/1.4.0.93 SN/VI4B000942 sofia-sip/1.12.10 │biysk.local│240467│240467@biysk.local│ │ │ │VP-12/1.2.1.454 SN/VI51000844 sofia-sip/1.12.10 │biysk.local│240466│240466@biysk.local│192.168.2.26 │ * │ │TAU-2M.IP/2.0.0.229 SN/VI39005419 sofia-sip/1.12.10│biysk.local│240465│240465@biysk.local│192.168.2.200│ * │ │TAU-2M.IP/2.0.0.229 SN/VI39005419 sofia-sip/1.12.10│biysk.local│240464│240464@biysk.local│192.168.2.200│ * │ │Brcm-Callctrl/v1.10.3 M5T SIP Stack/4.1.2.2 │biysk.local│240462│240462@biysk.local│192.168.2.26 │ * │ │Yealink SIP-T28P 2.73.14.3 │biysk.local│240244│240244@biysk.local│192.168.2.26 │ * │ │Yealink SIP-T28P 2.73.14.3 │biysk.local│240101│240101@biysk.local│192.168.2.26 │ * │ │MicroSIP/3.15.6 │biysk.local│240007│240007@biysk.local│ │ │ └───────────────────────────────────────────────────┴───────────┴──────┴──────────────────┴─────────────┴──────┘ Total active user agents amount: 208 Total user agents types amount: 9 Total user agents amount: 213 [exec at: 17.07.2019 12:54:46, exec time: 350ms, nodes: ds1@ecss1]
Вывод для реальных ip-адресов:
admin@[mycelium1@ecss1#ECSS-T 000009]:/$ domain/biysk.local/alias/user-agents --with_real_ip ┌──────────────────────────────────────────────────┬────────────┬──────┐ │ 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│ * │ │Asterisk PBX 13.1.0~dfsg-1.1ubuntu4.1 │10.22.128.19│ * │ │TAU-4M.IP/2.1.0.38 SN/VI4D001354 sofia-sip/1.12.10│10.22.128.70│ * │ │TAU-4M.IP/2.1.0.38 SN/VI4D001354 sofia-sip/1.12.10│10.22.128.70│ * │ └──────────────────────────────────────────────────┴────────────┴──────┘ Total active user agents amount: 8 Total user agents types amount: 2 Total user agents amount: 8 [exec at: 16.09.2019 09:53:19, exec time: 44ms, nodes: ds1@ecss1]
where
Команда поиска алиасов по адресу.
Путь команды:
/cluster/storage/<CLUTER>/alias/where
Синтаксис:
where <ADDRESS RANGE>
Параметры:
<ADDRESS RANGE> — диапазон адресов (номеров) для поиска.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/alias/where biysk.local 240101 Aliases: ┌───────┬───────────┬────────────────┬──────────────────┬────────────┬──────┬──────┐ │Address│ Domain │ Iface │ Iface name │Display name│Active│Binded│ ├───────┼───────────┼────────────────┼──────────────────┼────────────┼──────┼──────┤ │240101 │biysk.local│708c5e7b5dfb8675│240101@biysk.local│ │true │true │ └───────┴───────────┴────────────────┴──────────────────┴────────────┴──────┴──────┘ Note: Binded column show is iface exists or not. [exec at: 05.02.2019 08:42:42, exec time: 83ms, nodes: ds1@ecss2]
who
Команда поиска алиаса по интерфейсу.
Путь команды:
/cluster/storage/<CLUSTER>/alias/who
Синтаксис:
who <DOMAIN> <OWNER> <GROUP> <RANGE>
Параметры:
<OWNER> — название владельца (символ "*" используется для указания всех владельцев);
<GROUP> — название группы (символ "*" используется для указания всех групп);
<RANGE> — диапазон интерфейсов ("портов"/"пучков") для поиска (символ "*" используется для указания всех интерфейсов для заданной группы, владельца).
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/alias/who biysk.local sip1 loc.gr 24046{0-9}@biysk.local
Aliases:
┌────────────────┬───────────┬───────┬────────────┬──────┐
│ Iface │ Domain │Address│Display name│Active│
├────────────────┼───────────┼───────┼────────────┼──────┤
│708c5beda8cd39d0│biysk.local│240462 │ │true │
│708c5bf76388b92e│biysk.local│240464 │ │true │
│708c5c01bd7b9764│biysk.local│240465 │ │true │
│708c5c0b97c48e4d│biysk.local│240469 │ │true │
│708c5eea9833646d│biysk.local│240466 │ │true │
│708c5f55dfa3319a│biysk.local│240467 │ │true │
└────────────────┴───────────┴───────┴────────────┴──────┘
[exec at: 05.02.2019 08:45:59, exec time: 83ms, nodes: ds1@ecss2]