В данном разделе описываются команды по управлению адаптациями номеров.
Подробнее описание настроек адаптации номеров - в разделе Модификаторы и адаптация номеров по входу/выходу с транка
Для администратора системы команды выполняются на уровне кластера в разделе /cluster/storage/<CLUSTER>/adaptation/.
Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе domain/<DOMAIN>/adaptation/ и применяются только для определенной виртуальной АТС.
Файлы контекстов размещаются по пути: /var/lib/ecss/adaptation/ctx/src/<DOMAIN>/.
<STORAGE> - имя кластера с ролью storage.
delete
Команда предназначена для удаления из системы заданного контекста адаптации номеров.
Путь команды:
domain/<DOMAIN>/adaptation/delete
Синтаксис:
delete <Context>
Параметры:
<Context> - контекста адаптации номеров.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/delete mod2_adp Adaptation was deleted
export
Команда предназначена для экспорта заданного контекста адаптации номеров.
Путь команды:
domain/<DOMAIN>/adaptation/export
Синтаксис:
- команда уровня кластера:
export <Node> <Domain> <Context>
- команда уровня виртуальной АТС:
export <Node> <Context>
Параметры:
<Node> - имя ноды;
<Domain> - имя виртуальной АТС;
<Context> - контекста адаптации номеров.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/adaptation/export ecss1 biysk.local adp_sorm Context adp_sorm has been exported
import
Команда предназначена для импорта ранее сохраненных файлов, описывающих контексты адаптации номеров.
Путь команды:
domain/<DOMAIN>/adaptation/import
Синтаксис:
import <Host> <File>
Параметры:
<Host> - имя хоста, где находится сохраненных файл;
<File> - имя файла с контекстом адаптации номеров, который необходимо установить;
При задании имени файла можно использовать маску поиска:
"?" - соответствует одному символу;
"*" - соответствует любому количеству символов до конца файла, следующей точки или символа "/". {Item,...} - для указания альтернативного файла.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/adaptation/import ecss1 biysk.local adp_1.xml importing file adp_1.xml... generated 3 rules 1 context has been successfully imported
list
Команда предназначена для просмотра списка модификаторов в домене.
Путь команды:
domain/<DOMAIN>/adaptation/list
Синтаксис:
- команда уровня кластера:
list [<Domain>]
- команда уровня виртуальной АТС:
list
Параметры:
<Domain> - имя виртуальной АТС.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/adaptation/list Adaptations: biysk.local/adp_sorm biysk.local/default_adaptation biysk.local/mod2_adp test/default_adaptation --------- Total: 4
show
Команда предназначена для просмотра контекста адаптации номеров в текстовом виде.
Путь команды:
domain/<DOMAIN>/adaptation/show
Синтаксис:
show <ContextName>
Параметры:
<ContextName> - имя контекста адаптации.
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/adaptation/show biysk.local mod1_adp Context was imported at 22.07.2018 10:20:36 <?xml version="1.0" encoding="UTF-8"?> <adaptation xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_modificators.xsd" name="mod1_adp"> <rule name="local_calls"> <conditions> <cdpn digits="240464"/> <rgn digits="3854240465"/> <ocdpn digits="%"/> <time value="09:00 - 18:00"/> <date value="01.01.2018 - 30.12.2018"/> <weekday value="1,2,3,4,5"/> </conditions> <actions> <cdpn digits="240466"/> <rgn digits="3854240466"/> <ocdpn digits="240475"/> <cn digits="419145"/> </actions> <result> <finish/> </result> </rule> <rule name="other_calls"> <conditions/> <actions/> <result> <finish/> </result> </rule> </adaptation>
trace
Данной командой осуществляется запуск процесса адаптации номеров для СОРМ, ТТС и вывод результатов для указанного набора входных данных.
Эта команда предоставляет удобный способ проверки корректности описания адаптации номеров в системе, четко отображающий шаги адаптации конкретного номера.
Путь команды:
domain/<DOMAIN>/adaptation/trace
Синтаксис:
Команды уровня виртуальной АТС и кластера аналогичны командам трассировки маршрутизации:
trace [<Key1> = <Value1>[, ... [, <KeyN> = <ValueN>]]]
Параметры:
type - sorm | tts - тип модификации, СОРМ или ТТС;
tag - параметр tag (опциональный параметр);
cgpn - параметры Calling party number (опциональный параметр);
cdpn - параметры Called party number, cdpn.digits (обязательный параметр);
rgn - параметры Redirecting number (опциональный параметр);
rnn - параметры Redirection number (опциональный параметр);
ocdpn - параметры Original called party number (опциональный параметр);
cn - параметры ConnectedNumber (опциональный параметр);
context - имя контекста модификации, (опциональный параметр) (по умолчанию: контекст адаптации для СОРМ/ТТС);
date - дата запроса (D.M.Y or Y/M/D), (опциональный параметр) (по умолчанию: сегодня);
time - время запроса (H:M), (опциональный параметр) (по умолчанию: сейчас).
Пример:
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/adaptation/trace biysk.local cgpn.digits=240465 cdpn.digits=240101 time=13:30 type=sorm Traceroute to 240101 from 240465 (sorm adaptation) at 22.07.2018 13:30:00 Default context is adp_sorm adp_sorm / default A: "240465"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined) B: "240101"(displayName=undefined, ni=undefined, nai=undefined, inc=false, inni=undefined, npi=undefined, category=undefined) applying rule: for_sorm ------------------------------------------ Adaptation result: finish A: "240465"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined) B: "240101"(displayName=undefined, ni=undefined, nai=undefined, inc=false, inni=undefined, npi=undefined, category=undefined)