610 профессионалов IT в этом Telegram чате. “ы с нами?

Ќастройка EndPoint Manager в FreePBX

јвтоматическа€ настройка телефонов

ћерион Ќетворкс

11 минут чтени€

¬сем привет! ¬ сегодн€шней статье расскажем об одном из самых полезных, на наш взгл€д, коммерческих модулей FreePBX и продемонстрируем процесс его настройки. ќсобенно поможет данный модуль системным администраторам, которым часто приходитс€ подготавливать телефонные аппараты дл€ новых сотрудников, а также обслуживать и обновл€ть их. »так, встречайте - модуль EndPoint Manager! ≈го стоимость на момент написани€ статьи 17.01.18 составл€ет 149$ (8 418 рубл€), лицензи€ предоставл€етс€ на 25 лет. —огласитесь, в масштабах компании - это не така€ больша€ сумма, а врем€ ¬ашего админа Ц бесценно :)

 онечно, если ¬ы €вл€етесь счастливым обладателем телефонов от Sangoma, то благами модул€ EPM вы можете пользоватьс€ бесплатно :)


ќбзор

ћодуль EndPoint Manager позвол€ет организовать функционал auto-provisioning, когда телефонный аппарат нужно только подключить к сети, а все необходимые настройки он автоматически скачает с сервера, после чего сразу же будет готов к работе. ѕомимо телефонных аппаратов, с помощью данного модул€ можно также настраивать шлюзы, конференц-фоны, беспроводные трубки, дверные телефоны и пэйджинг устройства самых попул€рных производителей VoIP оборудовани€:

  • Aastra
  • Algo
  • AND
  • Audiocodes
  • Cisco
  • Cortelco
  • Cyberdata
  • Digium
  • Grandstream
  • HTek
  • Mitel
  • Mocet
  • Obihai
  • Panasonic
  • Phoenix Audio
  • Polycom
  • Sangoma
  • Snom
  • Uniden
  • Vtech
  • Xorcom
  • Yealink

ѕолный список конкретных поддерживаемых устройств можно найти на сайте разработчика: https://wiki.freepbx.org/display/FPG/EPM-Supported+Device

ќсновное предназначение EPM - это создание шаблонов (template) с необходимыми настройками, которые потом можно примен€ть на одном или группе аналогичных устройств, что сводит подготовку устройств к минимуму.

ќбщий механизм работы примерно такой - ѕосле создани€ шаблона с настройками дл€ определЄнной модели телефонного аппарата, администратор, с помощью модул€ EPM, прив€зывает данный шаблон к конкретному внутреннему номеру (extension) по MAC адресу данного устройства. ѕосле этого автоматически создаЄтс€ конфигурационный файл вида ’’’’.cfg, где ’’’’ Ц MAC адрес устройства, который, сервер FreePBX с установленным EPM, хранит на файловом хранилище.  огда телефонный аппарат подключаетс€ в сеть, то вместе с IP адресом, он получает по DHCP адреса сервера (option 66), на котором дл€ него создан файл конфигурации. ѕосле чего телефон обращаетс€ на данный сервер и скачивает готовую конфигурацию и, опционально, актуальную прошивку. “о есть, по сути, дл€ того чтобы ввести новый телефон в эксплуатацию, нам нужно только подключить его в сеть, узнать его MAC адрес и всЄ!

Ѕолее подробно про процесс auto-provisioning и option 66 можно почитать в нашей статье

ћодуль имеет несколько подразделов, каждый из которых имеет своЄ предназначение, рассмотрим их:

  • Global Settings - в данном разделе настраиваютс€ общие параметры модул€, такие как внутренн€€ и внешн€€ адресаци€, порты, административные и пользовательские пароли дл€ устройств
  • Extension Mapping - данный раздел предназначен дл€ настройки соответстви€ внутреннего номера, настроенного на IP-ј“— и назначени€ определЄнного шаблона конфигурации. ѕрив€зка происходит по MAC адресу аппарата
  • Brands - данный раздел содержит шаблоны конфигураций дл€ определЄнного бренда и моделей VoIP оборудовани€. Ѕрендов может быть несколько, они добавл€ютс€ в разделе Add Brand. ѕо умолчанию тут только шаблон дл€ телефонов Sangoma.
  • Add Brand - здесь ¬ы можете добавить новый бренд, дл€ которого в дальнейшем будете создавать шаблоны конфигураций
  • Image Management - данный раздел предназначен дл€ управлени€ фоновым изображением на телефонном аппарате, если конечно он его поддерживает
