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

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

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

Созданные контексты модификации назначаются на iface. Более подробно описано на странице /domain/<DOMAIN>/iface/ - команды управления интерфейсами

delete

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

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

/domain/<DOMAIN>l/modificators/delete

Синтаксис:

delete <Context>

Параметры:

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/delete mod_if_1 
Modificator was deleted

[exec at: 28.03.2019 11:35:33, exec time: 150ms, nodes: ds1@ecss2]

edit

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

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

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

/domain/<DOMAIN>/modificators/edit

Синтаксис:

edit <Node> <Context>

Параметры:

<Node> - имя ноды;
<Context> - название контекста модификации.

Примеры:

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

admin@[ds1@ecss1]:/$ domain/biysk.local/modificators/edit ctx_city_common              
Importing modificators context from /tmp/modificators-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/modifications/ctx/src/<DOMAIN>.

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

/domain/<DOMAIN>l/modificators/export

Синтаксис:

export <Node> <Context>

Параметры:

<Node> - имя ноды;
<Context> - контекста модификации.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/export ecss1 mod_if_1 
Context mod_if_1 has been exported

[exec at: 28.03.2019 11:15:42, exec time: 346ms, nodes: ds1@ecss1]

import

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

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

/domain/<DOMAIN>l/modificators/import

Синтаксис:

import <Host> <File>

Параметры:

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

При задании имени файла можно использовать маску поиска:

"?" - соответствует одному символу;

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/import ecss1 mod_if_1.xml 
importing file mod_if_1.xml...
generated 6 rules
1 context has been successfully imported

[exec at: 27.03.2019 16:16:50, exec time: 1s 203ms, nodes: ds1@ecss1,ds1@ecss2]

list

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

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

/domain/<DOMAIN>l/modificators/list

Синтаксис:
list

Команда не содержит аргументов.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/list 
Modificators:

biysk.local/default_modificators
biysk.local/mod_1
biysk.local/mod_if_1
---------
Total: 3

[exec at: 28.03.2019 11:10:24, exec time: 66ms, nodes: ds1@ecss2

show

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

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

/domain/<DOMAIN>l/modificators/show

Синтаксис:

show <ContextName>

Параметры:

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/show mod_if_1 
Context was imported at 27.03.2019 16:16:49

<?xml version="1.0" encoding="UTF-8"?>
 <modificators xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_modificators.xsd" name="mod_if_1">
 <in>
 <rule name="local_calls">
 <conditions>
 <cgpn digits="240???"/>
 <cdpn digits="240466"/>
 </conditions>
 <actions>
 <cgpn digits="240476"/>
 </actions>
 <result>
 <finish/>
 </result>
 </rule>
 <rule name="other_calls">
 <conditions/>
 <actions/>
 <result>
 <finish/>
 </result>
 </rule>
 </in>
 <out>
 <rule name="to_iface1">
 <conditions>
 <cn digits="240???"/>
 </conditions>
 <actions>
 <cn digits="240467"/>
 </actions>
 <result>
 <finish/>
 </result>
 </rule>
 <rule name="other_calls">
 <conditions/>
 <actions>
 <cgpn digits="240476"/>
 </actions>
 <result>
 <finish/>
 </result>
 </rule>
 </out>
 </modificators>


[exec at: 28.03.2019 11:07:54, exec time: 98ms, nodes: ds1@ecss1]

trace

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

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

/domain/<DOMAIN>l/modificators/trace

Синтаксис:

Команда аналогична командам трассировки маршрутизации:
trace [<Key1> = <Value1>[, ... [, <KeyN> = <ValueN>]]]

Параметры:

direction - направление вызова (in - входящий, out - исходящий) (обязательный параметр);

iface - ID интерфейса, для которого применяются модификаторы (взаимоисключающий с iface_name) (опциональный параметр);

iface_name - имя интерфейса, для которого применяются модификаторы (взаимоисключающий с iface) (опциональный параметр);

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 - имя контекста модификации, (опциональный параметр) (по умолчанию: контекст модификации абонента А для in, абонента Б для out (либо переданного поля iface/iface_name));

date - дата запроса (D.M.Y or Y/M/D), (опциональный параметр) (по умолчанию: сегодня);

time - время запроса (H:M), (опциональный параметр) (по умолчанию: сейчас).

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/modificators/trace cgpn.digits=240462 cdpn.digits=240466 direction=in 
Traceroute to 240466 from 240462(708c5beda8cd39d0) at 27.03.2019 16:22:51
Default context is mod_if_1
mod_if_1 / default
A: "240462"(displayName=undefined, ni=private, nai=subscriberNumber, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id="240462")
B: "240466"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)
 applying rule: local_calls (CGPN: digits=240___, CDPN: digits=240466)
 action: transform cgpn digits=240476
------------------------------------------

Modification result: finish
A: "240476"(displayName=undifined, ni=private, nai=subscriberNumber, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id="240462")
B: "240466"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)

[exec at: 27.03.2019 16:22:51, exec time: 83ms, nodes: ds1@ecss1]