Настройка шлюзов Н.248/Megaco через CLI

Добавление команд для управления шлюзом Н.248/Megaco

Для добавления дополнительных команд управления шлюзом в командную консоль нужно отредактировать конфигурационный файл ds1.config.

Если вы работаете в командной консоли управления CLI, то нужно выйти из нее, используя команду exit.
Команда для редактирования файла выполняется из командной консоли управления операционной системы Linux (shell):

sudo nano /etc/ecss/ecss_ds/ds1.config

где

ds1 - имя ноды кластера DS в системе по умолчанию.

В строке {ds_data_core, [{enable_gateway_commands, false}]}, заменить значение "false" на "true":

{ds_data_core, [{enable_gateway_commands, true}]},

Сохранить файл и перезапустить адаптер ds.

Для перезапуска используется команда:

sudo systemctl restart ecss-ds.service

Создание шлюза Н.248/Megaco и его физических терминаций

Для создания шлюза Н.248/Megaco подключитесь к командной консоли CLI под пользователем admin.

Пароль по умолчанию: password.

Команда для подключения к консоли:

ssh admin@localhost -p 8023

Порядок создания шлюза Н.248/Megaco:

1. Задекларировать шлюз Н.248/Megaco командой:

/domain/<DOMAIN_NAME>/gateway/declare <GATEWAY_NAME> megaco gw

2. Далее добавить задекларированный шлюз в кластер адаптера PA_MEGACO:

/domain/<DOMAIN_NAME>/megaco/gateways/add <CONTEXT_NAME> <GATEWAY_NAME>

3. Для задекларированного шлюза создать физические терминации (порты шлюза):

/domain/<DOMAIN_NAME>/gateway/add-port <GATEWAY_NAME> <PORTS>

Для удаления шлюза используется команда:

/domain/<DOMAIN_NAME>/gateway/remove <GATEWAY_NAME>

Для удаления портов шлюза используется команда:

/domain/<DOMAIN_NAME>/gateway/remove-port <GATEWAY_NAME> <PORTS>

Для просмотра информации о созданном шлюзе и его физических терминациях используется команда:

/domain/<DOMAIN_NAME>/gateway/info <GATEWAY_NAME>

где

<GATEWAY_NAME> - имя шлюза (подключаемый megaco-шлюз должен иметь аналогичное имя);
<PORTS> - порты шлюза. Для указания диапазона портов используются фигурные скобки, например: aaln/{0-71};
<CLUSTER> - имя кластера адаптера PA_MEGACO.

Более подробное описание команд и дополнительных возможностей приведено в справочнике CLI Общие команды управления протокол адаптером MEGACO, Команды конфигурирования кластера адаптера протокола Megaco, Команды управления MEGACO-шлюзами .

Привязка абонентских номеров к физическим терминациям

Для назначения соответствий абонентских номеров физическим терминациям используется команда:

/domain/<DOMAIN>/alias/declare <NUMBER> <CLUSTER> <GATEWAY_NAME> <INTERFACE>

где

<NUMBER> - абонентский номер или диапазон номеров. Для указания диапазона портов используются фигурные скобки, например: 2100{00-71};
<INTERFACE> - интерфейс абонента или диапазон интерфейсов, имеет формат: acp:<port>@<gateway_name>;
<PORT> - порт шлюз или диапазон портов. Для указания диапазона портов используются фигурные скобки, например: aaln/{0-71};
<DOMAIN_NAME> - имя виртуальной АТС;
<CLUSTER> - имя кластера адаптера PA_MEGACO;
<GATEWAY_NAME> - имя шлюза.

При необходимости использовать диапазон номеров и интерфейсов стоит учитывать, что количество элементов в диапазоне номеров должно соответствовать количеству элементов в диапазоне интерфейсов. Система последовательно ставит в однозначное соответствие первый номер диапазона номеров первому интерфейсу диапазона интерфейсов, второй номер второму интерфейсу и т.д.

При необходимости удаления абонента из системы используется команда:

/domain/<DOMAIN>/alias/remove <INTERFACE> <NUMBER>

где

<NUMBER> - абонентский номер или диапазон номеров. Для указания диапазона портов используются фигурные скобки, например: 2100{00-71};
<INTERFACE> - интерфейс абонента, имеет формат: acp:<port>@<gateway_name>;
<DOMAIN> - имя виртуальной АТС.

Пример

Назначение номера 220000 физической терминации aaln/34 на шлюзе gate1 в кластере адаптеров megaco с именем pa_megaco1:

/domain/voip/alias/declare 220000 megaco1 gate1 acp:aaln/34

Назначение нумерации 210000-210071 физическим терминациям aaln/0-aaln/71 для шлюза tau72 в кластере pa_megaco1:

/domain/voip/alias/declare 2100{00-71} megaco1 tau72 acp:aaln/{0-71}@tau72

Настройка параметров абонента

Значения параметров определенного алиаса являются совокупностью параметров, назначенных в настройках алиаса либо в профилях домена алиасов. 

То есть устанавливать значения параметров для абонента можно как индивидуально, так и для группы абонентов через профиль группы.

Значения индивидуальных параметров алиаса, а так же значения параметров профилей домена алиаса для определенной виртуальной АТС (домена) может настраивать администратор виртуальной АТС.

Значения параметров глобального профиля алиасов может настраивать только администратор системы.