Image Management в FreePBX 13 в EPM
  • Ringtone Management - данный раздел предназначен дл€ управлени€ рингтонами звонка на телефонном аппарате;
Ringtone Management в FreePBX в EPM
  • Basefile Edit - с помощью данного раздела можно измен€ть дефолтные параметры самих шаблонов дл€ любой модели телефона.  ак правило, это подразумевает редактирование XML файла конфигурации.
  • Custom Extensions - данный раздел предназначен дл€ настройки телефонных аппаратов, которые не зарегистрированы на вашей ј“—. ѕоскольку модуль EPM по умолчанию видит только пул внутренних номеров локальной ј“—, то дл€ настройки удалЄнных устройств, например с другой ј“—, необходимо сначала объ€вить их в этом разделе.
Custom Extensions EndPoint Manager
  • Firmware Management - данный раздел позвол€ет управл€ть прошивками устройств всех брендов. ѕомимо этого, можно управл€ть их верси€ми и назначать определЄнному шаблону ту или иную версию прошивки.
  • Network Scan - с помощью данной утилиты можно просканировать сеть и получить список MAC адресов устройств, которым ещЄ не назначены шаблоны конфигураций и сразу же их назначить через раздел Extension Mapping. —тоит отметить, что поскольку MAC адреса не маршрутизируютс€, то определить можно только устройства, наход€щиес€ в одной сети с IP-ј“—, поэтому здесь нужно указывать локальную сеть. “о есть, например, если IP адрес ¬ашей ј“— Ц 192.168.11.64/24, то ¬ы сможете успешно просканировать только устройства в сети 192.168.11.0/24.
Network Scan в EndPoint Manager

Ќастройка

–ассмотрим подробнее каждый из разделов, описанных выше. ѕосле установки, модуль по€вл€етс€ в разделе Settings.

Ќастройка модул€ EPM в FreePBX

ƒоступ к разделам модул€ осуществл€етс€ по нажатию на кнопку в правом углу:

–аздел настроек в EPM FreePBX

ѕервое, с чего необходимо начать - это глобальные настройки Global Settings.

Global Settings
  • Internal IP - здесь указываем локальный адрес нашей IP- ј“—. ћожно ввести слово auto, тогда локальный IP адрес будет определЄн автоматически.
  • External IP - в этом поле указываем внешний адрес нашей IP-ј“— или валидный FQDN. Ёто поле нужно только если у вас есть телефоны, которые подключаютс€ из вне. ћожно ввести слово auto, тогда внешний IP адрес будет определЄн автоматически, чтобы не использовать данное поле Ц введите none
  • Ports - данна€ секци€ отображает номера портов, которые настроены дл€ различных сервисов - Web Server - порт дл€ доступа к вэб-интерфейсу модул€, HTTP Provisioning - порт дл€ auto-provisioning по протоколу HTTP, TFTP Provisioning - порт дл€ auto-provisioning по протоколу TFTP, RESTful Apps - порт использующийс€ дл€ интеграции Phone Apps с IP-ј“—. Ќомера данных портов настраиваютс€ в модуле System Admin, настроить через EPM их нельз€.
  • Phone Admin Password - здесь можно административный пароль дл€ доступа к вэб-интерфейсу телефонных аппаратов. ѕароль будет одинаковым дл€ всех устройств под управлением модул€ EPM
  • Phone User Password - некоторые телефоны имеют разные уровни доступа к вэб-интерфейсу управлени€. ¬ данном поле можно настроить пароль дл€ пользовательского уровн€.
  • ReSync Time - врем€, по истечению которого телефон будет заного запрашивать конфигурацию с сервера, чтобы актуализировать еЄ. ѕо умолчанию это день Ц 86400 секунд
  • XML-API (RestAPI) Default Login - разрешает доступ к Phone Apps, если это поддерживаетс€ телефоном.
  • Extension Mapping IP Address и Phone Status - здесь настраиваетс€ как будет отображатьс€ статус телефонного аппарата в разделе Extension Mapping. ћожно показывать IP адрес телефона и врем€ последнего pingТа данного аппарата

