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

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

<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]
CODE

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]