В данном разделе приводится описание команд управления телефонной маршрутизацией.
Контекст маршрутизации - совокупность правил маршрутизации уникальная в домене маршрутизации, в рамках которого идет определение интерфейса вызываемого абонента.
Для администратора системы команды выполняются на уровне кластера в разделе /cluster/storage/<CLUSTER>/routing/.
Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе 3.11 /domain/<DOMAIN>/routing и применяются только для определенной виртуальной АТС.
<STORAGE> - имя кластера с ролью storage.
delete
Команда предназначена для удаления из системы заданного контекста маршрутизации.
Путь команды:
cluster/storage/<STORAGE>/routing/delete
Синтаксис:
delete <DOMAIN> <ROUTING_CONTEXT>
Параметры:
<DOMAIN> - имя виртуальной АТС;
<ROUTING_CONTEXT> - контекст маршрутизации, который требуется удалить.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/delete my.domain my_context Context was deleted
export
Данной командой производится экспорт модулей контекстов маршрутизации в файлы, описывающие эти контексты для их резервного копирования и/или модификации.
Путь команды:
cluster/storage/<STORAGE>/routing/export
Синтаксис:
export <NODE> <DOMAIN> <ROUTING_CONTEXT>
Параметры:
<NODE> - имя ноды;
<DOMAIN> - имя виртуальной АТС;
<ROUTING_CONTEXT> - название контекста маршрутизации.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/export ecss1 test.domain ss_context Context have been exported
generate_digitmaps
Данной командой производится генерация плана нумерации для всех контекстов маршрутизации в указанном домене (где поле плана нумерации устанавливается в "auto") и сохранение в DS.
Путь команды:
cluster/storage/<STORAGE>/routing/generate_digitmaps
Синтаксис:
generate_digitmaps <DOMAIN>
Параметры:
<DOMAIN> - имя виртуальной АТС.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/generate_digitmaps test.domain Starting digitmap generation for context: context10 Success: (3XX|80X|82X|9XX) Starting digitmap generation for context: ss Success: (*[0-9*][0-9*].#|#[0-9*][0-9*].#|*#[0-9*][0-9*].#|1xx.|10xx.) Starting digitmap generation for context: group2 Success: 85X Starting digitmap generation for context: ctx_to_smg Success: undefined Starting digitmap generation for context: gr1.context Success: 84X Starting digitmap generation for context: context4 Success: () Starting digitmap generation for context: context2 Success: 7XX Starting digitmap generation for context: context1 Success: (#[*0-9][*0-9].#|*#[*0-9][*0-9].#|*[*0-9][*0-9].#|10xx.|1XX|1xx.|2XX|3X X|40X|44XX|512XXX|5XX|777XXX|9XXX|AXXX) Starting digitmap generation for context: context3 Success: XXX Starting digitmap generation for context: context11 Success: (3XX|80X|82X) Generation has been finished ok
import
Команда осуществляет импорт ранее сохраненных файлов, описывающих контексты маршрутизации.
Во время импортирования производится проверка на правильность формата файла (проверка корректности XML описания контекста маршрутизации), производится компиляция контекста маршрутизации. Полученный исполняемый модуль встраивается в систему маршрутизации. При совпадении имени контекста маршрутизации с существующим в системе контексте производится замена существующего контекста на импортируемый контекст маршрутизации.
Путь команды:
cluster/storage/<STORAGE>/routing/import
Синтаксис::
import <NODE> <DOMAIN> <FILE>
Параметры:
<NODE> - имя ноды;
<DOMAIN> - имя виртуальной АТС;
<FILE> - имя файла с контекстом маршрутизации, который необходимо установить;
"?" - соответствует одному символу;
"*" - соответствует любому количеству символов до конца файла, следующей точки или символа "/". {Item,...} - для указания альтернативного файла.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/import leonid1 ss.xml importing file ss.xml... generated 106 rules 1 context has been successfully imported
show
Команда позволяет просмотреть содержание файла контекста маршрутизации с именем <ContextName>.
Путь команды:
cluster/storage/<STORAGE>/routing/show
Синтаксис:
show <DOMAIN> <ROUTING_CONTEXT>
Параметры:
<ROUTING_CONTEXT> - имя контекста маршрутизации.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/show test.domain group2
Context was imported at 14.03.2013 08:49:28
<?xml version="1.0"?>
<context xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_routing.xsd" name="group2" domain="test.domain" digitmap="auto">
<rule name="local">
<conditions>
<cdpn digits="85?"/>
</conditions>
<actions/>
<result>
<local/>
</result>
</rule>
</context>
trace
Данной командой осуществляется запуск процесса маршрутизации и вывод результатов для указанного набора входных данных об устанавливаемом телефонном соединении.
Эта команда предоставляет удобный способ проверки корректности описания маршрутизации в системе, четко отображающий шаги маршрутизации конкретного вызова с указанием переходов между контекстами маршрутизации.
Путь команды:
cluster/storage/<STORAGE>/routing/trace
Синтаксис:
trace [<KEY1> = <VALUE1>[, ... [, <KEY> = <VALUE>]]]
Параметры:
<KEY> - название параметра, принимает следующие значения:
- calling. - переопределение свойств алиаса А (calling.access_intercity, calling.access_international, calling.access_local, calling.access_private, calling.access_zone, calling.category, calling.provider), опциональный параметр.
- cause - причина разъединения;
- cdpn. - параметры вызываемого абонента (cdpn.digits, cdpn.incomplete, cdpn.inni, cdpn.nai, cdpn.ni, cdpn.npi), обязательный параметр cdpn.digits.
- cgpn. - параметры вызывающего абонента (cgpn.apri, cgpn.digits, cgpn.incomplete, cgpn.nai, cgpn.ni, cgpn.npi, cgpn.screening), опциональный параметр.
- context - исходный контекст маршрутизации, опциональный параметр. По умолчанию устанавливается контекст маршрутизации для интерфейса А. Задается в виде имя_домена/контекст_маршрутизации.
- date - дата эмуляции вызова, задается в виде: D.M.Y или Y/M/D, опциональный параметр. По умолчанию устанавливается текущая дата.
- iface - интерфейс вызывающего абонента, обязательный параметр.
- mode - режим набора по префиксу, принимает значения:
- enblock – номер абонента передается блоком;
- overlap – номер абонента передается с перекрытием (по одной цифре);
Опциональный параметр, по умолчанию установлено: overlap.
- tag - специальный параметр, который можно установить для вызова при маршрутизации. Параметр действует только на этапе маршрутизации, устанавливается в каком-либо правиле маршрутизации и в последующем используется для изменения отработки логики маршрутизации;
- time - время эмуляции вызова, задается в виде: H:M, опциональный параметр. По умолчанию устанавливается текущее время.
<VALUE> - значение параметра.
Пример:
ecss-root@[core1@leonid1]:/# cluster/storage/ds1/routing/trace cgpn.digits=77710 cdpn.digits=77701 mode=enblock
list
Команда позволяет просмотреть список имен контекстов маршрутизации в данном домене.
Путь команды:
cluster/storage/<STORAGE>/routing/list
Синтаксис:
list <DOMAIN>
Параметры:
<DOMAIN> - имя виртуальной АТС.
Пример:
admin@[mycelium1@ecss1]:/$ domain/pk.ssw/routing/list Routing contexts: 725_test ctx_1 ctx_ats_from ctx_b_to_a_call ctx_city_local ctx_eltex_incoming ctx_from_vitaliy ctx_smg148 ctx_to_d_city default_routing tim_asa --------- Total: 11