/cluster/storage/<STORAGE>/adaptation/ — команды управления адаптацией номеров
В данном разделе описываются команды по управлению адаптациями номеров.
Подробнее описание настроек адаптации номеров описано в разделе Модификаторы и адаптация номеров по входу/выходу с интерфейса.
Для администратора системы команды выполняются на уровне кластера в разделе /cluster/storage/<CLUSTER>/adaptation/
<DOMAIN> — имя виртуальной АТС.
<STORAGE> — имя кластера с ролью storage.
delete
Команда предназначена для удаления из системы заданного контекста адаптации номеров.
Путь команды:
/cluster/storage/<STORAGE>/adaptation/delete
Синтаксис:
delete <Context>
Параметры:
<Context> -имя контекста адаптации номеров.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/adaptation/delete biysk.local adp_sorm Adaptation was deleted [exec at: 04.02.2019 13:30:30, exec time: 339ms, nodes: ds1@ecss1]
edit
Данной командой производится редактирование контекстов адаптации.
При выполнении команды осуществляется запуск редактора, который выбран командой shell-options editor
Путь команды:
/cluster/storage/<STORAGE>/adaptation/edit
Синтаксис:
edit <NODE> <CONTEXT>
Параметры:
<NODE> — имя ноды;
<DOMAIN> — имя виртуальной АТС;
<CONTEXT> — название контекста адаптации.
Примеры:
Редактирование определенного контекста:
admin@[ds1@ecss1]:/$ cluster/storage/ds1/adaptation/edit adp_sorm Importing adaptation context from /tmp/routing-0.4661.0.xml Success: Context was imported [exec at: 14.03.2019 13:58:54, exec time: 275ms, nodes: ds1@ecss1]
export
Команда предназначена для экспорта заданного контекста адаптации номеров. Каталог для экспорта контекста адаптации распологается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.
Путь команды:
/cluster/storage/<STORAGE>/adaptation/export
Синтаксис:
export <Node> <Domain> <Context>
Параметры:
<Node> — имя ноды;
<Domain> — имя виртуальной АТС;
<Context> — контекста адаптации номеров.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/adaptation/export ecss1 biysk.local adp_sorm Context adp_sorm has been exported [exec at: 04.02.2019 13:18:30, exec time: 242ms, nodes: ds1@ecss1,ds1@ecss2]
import
Команда предназначена для импорта ранее сохраненных файлов, описывающих контексты адаптации номеров. Каталог для импорта контекста адаптации распологается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.
Путь команды:
/cluster/storage/<STORAGE>/adaptation/import
Синтаксис:
import <Host> <File>
Параметры:
<Host> — имя хоста, где находится сохраненных файл;
<File> — имя файла с контекстом адаптации номеров, который необходимо установить;
При задании имени файла можно использовать маску поиска:
"?" — соответствует одному символу;
"*" — соответствует любому количеству символов до конца файла, следующей точки или символа "/". {Item,...} — для указания альтернативного файла.
Пример:
admin@[core1@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 [exec at: 04.02.2019 13:05:13, exec time: 767ms, nodes: ds1@ecss1]
list
Команда предназначена для просмотра списка модификаторов в домене.
Путь команды:
/cluster/storage/<STORAGE>/adaptation/list
Синтаксис:
list [<Domain>]
Параметры:
<Domain> — имя виртуальной АТС.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/adaptation/list Adaptations: biysk.local/adp_sorm biysk.local/default_adaptation biysk.local/mod1_adp front.office/default_adaptation --------- Total: 4 [exec at: 04.02.2019 13:28:57, exec time: 88ms, nodes: ds1@ecss2]
show
Команда предназначена для просмотра контекста адаптации номеров в текстовом виде.
Путь команды:
/cluster/storage/<STORAGE>/adaptation/show
Синтаксис:
show <ContextName>
Параметры:
<ContextName> — имя контекста адаптации.
Пример:
admin@[core1@ecss1]:/$ cluster/storage/ds1/adaptation/show biysk.local mod1_adp
Context was imported at 04.02.2019 13:38:57
<?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"/>
<time value="09:00 — 18:00"/>
<date value="01.01.2019 - 30.12.2019"/>
<weekday value="1,2,3,4,5"/>
</conditions>
<actions>
<cdpn digits="240466"/>
<cn digits="419145"/>
</actions>
<result>
<finish/>
</result>
</rule>
<rule name="other_calls">
<conditions/>
<actions/>
<result>
<finish/>
</result>
</rule>
</adaptation>
[exec at: 04.02.2019 13:39:17, exec time: 149ms, nodes: ds1@ecss2]
trace
Данной командой осуществляется запуск процесса адаптации номеров для СОРМ, ТТС и вывод результатов для указанного набора входных данных.
Эта команда предоставляет удобный способ проверки корректности описания адаптации номеров в системе, четко отображающий шаги адаптации конкретного номера.
Путь команды:
/cluster/storage/<STORAGE>/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@[core1@ecss1]:/$ cluster/storage/ds1/adaptation/trace biysk.local cgpn.digits=240101 cdpn.digits=240464 time=14:00 type=tts Traceroute to 240464 from 240101 (tts adaptation) at 04.02.2019 14:00:00 Default context is mod1_adp mod1_adp / default A: "240101"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined) B: "240464"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined) applying rule: local_calls (CDPN: digits=240464, Time: 01.01.2019 09:00 - 30.12.2019 18:00, Weekdays: Mon, Tue, Wed, Thu, Fri) action: transform cdpn digits=240466 action: transform cn digits=419145 ------------------------------------------ Adaptation result: finish A: "240101"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined) B: "240466"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined) CN: "419145"(displayName=undefined, ni=private, nai=subscriberNumber, npi=isdnTelephony, apri=presentationAllowed) [exec at: 04.02.2019 13:42:11, exec time: 75ms, nodes: ds1@ecss2]