Заставляем работать BLF на телефоне Cisco 9951 с Elastix 2.4

Есть у нас пара телефонов Cisco 9951. А один ко всему ещё и с консолью CKEM-C. Штука это довольно дорогая и нужно было прикрутить всё это к офисной IP-АТС Elastix 2.4. И прикрутить не просто чтобы звонки проходили, но и чтобы кнопки BLF работали как надо.

Задача не из простых, но вполне решаемая. Итак, поехали.

Есть у телефонов Cisco одна особенность, которая не позволяет корректно функционировать BLF в связке с чем либо, кроме родного Cisco Call Manager. Даже родная SIP-прошивка не спасает ситуацию. Это конечно же лечится. Лечится патчем исходных кодов Asterisk, чем мы и займёмся в первую очередь.

ВАЖНОЕ ЗАМЕЧАНИЕ! Я крайне не рекомендую делать всё нижеописанное на рабочей (боевой) системе. Хотя в моём случае данная методика отлично работает на боевой системе, лучшим выбором будет предварительно проверить работоспособность данного решения и разобраться в нём, смоделировав его, например, на виртуальной машине. И не забывайте про резервные копии конфигурации Elastix перед каждым серьёзным её изменением!

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

В первую очередь нам потребуется пересобрать Asterisk (в Elastix 2.4 используется ветка 1.8).

Для этого делаем следующее:

1. Останавливаем сервисы и убираем старые версии модулей для избежания конфликтов после перекомпиляции:

service asterisk stop
service dahdi stop

для 32-битных систем

mv /usr/lib/asterisk/modules/ /usr/lib/asterisk/modules_bak/

для 64-битных систем

mv /usr/lib64/asterisk/modules/ /usr/lib64/asterisk/modules_bak/

2. Ставим все необходимые зависимости:

yum -y install patch ncurses-devel libxml2-devel openssl-devel mysql-devel sqlite-devel sqlite* e2fsprogs-devel  keyutils-libs-devel krb5-devel libogg libselinux-devel libsepol-devel libxml2-devel libtiff-devel gmp php-pear php php-gd php-mysql php-pdo kernel-devel ncurses-devel audiofile-devel libogg-devel openssl-devel zlib-devel perl-DateManip sox gcc-c++ make gnutls-devel kernel-devel libxml2-devel ncurses-devel subversion doxygen texinfo curl-devel net-snmp-devel neon-devel uuid-devel libuuid-devel sqlite-devel sqlite git gsm-devel

3. Получаем и распаковываем исходники DAHDI, libpri и Asterisk:

cd /usr/src
wget http://downloads.asterisk.org/pub/telephony/dahdi-linux-complete/dahdi-linux-complete-current.tar.gz
tar xzvf dahdi-linux-complete-current.tar.gz
wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-1.4-current.tar.gz
tar xzvf libpri-1.4-current.tar.gz
wget http://downloads.asterisk.org/pub/telephony/asterisk/old-releases/asterisk-1.8.31.1.tar.gz
tar xzvf asterisk-1.8.31.1.tar.gz

4. Получаем патч для работы Cisco BLF на Asterisk и применяем его:

cd asterisk-*
wget https://issues.asterisk.org/jira/secure/attachment/32739/cisco-blf-asterisk.1.8.0.patch
patch -p1 < cisco-blf-asterisk.1.8.0.patch
cd ..

5. Собираем DAHDI

cd dahdi-linux-*
make all
make install
make config
cd ..

6. Собираем libpri

cd libpri-*
make
make install
cd ..

7. Собираем Asterisk

для 32-битных систем

./configure

для 64-битных систем

./configure --libdir=/usr/lib64

выбираем необходимые модули: 

make menuconfig

Для того, чтобы после пререкомпиляции Asterisk в Elastix не пропал функционал CDR, требуется в разделе Add-ons включить модули res_config_mysql, app_mysql и cdr_mysql

Остальное можно оставить без изменений. Для выхода из меню нажимаем Esc и S для сохранения изменений. Теперь можно собирать Asterisk

make
make install

8. Запускаем DAHDI и Asterisk

service dahdi start
service asterisk start

или

amportal restart

Всё. На этом патчинг и перекомпиляция Asterisk закончены. Теперь Asterisk умеет отсылать правильные сообщения телефонам Cisco для корректной работы BLF на них. Но это ещё не всё.

Так как Cisco 9951 работает исключительно по TCP, нам нужно включить поддержку TCP в Asterisk. Для этого открываем WEB-интерфейс Elastix и идём в PBX -> PBX Configuration -> Unembedded FreePBX -> Вкладка Tools -> Asterisk SIP Settings.

В самом низу страницы в Other SIP Settings добавляем:

tcpenable=yes
transport=tcp,udp

Сохраняем и применяем изменения.

Теперь нужно добавить несколько дополнительных параметров для экстеншена, на котором будет установлен телефон Cisco 9951 (пусть это будет номер 248). Для этого уже в командной строке редактируем конфигурационный файл:

vim /etc/asterisk/sip_custom_post.conf

и добавляем в этот файл следующее:

 [248](+)  
 mailbox=248  
 ciscounified=yes  
 dndbusy=yes  
 subscribe=215  
 subscribe=217  
 subscribe=201  
 subscribe=218  
 subscribe=209  
 subscribe=212  
 subscribe=247  
 subscribe=239  
 subscribe=208  
 subscribe=225  
 subscribe=219  
 subscribe=240  
 subscribe=295  
 subscribe=279  
 subscribe=220  
 subscribe=235  
 subscribe=250  
 subscribe=230  
 subscribe=293  
 subscribe=296  

Для чего всё это нужно:

mailbox=248 - требуется для корректной работы индикатора MWI на телефоне

ciscounified=yes - говорит Asterisk'у о том, что данному пиру при формировании уведомлений о состоянии линий следует отправлять сообщения в формате Cisco (pidf+xml).

subscribe= - указывается для каждого внутреннего номера, за которым будет "следить" наш Cisco 9951 (в моём случае телефон укомплектован 18-кнопочной консолью CKEM-C, поэтому так много подписок)

После внесения этих изменений даём в командной строке bash команду

asterisk -rx "sip reload"

и смело переходим к настройке телефона.

Конфигурация IP-телефона Cisco 9951 с консолью CKEM-C

Для того, чтобы телефон заработал, нам потребуется:

• Работающий TFTP-сервер (есть в Elastix)
• Работающий DHCP-сервер (желательно, но не обязательно. Уже есть в Elastix)
• Комплект файлов с прошивкой
• Русская локаль (по желанию)
• Конфигурационные XML-файлы

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

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

Что есть в моём комплекте:

• Прошивка SIP версии 9.4.1.9
• Файлы русской локализации (интерфейс, g4-tones.xml)
• Пример конфига SEP_MAC_.xml (для телефона с консолью CKEM-C)
• Обои для рабочего стола телефона
• Стандартные рингтоны
• Каталог xmlservices, содержащий примеры адресной книги и других сервисов для IP-телефонов Cisco.

В приложенном примере конфига требуется заменить строку ELASTIX_IP_ADDRESS на IP-адрес вашего сервера Elastix. И конечно же нужно переименовать сам файл, заменив _MAC_ на реальный MAC-адрес вашего телефона (в верхнем регистре, без каких-либо разделителей). В конфиге включена поддержка HD-кодека G.722 (не забудьте включить его поддержку в вашем дистрибутиве Elastix).

Чтобы упростить задачу подключения телефона, нам потребуется активировать встроенный DHCP-сервер Elastix. Для этого идём в Система -> Network -> DHCP Server. Вводим там все настройки и нажимаем кнопку Enable DHCP. После выполнения этой операции, если IP-телефон находится в одной сети с сервером Elastix, он автоматически получит все сетевые настройки, включая адрес TFTP-сервера, после чего сам скачает и установит нужные файлы из вышеприведённого комплекта, полностью самостоятельно наделив себя работоспособным состоянием :)

Каталог xmlservices требуется поместить в /var/www/html, но предварительно нужно добавить его в исключения SSL, т.к. IP-телефоны Cisco не умеют работать по https. Для этого нужно отредактировать файл /etc/httpd/conf.d/elastix.conf и после RewriteEngine On добавить следующее:

RewriteCond %{HTTPS} off
    RewriteCond %{REQUEST_URI} !(/xmlservices/*)

далее сохраняем файл и перезапускаем apache

service httpd restart

В каталоге xmlservices есть приложение-информер Гисметео. не забудьте поправить код города в строке

$source = 'http://informer.gismeteo.ru/xml/_код_вашего_города_.xml';

в файле gismeteo_rus.php

Теперь вкратце опишу основные элементы XML-конфига.

Настройка часового пояса, даты/времени и формата их отображения:

<dateTimeSetting>
<dateTemplate>D.M.Y</dateTemplate>
<timeZone>Russian Standard/Daylight Time</timeZone>
<ntps>
<ntp>
<name>ELASTIX_IP_ADDRESS</name>
<ntpMode>Unicast</ntpMode>
</ntp>
</ntps>
</dateTimeSetting>

Основной параметр, в котором указывается IP-адрес сервера Elastix. В дельнейшем на него идёт ссылка через USECALLMANAGER:

<processNodeName>ELASTIX_IP_ADDRESS</processNodeName>

Ссылка на файл с прошивкой:

<loadInformation>sip9951.9-4-1-9</loadInformation>

Описание подключённого модуля консоли CKEM-C:

<addOnModules>
<addOnModule uuid="" idx="1">
<deviceType>CKEM</deviceType>
<deviceLine>36</deviceLine>
<loadInformation></loadInformation>
<phoneTemplateId></phoneTemplateId>
</addOnModule>
</addOnModules>

Описание учётной записи SIP:

<line button="1" lineIndex="1">
<featureID>9</featureID>
<featureLabel>Внутр. 248</featureLabel>
<name>248</name>
<displayName>248</displayName>
<contact></contact>
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<autoAnswer>
<autoAnswerEnabled>2</autoAnswerEnabled>
</autoAnswer>
<callWaiting>3</callWaiting>
<authName>248</authName>
<authPassword>vEry_str0ng_pAssW0rD</authPassword>
<sharedLine>false</sharedLine>
<messageWaitingLampPolicy>3</messageWaitingLampPolicy>
<messageWaitingAMWI>1</messageWaitingAMWI>
<messagesNumber>*97</messagesNumber>
<ringSettingIdle>4</ringSettingIdle>
<ringSettingActive>5</ringSettingActive>
<forwardCallInfoDisplay>
<callerName>true</callerName>
<callerNumber>false</callerNumber>
<redirectedNumber>false</redirectedNumber>
<dialedNumber>true</dialedNumber>
</forwardCallInfoDisplay>
<maxNumCalls>4</maxNumCalls>
<busyTrigger>2</busyTrigger>
</line>

Важные параметры здесь опишу подробнее:
<featureID>9</featureID> - говорит телефону, что функция данной кнопки - прямой доступ к учётной записи SIP
<featureLabel>Внутр. 248</featureLabel> - То, что будет написано на дисплее под кнопкой с учётной записью
<name>248</name> - номер экстеншена
<displayName>248</displayName>  - номер экстеншена
<authName>248</authName>  - номер экстеншена
<authPassword>vEry_str0ng_pAssW0rD</authPassword> - пароль учётной записи
<messagesNumber>*97</messagesNumber> - номер голосовой почты на сервере (будет под аппаратной кнопкой на IP-телефоне)

Описание кнопки BLF:

<line  button="4">
  <featureID>21</featureID>
    <featureLabel>Директор</featureLabel>
      <speedDialNumber>215</speedDialNumber>
        <featureOptionMask>1</featureOptionMask>
        </line>

Описание дополнительных сервисов телефона, таких как адресная книга или различные информационные сервисы:

<phoneService type="1" category="0">
    <name>Сотрудники офиса</name>
    <url>http://ELASTIX_IP_ADDRESS/xmlservices/directory_9951.xml</url>
    <vendor></vendor>
    <version></version>
</phoneService>

Глубже разобраться, что за что отвечает в XML файле конфигурации поможет вот этот ресурс, полностью посвящённый всем тонкостям работы IP-телефонов Cisco с Asterisk.

После того как файл конфигурации сформирован, перезапускаем телефон и радуемся его почти полноценной работе с Asterisk :)
Почему "почти" полноценной:

• не все функции работают без допиливания на стороне Asterisk. Некоторые вообще будут работать только с CUCM.
• Кнопки отображают только три состояния отслеживаемой линии "Idle", "Rinding" и "Busy". Причём в состоянии Idle нет зелёной индикации на клавише BLF. Мне это победить пока не удалось.
• Возможно, есть ещё скрытые глюки, которые я пока не выявил.

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

Возможно, вас заинтересует и процесс настройки IP-телефона Cisco CP-7911G