/domain/<DOMAIN>/modificators/ - команды управления контекстами модификации
В данном разделе представлены команды по управлению контекстами модификации.
Подробнее описание настроек адаптации номеров описано в разделе Модификаторы и адаптация номеров по входу/выходу с интерфейса.
<DOMAIN> - имя виртуальной АТС.
Созданные контексты модификации назначаются на iface. Более подробно описано на странице /domain/<DOMAIN>/iface/ - команды управления интерфейсами
delete
Команда предназначена для удаления заданного контекста модификации.
Путь команды:
/domain/<DOMAIN>l/modificators/delete
Синтаксис:
delete <Context>
Параметры:
<Context> - контекста модификации номеров.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/modificators/delete mod_1 Modificator was deleted [exec at: 18.02.2021 15:04:17, exec time: 38ms, nodes: ds1@ecss1 v.3.14.7.594]
edit
Данной командой производится редактирование контекстов модификации.
При выполнении команды осуществляется запуск редактора, который выбран командой shell-options editor
Путь команды:
/domain/<DOMAIN>/modificators/edit
Синтаксис:
edit <Node> <Context>
Параметры:
<Node> - имя ноды;
<Context> - название контекста модификации.
Примеры:
Редактирование определенного модификатора:
admin@mycelium1@ecss1:/$ domain/biysk.local/modificators/edit mod_smg Importing modificators context from /tmp/modificators-0.17601.0.xml Success: Context was imported [exec at: 18.02.2021 14:00:41, exec time: 1m 35s, nodes: ds1@ecss1 v.3.14.7.589]
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_1 Context mod_1 has been exported [exec at: 18.02.2021 13:53:41, exec time: 56ms, nodes: ds1@ecss1 v.3.14.7.589]
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: 18.02.2021 13:52:29, exec time: 247ms, nodes: ds1@ecss1 v.3.14.7.589]
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_smg --------- Total: 3 [exec at: 18.02.2021 13:54:23, exec time: 20ms, nodes: ds1@ecss1 v.3.14.7.589]
show
Команда предназначена для просмотра контекста модификации.
Путь команды:
/domain/<DOMAIN>l/modificators/show
Синтаксис:
show <ContextName>
Параметры:
<ContextName> - имя контекста модификации.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/modificators/show mod_smg
Context was imported at 18.02.2021 14:00:41
<?xml version="1.0" encoding="UTF-8"?>
<modificators xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_modificators.xsd" name="mod_smg">
<in>
<rule name="mod_in_calls">
<conditions>
<cgpn digits="240101"/>
<cdpn digits="S(24046[29])"/>
<cn digits="9913699011"/>
<time value="09:00 - 18:00"/>
<weekday value="1,2,3,4,5"/>
</conditions>
<actions>
<cgpn digits="240101"/>
<cdpn digits="S240500$"/>
<cn digits="3854419159"/>
</actions>
<result>
<finish/>
</result>
</rule>
<rule name="other_in_calls">
<conditions/>
<actions/>
<result>
<finish/>
</result>
</rule>
</in>
<out>
<rule name="smg_out">
<conditions>
<cn digits="9913699011"/>
<weekday value="1,2,3,4,5"/>
</conditions>
<actions>
<cn digits="3854415800"/>
</actions>
<result>
<finish/>
</result>
</rule>
<rule name="other_out_calls">
<conditions/>
<actions/>
<result>
<finish/>
</result>
</rule>
</out>
</modificators>
[exec at: 18.02.2021 14:01:26, exec time: 41ms, nodes: ds1@ecss1 v.3.14.7.589]
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=240101 cdpn.digits=240462 cn.digits=9913699011 direction=in Traceroute to 240462 from 240101(064bc9652bfe3487) CN:9913699011 at 18.02.2021 14:05:25 Default context is mod_smg mod_smg / default A: "240101"(displayName=undefined, ni=private, nai=subscriberNumber, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id="240101") B: "240462"(displayName=undefined, ni=undefined, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined) CN: "9913699011"(displayName=undefined, ni=private, nai=subscriberNumber, npi=isdnTelephony, apri=presentationAllowed, caller_id=undefined) applying rule: mod_in_calls (CGPN: digits=240101, caller_id=undefined, CDPN: digits=S240469S240462, CN: digits=9913699011, caller_id=undefined, Time: *.*.* 09:00 - *.*.* 18:00, Weekdays: Mon, Tue, Wed, Thu, Fri) action: transform cgpn digits=240101, caller_id=undefined action: transform cdpn digits=240500 action: transform cn digits=3854419159, caller_id=undefined ------------------------------------------ Modification result: finish A: "240101"(displayName=undefined, ni=private, nai=subscriberNumber, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id="240101") B: "240500"(displayName=undefined, ni=undefined, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined) CN: "3854419159"(displayName=undefined, ni=private, nai=subscriberNumber, npi=isdnTelephony, apri=presentationAllowed, caller_id=undefined) [exec at: 18.02.2021 14:05:25, exec time: 27ms, nodes: ds1@ecss1 v.3.14.7.589]