ѕо завершению настроек необходимо нажать Save Global

“еперь, когда у нас есть глобальные настройки, можно добавл€ть и настраивать шаблоны дл€ любых брендов телефонных аппаратов, которые будут подключатьс€ к нашей IP-ј“—.

ƒл€ этого открываем меню и кликаем Add Brand, перед нами откроетс€ список поддерживаемых производителей, выберем Cisco. ѕосле этого, перед нами откроетс€ окно с параметрами настроек нового шаблона дл€ устройств Cisco:

”правление брендами в EPM FreePBX
¬нимание! ƒальнейшие параметры могут отличатьс€ в зависимости от выбранного в предыдущем шаге производител€. Ќиже будет приведЄн пример дл€ Cisco
Ќастройка шаблона Cisco в EPM
  • Template Name - им€ шаблона. –екомендуем указывать здесь модели, дл€ которых создаЄтс€ шаблон, а также дл€ каких телефонных аппаратов он предназначен Ц локальных или удаленных. Ќапример, в нашем случае шаблон будет дл€ локальных телефонов Cisco SPA 504G
  • Destination Address - адрес IP-ј“—, на который телефон будет обращатьс€ дл€ того, чтобы зарегистрироватьс€. «начени€ Internal и External берутс€ из Global Settings или же вы можете указать адрес вручную нажав Custom
  • Provision Server Protocol - протокол, который будут использовать телефоны дл€ получени€ своих конфигурационных файлов - TFTP или HTTP
  • Provision Server Address адрес provisioning сервера, на который телефон будет обращатьс€ дл€ получени€ конфигурации. «начени€ Internal и External берутс€ из Global Settings или же вы можете указать адрес вручную нажав Custom. ¬ нашем случае - Destination Address и Provision Address будут совпадать и €вл€тьс€ адресом IP-ј“— 192.168.11.64, это наиболее распространЄнный случай.
  • Time Zone - временна€ зона
  • Primary Time Server и Time Server 2 - сервера синхронизации времени NTP
  • Daylight Savings - включает переход на летнее врем€
  • Background Image - фоновое изображение дл€ телефонного аппарата. «агружаетс€ в разделе Image Management
  • Line Label - позвол€ет вывести идентификатор линии на LCD экран телефона (если он есть):
    • Extension - выводит внутренний номер, например У7007Ф
    • Name - выводит им€ внутреннего номера, например УAlex DobronravovФ
    • Name-Extension - выводит им€ и номер, например УAlex Dobronravov 7007Ф
    ќбратите внимание, что в зависимости от используемого телефона количество отображаемых символов может быть ограничено
  • Dial Pattern - здесь можно помен€ть стандартные шаблоны набора номера, используемые телефоном. —имволы в данном поле будут зависеть от выбранного производител€
  • Firmware Version - здесь мы можем настроить загрузку прошивок дл€ моделей телефонных аппаратов, дл€ которых создаЄтс€ шаблон. ѕри нажатии на кнопку Firmware Management мы попадаем в соответствующий раздел, в котором уже доступны все прошивки дл€ телефонов Cisco (в том числе и дл€ нужного нам SPA 504G), выберем самый актуальный пак. ¬ каждом паке содержатс€ прошивки дл€ разных моделей телефонов. »з пака загружаютс€ только прошивки дл€ моделей, которые выбраны в шаблоне. ћожно указать разные версии прошивок, дл€ этого нужно выбрать разные паки в Firmware Slot 1 и с
ѕрошивка дл€ Cisco в EPM в FreePBX

ѕосле чего в настройках шаблона в поле Firmware Version мы можем выбрать нужный слот, чтобы загрузить его на все телефонные аппараты, которые будут выбраны в данном шаблоне.

Firmware Version настройка
  • Available Phones - в данном списке находим нужную нам модель телефонного аппарата (в нашем случае Ц SPA 504G) и кликаем на неЄ. ѕосле чего перед нами открываетс€ окно с настройками кнопок телефонного аппарата. ƒоступные настройки будут зависеть от выбранной модели
Available Phones EndPoint Manager —охранение настроек в FreePBX EPM