Команды уровня администратора виртуальной АТС

Для изменения индивидуальных значений параметров алиаса используются следующие команды:

• Команда для изменения параметров определенного абонентского номера и интерфейса заданной виртуальной АТС:
  /domain/<DOMAIN>/alias/set <NUMBER> <GROUP_NAME> <INTERFACE> <PARAMETER> <VALUE>

• Команда для изменения параметров всех абонентов с определенным интерфейсом заданной виртуальной АТС:
  /domain/<DOMAIN>/alias/set-for-iface <GROUP_NAME> <INTERFACE> <PARAMETER> <VALUE>

• Команда для изменения параметров всех абонентов с определенным абонентским номером заданной виртуальной АТС:
  /domain/<DOMAIN>/alias/set-for-address <NUMBER> <PARAMETER> <VALUE>

где

<DOMAIN> - имя виртуальной АТС;
<NUMBER> - абонентский номер;
<GROUP_NAME> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<INTERFACE> - имя интерфейса;
<PARAMETER> - имя изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов.

Для изменения значений параметров профиля домена алиаса необходимо выполнить следующую команду:
/domain/<DOMAIN>/alias/set-for-domain <PARAMETER> <VALUE>

где

<DOMAIN> - имя виртуальной АТС;
<PARAMETER> - имя изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов.

Команды уровня администратора системы

Для изменения значений индивидуальных параметров алиаса необходимо выполнить следующую команду:

/cluster/storage/<SOME_STORAGE>/alias/set-for-address <NUMBER> <PARAMETER> <VALUE>

Свойство будет назначено всем одинаковым номерам во всех виртуальных АТС.

Для изменения значений параметров профиля на уровне домена необходимо выполнить следующую команду:

/cluster/storage/<SOME_STORAGE>/alias/set <DOMAIN> <PROPERTY> <VALUE>

Для изменения значений параметров глобального профиля алиасов необходимо выполнить следующую команду:

/cluster/storage/<SOME_STORAGE>/alias/global-set <PARAMETER> <VALUE>

где

<SOME_STORAGE> - имя кластера хранения долговременных данных (DS). По умолчанию в системе присутствует кластера хранения долговременных данных с именем "ds1";
<NUMBER> - абонентский номер;
<DOMAIN> - имя виртуальной АТС (домена);
<PARAMETER> - имя изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов.

Настройка шлюзов Н.248/Megaco через Web-конфигуратор

Создание профиля

Для работы со шлюзами Н.248/Megaco через Web-конфигуратор используется приложение "Менеджер шлюзов" ("Gateway manager").

Описание приложения приведено в разделе Менеджер шлюзов (Gateway manager).

Добавление шлюза

Перед добавлением шлюза в систему необходимо создать профиль шлюза.

Создание физических терминаций (портов)

Привязка абонентского номера к порту (создание H248/Megaco-абонентов)

Для назначения соответствий абонентских номеров физическим терминациям используется приложение "Карточка абонента" ("Subscriber card").
Описание приложения приведено в разделе Карточка абонента (Subscriber card).

Настройка параметров абонента

Настройка параметров абонента выполняется в приложении "Карточка абонента" ("Subscriber card").

Для настройки основных параметров абонента необходимо выделить абонента. 

Удаление абонента

Удаление абонента выполняется в приложении "Карточка абонента" ("Subscriber card").

Настройка параметров кластера протокол-адаптера Megaco

Конфигурирование параметров, необходимых для работы кластера протокол-адаптера Megaco, включает в себя настройку стека TCP/IP, поверх которого будет работать протокол Н.248/MEGACO и кодировки.

Нужно настроить следующие параметры:

Параметр

Значение

bind_to

dtmf_mode

enabled

fax_detect

send_release_ack

use_rtcp

transport

listen_port 

encoding

Сетевой интерфейс

Режим детектирования dtmf

Включен ли адаптер Megaco

Определяет режим детектирования факса

Будет ли отправляться ack после релиза

Требуется ли использовать rtcp

Транспортный протокол, очередность выбора транспортного протокола

Транспортные порты для приема сигнализации SIP

Кодировка 

Полный список параметров интерфейса MEGACO приведен в разделе Приложение В. Набор параметров интерфейса MEGACO.

Конфигурирование

Для конфигурирования сетевого адреса используется команда:

/domain/<DOMAIN>/megaco/config/set bind_to <VALUE>

Для конфигурирования транспортного протокола используется команда:

/domain/<DOMAIN>/megaco/config/set transport <VALUE>

Для конфигурирования транспортного порта используется команда (по умолчанию значение порта 2944):

/domain/<DOMAIN>/megaco/config/set listen_port <VALUE>

Для конфигурирования кодировки используется команда (по умолчанию значение кодировки text):

/domain/<DOMAIN>/megaco/config/set encoding <VALUE>

После окончания конфигурирования требуется активироваться адаптер:

/domain/<DOMAIN>/megaco/config/set enabled <VALUE>

Контроль

Далее следует убедиться, что новая конфигурация была применена, командой:

domain/<DOMAIN>/megaco/config/info [<PARAMETER>]

<NAME_CLUSTER> - имя кластера;
<NAME_NODE> - имя ноды;
<PARAMETER> - имя свойства;
<VALUE> - значение свойства.

Для более тонкой настройки кластера смотрите раздел Тонкая настройка системы.