Назначение

IP-телефонные аппараты требуют настройки перед использованием. Для телефонных аппаратов производители выпускают обновления программного обеспечения, исправляющие ошибки и привносящие новый функционал. Настройка и обновление телефонных аппаратов может быть крайне трудозатратна, если выполняется вручную. Для облегчения процесса Eltex предлагает Cистему автоматического конфигурирования AutoProvision.

Cистема AutoProvision предназначена для централизованного конфигурирования телефонных аппаратов с автоматической выгрузкой конфигурации и обновлений программного обеспечения (прошивки) на телефонный аппарат.

Требования к аппаратному обеспечению

AutoProvision устанавливается на физический или виртуальный сервер с операционной системой Linux. 

Для работы AutoProvision необходим сервер DHCP, который будет выдавать телефонным аппаратам требуемые DHCP-опции в зависимости от модели.

Принцип работы

Схема взаимодействия телефонных аппаратов и системы Autoprovision при автоконфигурировании телефонных аппаратов приведена на рисунке 1. Осуществляется три типа сетевого взаимодействия:

  1. «Интеграция». Autoprovision запрашивает с IP АТС ECSS-10 Softswitch данные о имеющихся аккаунтах и в ответ получает список аккаунтов и их параметры. Данная процедура нужна при конфигурировании системы и потом только при изменении аккаунтов на ECSS-10 Softswitch.
  2. «Получение сетевых параметров». Телефонный аппарат при включении или по истечении срока аренды IP-адреса обращается к DHCP-серверу1. DHCP-сервер в ответ отправляет IP-адрес, маску сети, шлюз по умолчанию и DHCP-опции для подключения к серверу автоконфигурирования. 
  3. «Получение конфигурации и/или обновления прошивки». Телефон в соответствии со своими настройками автоматического обновления конфигурации обращается к серверу Autoprovision. Сервер в ответ отправляет конфигурацию и файлы обновления ПО. Сервер может не отправлять обновление ПО, конфигурацию, или и то и другое в зависимости от настроек для данного телефонного аппарата.


Рисунок 1. Схема сетевого взаимодействия

1 Процесс получения IP-адреса по протоколу DHCP несколько сложнее. В рамках текущего документа можно абстрагироваться до простого «обращается к DHCP-серверу».

Схема включения

В текущей версии Autoprovision (2.10.0) работает с одним сетевым интерфейсом и для управления и для связи с ТА и для связи с ECSS-10 Softswitch.

Сервер Autoprovision подключается к сервису Mediator IP АТС ECSS-10 Softswitch на порт 9999 для выполнения Интеграции (получения списка и параметров абонентов).

Администратор системы управляет сервером по протоколу HTTPS, порт 443.

Телефонные аппараты, в зависимости от модели, общаются с сервером Autoprovision по протоколам HTTP, HTTPS, TFTP. Порты 80, 443, 69 соответственно.

Рекомендуется настраивать межсетевые экраны в соответствии с этими требованиями


Рисунок 2. Принципиальная схема сети.



Порядок использования

  1. Установить AuP.
  2. Настроить и запустить интеграцию. Убедиться, что интеграция завершилась успешно.
  3. Настроить «Граф конфигурационных параметров».
  4. Настроить DHCP-сервер на выдачу нужных опций.
  5. Телефоны, по мере обращения к DHCP-серверу, будут появляться в разделе «Устройства».
  6. Связать устройства с аккаунтами.
  7. Убедиться, что телефоны получают конфигурацию.

Установка Autoprovision

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

Установку производить согласно инструкции.

Общая настройка сервиса Autoprovision

Метод обслуживания по умолчанию

Сервис Autoprovision, в зависимости от настройки, может доставлять на телефоны конфигурацию, прошивку, конфигурацию и прошивку либо не обслуживать телефон. Рекомендуется после установки сервиса выбрать «Метод обслуживания по умолчанию», который будет применяться ко всем вновь созданным телефонам. После установки параметр «Метод обслуживания по умолчанию» установлен в статус «Не предоставлен«. Все вновь подключаемые телефоны по умолчанию не будут получать ни конфигурацию, ни прошивку. Необходимо будет выбрать иной метод для каждого телефона в отдельности.

Настройка интеграции

Настройку интеграции проводить согласно инструкции.

Если вы не знаете версию установленного ECSS-10 Softswitch можете воспользоваться этой инструкцией.

Создание конфигурации

Общий принцип создания конфигураций

Конфигурация телефона создается в разделе «Граф конфигурационных параметров». Граф конфигурационных параметров состоит из узлов (блоков), соединенных между собой в поток (цепочку). Может существовать несколько потоков. Каждый поток обрабатывается отдельно.

Поток обычно состоит из следующих узлов:

  1. Узел запроса данных. Обычно узел «Запрос данных о всех устройствах».
    В узле запроса в поток попадают параметры о имеющихся программных и аппаратных телефонах из раздела «Устройства». В зависимости от вида конкретного узла могут быть получены все («Запрос данных о всех устройствах») или только некоторые («Запрос данных о устройствах по тегу», «Запрос данных о устройствах по выбору» и т. д.) устройства. Для каждого телефона считываются множество параметров, таких как производитель, модель, владелец и т. д. Совокупность параметров называется контекстом устройства. Полученные параметры передаются последующим блокам, подключенным к выводу узла «Запрос данных...».
  2. Узел «роутинг» или «switch» («направить»). Эти узлы имеют один вход и несколько выходов. Задача узлов — направить дальнейшую обработку каждого телефонного аппарата в ветку потока, предназначенную для него. Это нужно для раздельной обработки телефонов разных производителей, разных моделей, расположенных в разных IP-подсетях и т. д. 
  3. Один из узлов настройки. «Узел настройки» или «Узел комплексных настроек». Эти узлы устанавливают параметры конфигурации телефонов.
  4. Последний в потоке узел «Создать конфигурацию». Данный узел, получая на вход изначальные параметры телефона и параметры от узлов настройки, создает конфигурацию для каждого телефона. Готовые конфигурации можно посмотреть в разделе «Устройства». Для правильной работы в каждом потоке должен быть только один узел «Создать конфигурацию», на вход которого будут подключены все ветки потока конфигурации.

    В целях отладки определенных веток потока возможно создание нескольких узлов «Создать конфигурацию». После отладки для более стабильной работы рекомендуется сводить весь поток в один узел «Создать конфигурацию».

  5. После узла «Создать конфигурацию» может располагаться узел «debug», предназначенный для отладки. Этот узел также может быть ответвлением в любом другом месте потока конфигурации, начиная с выхода узла запроса данных.
    Узел «debug» показывает текущий контекст устройства на участке потока. Он позволяет увидеть:

Наличие или отсутствие узлов «debug» не влияют на результирующую конфигурацию. Однако узлы «debug» могут замедлять работу системы. Рекомендуется убирать ненужные узлы «debug» после отладки цепочек.

К каждому выходу узла может быть подсоединено несколько следующих узлов.

К каждому входу узла может подсоединено несколько выходов предыдущих узлов.

Чтобы запустить поток (создать конфигурации телефонов) необходимо нажать на квадрат слева в блоке запроса данных.

Можно настроить узел запроса данных на запуск потока автоматически периодически или по расписанию. Это позволит автоматически создавать конфигурацию для новых телефонов в системе, но создаст дополнительную нагрузку на сервер и, в некоторых случаях, на телефоны.

Минимальная конфигурация

Согласно документации выполните создание конфигурации. При использовании только телефонов Eltex минимальная конфигурация будет следующей:

  1. Добавить блок «Запрос данных о всех устройствах».
  2. Добавить блок «Узел комплексных настроек». Выбрать «SIP». Настройки оставить по умолчанию.
  3. Добавить блок "Узел настроек". В настройках узла:
    1. Добавить параметр «Eltex.VP.Line.[X].SipDomain»;
    2. В поле «SIP-домен» вписать название вашего домена;
    3. Остальные настройки оставить по умолчанию.
  4. Добавить блок «Создать конфигурацию».
  5. Соединить блоки последовательно.
  6. «Развернуть» конфигурацию.
  7. При нажатии кнопки слева в блоке «Запрос данных о всех устройствах» произойдёт создание конфигураций для всех устройств.

Настройка DHCP-сервера

В случае, если на предприятии имеется DHCP-сервер, позволяющий отдавать расширенные DHCP-опции, то рекомендуется настраивать выдачу зон для IP-телефонов на этом сервере.

Если DHCP-сервера нет, или по каким-то причинам требуется отдельный DHCP-сервер для телефонии, можно установить любой DHCP-сервер с поддержкой расширенных опций. Например, можно использовать dnsmasq, настройка которого описана в документации. Следует помнить, что обслуживание одного broadcast-домена несколькими несогласованными DHCP-серверами будет приводить к проблемам IP-адресации в этом домене.

При настройке DHCP-сервера целесообразно, кроме опций, указанных в документации, передавать еще и опцию 42 — IP-адреса серверов NTP, для синхронизации времени.

При настройке DHCP-сервера желательно узнать, каково настроенное на нем время аренды IP-адресов для сетей с IP-телефонами. Если необходимо, чтобы телефоны сохраняли свои IP-адреса с течением времени, нужно указывать длительное время аренды. При высоком времени аренды телефоны могут очень долго не обращаться к DHCP-серверу и, следовательно, долго не получать обновленные параметры.

Если телефоны ещё не получали IP-адресов, то на время настройки рекомендуется уменьшить время аренды до порядка десятка минут. В дальнейшем при эксплуатации, чтобы снизить нагрузку на DHCP-сервер, увеличить время аренды до нескольких часов, суток или недель.

Включение телефонов

Телефоны по мере получения новых параметров от DHCP-сервера будут регистрироваться в системе Autoprovision. По мере регистрации будут телефоны появляться в разделе «Устройства». Чтобы увидеть вновь добавленные телефоны, необходимо нажать кнопку «Обновить список устройств» или перейти в раздел «Устройства» из другого раздела.

Назначение аккаунта

Каждому телефону необходимо назначить «Владельца устройства» согласно инструкции. Это необходимо, чтобы Граф конфигурационных параметров мог использовать данные SIP-аккаунта, назначенного на телефонный аппарат.

В разделе «Устройства» в списке телефонов в столбце «Метод обслуживания» указан один из возможных методов, по которому будет обслуживаться данный телефон. Если «Метод обслуживания» установлен в статус «Не предоставлен», то на телефон не будет передаваться ни конфигурация, ни обновление ПО. Для изменения метода обслуживания конкретного телефона нажмите на значок в соответствующем столбце.

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

Проверка получения конфигурации

Телефон при следующем обращении к серверу Autoprovision получит конфигурацию.

Убедиться, что телефон получил конфигурацию можно либо на экране телефона, либо через Web-интерфейс.

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

Устранение неполадок (Trouble shooting)

Описание решения проблем при установке приведены в документации.

Управление пользователями AuP осуществляется через сервис Keycloak. Административная страница сервиса находится по адресу https://<ip_aup>/auth/admin, где <ip_aup> — IP-адрес или DNS имя сервера AuP. Логин/пароль по умолчанию — admin/admin.