¬ данном случае мы настроили на первой кнопке телефона SPA 504G отображение линии, а на второй BLF по номеру 3032. ќтметим, что подобна€ конфигураци€ будет присвоена всем телефонам, которым мы назначим данный шаблон. ≈сли их много, то некоторым, например, может не понадобитьс€ BLF одного и того же номера, учитывайте это. ¬ дальнейшем, настройки кнопок можно будет изменить дл€ каждого телефона индивидуально.

ќтметим также, что можно создать один шаблон дл€ нескольких моделей телефонов (а также дл€ панелей расширени€ Expansion Module и других устройств, например, в случае Cisco - FXS), дл€ этого просто отметьте и настройте необходимые модели:

Expansion Module в EPM

ѕо завершению настройки шаблона доступно несколько опций сохранени€ - Save - просто сохранит новый шаблон, Save and Rebuild Config(s) - сохранит конфигурацию подготовит еЄ к загрузке на телефоны, которые используют данный конфиг при следующем цикле синхронизации, Save, Rebuild and Update Phones - данный вариант перезапишет новую конфигурацию, подготовит еЄ к загрузке на телефоны, которым назначен данный шаблон и отправ€т еЄ на эти телефоны, что может вызвать перезагрузку телефонов. —тоит отметить, что пока никаким телефонам не назначен данный шаблон Ц при использовании опций Save and Rebuild Config(s) и Save, Rebuild and Update Phones ничего не произойдЄт, опции действуют только когда в разделе Extension Mapping есть активные устройства.

ƒл€ более тонкой настройки параметров, которые невозможно настроить стандартными средствами шаблона, используйте функционал Basefile Edit. ќн предназначен дл€ опытных пользователей и позвол€ет править конфигурацию шаблона дл€ определЄнной модели на уровне еЄ конфигурационного файла, как правило Ц формата XML

Basefile Edit в EPM настройка XML
«авершение настройки и назначение настроенного шаблона телефонным аппаратам

“еперь, когда мы закончили с настройкой шаблона, самое врем€ прив€зать его к внутреннему номеру и к конкретному телефонному аппарату. ƒл€ этого есть 2 способа:

ѕредварительно убедитесь, что настраиваемые телефонные аппараты подключены в сеть и получают адреса по DHCP. “акже, на DHCP сервере должна быть настроена опци€ 66 (option 66), сообщающа€ телефону адрес provisioning сервера, на котором хранитс€ конфигураци€.
  • «аходим в раздел Extension Mapping и нажимаем Add Extension. ¬ыбираем внутренний номер, из списка зарегистрированных на нашей IP-ј“—, которому хотим назначить шаблон (тут также можно настроить Custom Extension, о котором говорилось выше), далее выбираем учЄтную запись SIP, в нашем случае - Account 1. ¬о втором столбце выбираем бренд - Cisco и ниже прописываем MAC адрес настраиваемого телефона. ¬ последнем столбце выбираем шаблон, который мы только что настроили (в нашем случае spa504g_internal) и модель телефона (в нашем случае Cisco SPA 504G)
Extension Mapping в EPM

ѕосле этого выбираем способ сохранени€ конфигурации и нажимаем Use Selected. ћы выбрали Save, Rebuild and Update Phones, чтобы конфиг сразу же отправилс€ на телефон.

  • «аходим в модуль Extensions ищем нужный внутренний номер и открываем вкладку Other. ¬ разделе Endpoint заполн€ем необходимые пол€ и нажимаем Submit
Ќастройка номера дл€ EndPoint Manager

¬ обоих случа€х, после данных манипул€ций, создаЄтс€ конфигурационный файл XXXXYYYYZZZZ.cfg , где XXXXYYYYZZZZ Ц ћј— адрес телефонного аппарата и хранитс€ в файловом хранилище сервера.  огда телефон подключитс€ в сеть, то от DHCP сервера он получит IP адрес, а также через опцию 66 Ц адрес provisioning сервера, в нашем случае Ц это TFTP сервер 192.168.11.64. “елефонный аппарат обратитс€ на TFTP сервер и скачает от туда свой конфигурационный файл XXXXYYYYZZZZ.cfg. “аким образом, телефон будет сразу готов к работе.


ѕолезна ли ¬ам эта стать€?


Ёти статьи могут быть вам интересны: