Настройка шлюзов Н.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).

Для добавления нового профиля определенному шлюзу в разделе "Профиль" ("Profile") нажмите кнопку "Добавить" ("Add"), введите название профиля и нажмите кнопку "ОК":

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

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

Для добавления нового шлюза в систему в разделе "Шлюзы" ("Gateways") нажмите кнопку "Добавить" ("Add") и заполните следующие поля:

  • Имя (Name) — имя шлюза;
  • Профиль (Profile) — профиль настроек, назначаемый шлюзу;
  • Адаптер (Adapter) — кластер адаптера;
  • Тип (Type) — тип шлюза;
  • Контекст (Context) — контекст маршрутизации.

Для сохранения настроек нажмите кнопку "Сохранить" ("Save").
Для выхода без сохранения настроек нажмите кнопку "Отмена" ("Cancel").

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

Для добавления порта к заданному шлюзу во вкладке "Порты" ("Ports") нажмите кнопку "Добавить" ("Add"), введите имя порта и нажмите кнопку "ОК":

Для Megaco-шлюза имя порта задается в виде: <имя>/<номер порта>, пример: p/0.

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

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

Для добавления MEGACO-абонента нажмите кнопку "Добавить MEGACO абонента" ("Add megaco user") и заполните следующие поля:

  • Имя (Name) — номер телефона абонента. Можно задать список номеров абонентов;

    Список абонентов может быть задан диапазоном {a-b} или перечислением {a,b}, где a,b — натуральные числа;
    Пример. Список абонентов с номерами 755,765,775 можно указать в виде 7{5-7}5 или 7{5,6,7}5 или {755,765,775};
  • Владелец интерфейсов (Interface owner) — владелец интерфейса;
  • Группа интерфейсов (Interface group ) — группа, в которую входит интерфейс;

  • Интерфейс (Interface) — имя интерфейса (список интерфейсов), задается в виде acp:p/номер_порта(ов)@имя MEGACO-шлюза;

    Список интерфейсов может быть задан диапазоном {a-b} или перечислением {a,b}, где a,b — натуральные числа.
    Пример. Интерфейсы acp:p/1@test, acp:p/2@test, acp:p/3@test можно задать в виде acp:p/{1-3}@test или acp:p/{1,2,3}@test.
  • Профиль услуг (SS profile) — системный или доменный профиль услуг;
  • Активный (Active) — при установленном флаге абонент(ы) активен, иначе — не активен.

Нажмите кнопку "Ok" для добавления абонента(ов) в систему либо "Отмена" ("Cancel") для выхода из диалогового окна без добавления абонента(ов) в систему.

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

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

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

Во вкладке "Основные" ("General") выполняется настройка основных параметров для абонента.

  • nai — идентификатор типа адреса, принимает значения: subscriberNumber, unknown, nationalNumber, internationNumber;
  • npi — индикатор плана нумерации, принимает значения: isdnTelephony, dataNumberingPlan, telexNumberingPlan;
  • ni — индикатор номера, принимает значения:
    • emergency — экстренные службы;
    • intercity — абоненты междугородной сети;
    • international — абоненты международной сети;
    • local — абоненты местной сети;
    • private — локальные абоненты АТС;
    • zone — абоненты зоновой сети;
  • screening — индикатор контроля номера вызывающего абонента, принимает значения: userProvidedNotVerified, userProvidedVerifiedAndPassed, userProvidedVerifiedAndFailed, networkProvided;
  • apri — индикатор ограничения предоставления номера вызывающего абонента: presentationAllowed, presentationRestricted, addressNotAvailable;
  • категория (сategory) — категория вызывающего абонента, принимает значения: unknownAtThisTime, operatorFrench, operatorEngish, operatorGerman, operatorRussian, operatorSpanish, reserved, ordinarySubscriber, subscriberWithPriority, dataCall, testCall, spare, payphone, category0, hotelsSubscriber, freeSubscriber, paidSubscriber, localSubscriber, localTaksofon, autoCallI, semiautoCallI, autoCallII, semiautoCallII, autoCallIII, semiautoCallIII, autoCallIV, semiautoCallIV;
  • статус (active) — состояние абонента, принимает значения:
    • true — активен;
    • false — не активен;
  • cdr группа (cdr group) — имя CDR-группы (используется для группировки cdr-записей);
  • тип доступа (access type) — тип доступа для абонента (долговременные ограничения, которые вводятся при подключении абонента);
  • режим (regime) — режим обслуживания для абонента (временные ограничения);
  • группа доступа (access group) — имя группы доступа;
  • отображаемое имя (display name) — отображаемое имя на дисплее для абонента;
  • support encoding — тип кодировки, используемый для отображения имени абонента;
  • почта (email) — электронная почта для абонента;
  • джаббер идентификатор (jabber id) — идентификационный номер Jabber для абонента;
  • PIN-код — PIN-код для управления услугами с телефонного аппарата абонента;
  • media-profile — выбранный на домене медиа-профиль для входящей связи, по умолчанию устанавливается профиль default;
  • media-profile-outgouing — выбранный на домене медиа-профиль для исходящей связи связи, по умолчанию устанавливается значение undefined. При значении undefined для исходящей связи применяется тот же профиль, что и для входящей связи;
  • тип терминала (terminal type) — basic/smart;
  • профиль (profile) — профиль, назначаемый абоненту. Настройка профилей выполняется в приложении "Профили алиасов"("Alias profiles") в каталоге "named profiles";
  • расположение (placement) — территориальное расположение номера;
  • Язык — языковая локаль абонента.
    • Русский
    • Английский
    • Немецкий
    • Испанский
    • Французский

Для обновления информации нажмите кнопку "Обновить" ("Refresh").
Для сохранения изменений в системе нажмите кнопку "Сохранить" ("Save").
Для отмены изменений нажмите кнопку "Отмена" ("Canсel").

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

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

Для удаления абонента в таблице абонентов установите флаг(и) напротив удаляемого(ых) абонента(ов) и нажмите кнопку "Удалить" ("Delete"). Подтвердите действие нажатием кнопки "Да".

Настройка параметров кластера протокол-адаптера 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> —значение свойства.

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