В данном разделе описываются команды по управлению адаптациями номеров.

Подробнее описание настроек адаптации номеров описано в разделе Модификаторы и адаптация номеров по входу/выходу с интерфейса.

Для администратора системы команды выполняются на уровне кластера в разделе /cluster/storage/<CLUSTER>/adaptation/

<DOMAIN> — имя виртуальной АТС.

<STORAGE> — имя кластера с ролью storage.

delete

Команда предназначена для удаления из системы заданного контекста адаптации номеров.

Путь команды:

/cluster/storage/<STORAGE>/adaptation/delete

Синтаксис:

delete <Context>

Параметры:

<Context> -имя контекста адаптации номеров.

Пример:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/delete a.test default_adaptation 
Adaptation was deleted

[exec at: 17.02.2021 16:01:46, exec time: 37ms, nodes: ds1@ecss1 v.3.14.7.589]

edit

Данной командой производится редактирование  контекстов адаптации.

При выполнении команды осуществляется запуск редактора, который выбран командой shell-options editor

Путь команды:

/cluster/storage/<STORAGE>/adaptation/edit

Синтаксис:

edit <NODE> <CONTEXT>

Параметры:

<NODE> — имя ноды;
<DOMAIN> — имя виртуальной АТС;
<CONTEXT> — название контекста адаптации.

Примеры:

Редактирование определенного контекста:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/edit a.test default_adaptation              
Importing adaptation context from /tmp/adaptation-0.5826.0.xml
Success: Context was imported

[exec at: 17.02.2021 15:59:19, exec time: 1m 12s, nodes: ds1@ecss1 v.3.14.7.589]

export

Команда предназначена для экспорта заданного контекста адаптации номеров. Каталог для экспорта контекста адаптации распологается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.

Путь команды:

/cluster/storage/<STORAGE>/adaptation/export

Синтаксис:

export <Node> <Domain> <Context>

Параметры:

<Node> — имя ноды;
<Domain> — имя виртуальной АТС;
<Context> — контекста адаптации номеров.

Пример:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/export ecss1 biysk.local default_adaptation              
Context default_adaptation has been exported

[exec at: 17.02.2021 15:51:19, exec time: 38ms, nodes: ds1@ecss1 v.3.14.7.589]

import

Команда предназначена для импорта ранее сохраненных файлов, описывающих контексты адаптации номеров. Каталог для импорта контекста адаптации располагается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.

Путь команды:

/cluster/storage/<STORAGE>/adaptation/import

Синтаксис:

import <Host> <File>

Параметры:

<Host> — имя хоста, где находится сохраненных файл;
<File> — имя файла с контекстом адаптации номеров, который необходимо установить;

При задании имени файла можно использовать маску поиска:
"?" — соответствует одному символу;
"*" — соответствует любому количеству символов до конца файла, следующей точки или символа "/". {Item,...} — для указания альтернативного файла.

Пример:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/import ecss1 a.test ctx_default_adaptation.xml     
importing file ctx_default_adaptation.xml...
generated 2 rules
1 context has been successfully imported

[exec at: 17.02.2021 15:36:25, exec time: 216ms, nodes: ds1@ecss1 v.3.14.7.589]

list

Команда предназначена для просмотра списка модификаторов в домене.

Путь команды:

/cluster/storage/<STORAGE>/adaptation/list

Синтаксис:

list [<Domain>]

Параметры:

<Domain> — имя виртуальной АТС.

Пример:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/list         
Adaptations:

a.test/default_adaptation
biysk.local/default_adaptation
test/default_adaptation
---------
Total: 3

[exec at: 17.02.2021 15:01:05, exec time: 22ms, nodes: ds1@ecss1 v.3.14.7.589]

show

Команда предназначена для просмотра контекста адаптации номеров в текстовом виде.

Путь команды:

/cluster/storage/<STORAGE>/adaptation/show

Синтаксис:

show <ContextName>

Параметры:

<ContextName> — имя контекста адаптации.

Пример:

admin@mycelium1@ecss1:/$ cluster/storage/ds1/adaptation/show a.test default_adaptation 
Context was imported at 12.02.2021 14:09:30

<?xml version="1.0" encoding="UTF-8"?>
  <adaptation xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_modificators.xsd" name="default_adaptation">
    <rule name="local_calls">
      <result>
        <finish/>
      </result>
    </rule>
  </adaptation>


[exec at: 17.02.2021 15:33:29, exec time: 49ms, nodes: ds1@ecss1 v.3.14.7.589]

trace

Данной командой осуществляется запуск процесса адаптации номеров для СОРМ, ТТС и вывод результатов для указанного набора входных данных.

Предварительно необходимо включить адаптацию на соответствующей виртуальной АТС : /domain//tts/properties/ - команды настройки сервиса TTS
Эта команда предоставляет удобный способ проверки корректности описания адаптации номеров в системе, четко отображающий шаги адаптации конкретного номера.

Путь команды:

/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@mycelium1@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 17.02.2021 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=undefined, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)
applying rule: other_calls
------------------------------------------

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: "240464"(displayName=undefined, ni=undefined, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)

[exec at: 17.02.2021 16:23:21, exec time: 21ms, nodes: ds1@ecss1 v.3.14.7.589]