IVA ДОКУМЕНТАЦИЯ
ОБНОВЛЕНИЯ

Автоконфигурирование

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

Администратор может добавлять и изменять шаблоны конфигурационных файлов, в том числе задавать параметры, для которых нет отдельных полей в интерфейсе IVA CS, например адрес LDAP-сервера, используемого телефоном. Шаблон может содержать постоянные значения и переменные для подстановки учетных данных SIP-аккаунтов, адресов SIP-серверов и других параметров устройства.

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

Сервис автонастройки Autoprovision формирует конфигурационные файлы для телефонных аппаратов

При наличии соответствующих прав доступа раздел содержит три вкладки:

  • Устройства — экземпляры телефонных аппаратов с уникальными MAC-адресами, SIP-аккаунтами, DSS-кнопками и пользовательскими файлами

  • Модели телефонов — встроенные и пользовательские модели, правила кодирования DSS-кнопок и файлы модели

  • Файлы автоконфигурирования — общий список встроенных и пользовательских файлов

Схема автоконфигурирования

Права для работы с автоконфигурированием

Доступ к устройствам, моделям, DSS-кнопкам и файлам настраивается отдельно в роли пользователя. Для проверки необходимо открыть раздел Права доступа → вкладку Роли → назначенную пользователю роль и раскрыть нужное право в секции Права.

Право Что определяет

Устройства

Доступ к записям телефонных аппаратов и их основным параметрам

Модель телефона

Просмотр моделей; добавление, изменение и удаление пользовательских моделей при наличии права записи

Настройки DSS кнопок

Просмотр и настройку DSS-кнопок в карточке устройства

Файлы автоконфигурирования

Доступ к файлам модели и устройства, их содержимому и операциям с пользовательскими файлами

Для работы с объектом необходимо проверить доступные уровни Просмотр, Чтение и Запись, включая уровни Чтение (домен) и Запись (домен), если операция относится к объектам домена. Для устройств в форме роли доступны Чтение (домен), Запись (домен) и Просмотр.

При отсутствии прав на файлы вкладка Файлы автоконфигурирования может быть скрыта, а в секции Список файлов карточки модели или устройства отображается Отсутствуют права. В этом случае необходимо проверить право Файлы автоконфигурирования. Доступ к карточке устройства сам по себе не предоставляет доступ к его файлам.

Если модель открывается, но поля недоступны для изменения и кнопка Добавить отсутствует в списке моделей, необходимо проверить право записи для Модель телефона. Встроенные модели доступны только для просмотра независимо от прав записи.

Фактический доступ определяется настройками назначенной роли. Для роли с названием root admin также необходимо проверить, включены ли нужные права

Перед началом настройки

  1. убедиться, что системный сервис swl-provision запущен. Статус сервисов IVA CS можно проверить командой:

    sudo ivacs-ctl status

  2. настроить на DHCP-сервере адрес сервера автоконфигурирования, либо указать этот адрес вручную в интерфейсе телефона. IVA CS не изменяет конфигурацию внешнего DHCP-сервера автоматически

  3. убедиться, что телефон может обратиться к серверу автоконфигурирования по используемому в сети протоколу. Сервис может обрабатывать запросы файлов по TFTP, HTTP или HTTPS. Поддерживаемый протокол и формат адреса зависят от модели и прошивки телефона

  4. узнать точное имя файла, которое запрашивает телефон. В имени часто содержится MAC-адрес устройства, например SEP001122334455.cnf.xml

MAC-адрес устройства в IVA CS задается двенадцатью шестнадцатеричными символами [0-9A-Fa-f] без разделителей, двоеточий и дефисов: 805ec060d377.

В имени файла модели используется макрос $(MAC). Например, для Cisco имя SEP$(MAC).cnf.xml при MAC-адресе 001122334455 соответствует запросу SEP001122334455.cnf.xml. Другие варианты записи макроса не поддерживаются

Выбор файла настройки

Файлы различаются по назначению:

  • Файл модели — шаблон конфигурации для устройств выбранной модели. При запросе в него подставляются данные конкретного устройства

  • Константный файл модели — файл, связанный с моделью, с постоянным именем и содержимым, например AppDialRules.xml. Содержимое возвращается без обработки шаблона

  • Константный файл устройства — файл, связанный с конкретной записью устройства, с постоянным именем и содержимым

Встроенные файлы поставляются с IVA CS и доступны для просмотра и выгрузки. Пользовательские файлы добавляет администратор; их содержимое можно изменять. Если требуется переопределить встроенный константный файл, пользовательскому файлу задается такое же имя. Подробные параметры приведены в подразделе Файлы автоконфигурирования.

При запросе файла настройки сервис выполняет поиск в следующем порядке:

  1. ищет полное совпадение имени среди константных файлов модели и константных файлов устройства. Если пользовательский файл и встроенный файл имеют одинаковое имя, возвращается пользовательский файл

  2. если константный файл не найден, извлекает из запрошенного имени последовательность из 12 символов и ищет запись с таким MAC-адресом среди устройств, созданных в разделе Автоконфигурирование на вкладке Устройства

  3. определяет модель найденного устройства и проверяет привязанные к ней файлы типа Файл модели

  4. подставляет MAC-адрес вместо $(MAC). Совпадение с запрошенным именем должно быть полным

  5. обрабатывает шаблон найденного файла данными устройства и возвращает результат телефону

Если устройство, модель или подходящий файл не найдены, телефон получает ответ 404.

Пример поиска файла Cisco

Телефон запрашивает SEP001122334455.cnf.xml. IVA CS находит в списке Устройства заранее созданную запись с MAC-адресом 001122334455, определяет назначенную ей модель и сопоставляет запрос с файлом этой модели SEP$(MAC).cnf.xml

Устройства

Во вкладке Устройства создаются экземпляры телефонов и задаются их персональные параметры.

Чтобы открыть список устройств, необходимо перейти в раздел Автоконфигурирование на вкладку Устройства.

Список устройств

Поиск устройства

В списке устройств отображаются Название и MAC-адрес. Чтобы найти запись по одному из этих полей, необходимо:

  1. нажать кнопку Настроить фильтр по полям

  2. в окне Фильтр по полям выбрать в поле Поле значение Название или MAC-адрес

  3. в поле Тип соответствия выбрать Содержит для поиска по части значения или Равно для точного совпадения

  4. заполнить поле Значение и нажать кнопку Сохранить

Для MAC-адреса необходимо использовать запись без двоеточий и дефисов, как в карточке устройства. Чтобы удалить условия поиска, необходимо открыть Фильтр по полям, нажать кнопку ОЧИСТИТЬ ФИЛЬТР и сохранить изменения.

Остальные параметры устройства, список терминалов, DSS-кнопки и файлы доступны в карточке, которая открывается по названию устройства.

Добавление устройства

  1. перейти в раздел Автоконфигурирование на вкладку Устройства

  2. нажать кнопку Добавить

    Добавление устройства

  3. заполнить поля:

    • Название: уникальное название устройства

    • MAC-адрес: MAC-адрес устройства — 12 символов без разделителей, например 805ec060d377. Один MAC-адрес нельзя назначить двум устройствам

    • Модель телефона: встроенная или пользовательская модель, которая определяет имена файлов и коды DSS-кнопок

    • Максимальное количество SIP-аккаунтов: количество аккаунтов, поддерживаемое конкретным аппаратом

    • Терминалы: выбрать хотя бы один терминал IVA CS. Данные выбранных терминалов передаются в шаблон файла как SIP-аккаунты

  4. нажать кнопку Сохранить

Число выбранных терминалов ограничивается параметром Максимальное количество аккаунтов модели. Для встроенных моделей Cisco.Any, Cisco.CP-7912 и Cisco.CP-98xx этот предел равен 1. Поле Максимальное количество SIP-аккаунтов в карточке устройства не отменяет ограничение модели.

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

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

В карточке сохраненного устройства можно изменить основные параметры, настроить DSS-кнопки и добавить индивидуальные файлы.

Карточка устройства

Настройка DSS-кнопок

Перед настройкой DSS-кнопки необходимо проверить внутренний код функции в выбранной модели телефона и поддержку функции ее прошивкой. Список Тип в форме устройства может содержать функции, для которых код в модели не задан.

  1. открыть карточку устройства

  2. в секции Настройки DSS кнопок нажать кнопку Добавить

    Добавление настройки DSS-кнопки

  3. настроить параметры DSS-кнопки:

    • поле Кнопка: указать номер DSS-кнопки. Нумерация начинается с 1

    • поле Тип: выбрать тип выполняемой функции и заполнить доступные для нее поля

      Выполняемые функции
      Тип Назначение Какие данные используются

      ACCOUNT

      Выбор SIP-аккаунта

      Укажите порядковый номер терминала из списка терминалов устройства. Поле Номер не используется

      BLF

      Подписка на состояние произвольного номера и, если это поддерживает телефон, перехват вызова

      В поле Номер укажите контролируемый номер

      BLF_SUBSCRIBER

      Подписка на состояние абонента IVA CS

      Выберите абонента в поле Номер

      DND

      Режим Не беспокоить

      Поля Номер и Терминал не используются

      VOICEMAIL

      Вызов функции прослушивания голосовой почты

      Поле Номер необязательно; поле Терминал не используется. Подробнее — Настройка кнопки голосовой почты

    • поле Терминал: установить порядковый номер терминала

      Порядковый номер терминала отображается рядом с терминалом в поле Терминалы карточки устройства

      Порядковый номер терминала

    • поле Номер: содержимое зависит от значения в поле Тип

      • ACCOUNT: вводимое значение не используется

      • BLF: указать номер телефона

      • BLF_SUBSCRIBER: выбрать номер абонента

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

    • поле Метка: ввести информационную метку, отображаемую на экране телефона рядом с DSS-кнопкой

      При настройке кнопки DND поля Номер и Терминал недоступны для редактирования

  4. нажать кнопку Сохранить

Созданные настройки отображаются в общей таблице DSS-кнопок устройства.

Настройки DSS-кнопок

Настройка кнопки голосовой почты

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

  1. открыть карточку устройства и в секции Настройки DSS кнопок нажать кнопку Добавить

  2. в поле Кнопка указать номер функциональной кнопки телефона

  3. в поле Тип выбрать VOICEMAIL

  4. оставить поле Терминал пустым: для этого типа кнопки порядковый номер терминала не используется

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

  6. в поле Метка указать подпись кнопки и нажать кнопку Сохранить

Пользовательский файл устройства

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

  1. открыть карточку устройства

  2. в секции Список файлов нажать кнопку Добавить

    Добавление пользовательского файла устройства

  3. в поле Название указать точное имя, которое запрашивает телефон

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

  5. нажать кнопку Сохранить

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

Файл устройства является константным: макрос $(MAC) необходимо заменить в его названии фактическим MAC-адресом. Например, вместо SEP$(MAC).cnf.xml указать SEP001122334455.cnf.xml

При изменении MAC-адреса устройства связанный с ним константный файл переименовывается автоматически. После изменения проверьте фактическое имя запроса телефона и имя файла в карточке устройства.

Список файлов устройства

Удаление устройства

Чтобы удалить устройство, необходимо:

  1. выбрать устройство во вкладке Устройства

  2. нажать кнопку Удалить и подтвердить действие

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

Модели телефонов

Модель объединяет производителя, название, внутренние коды DSS-кнопок и набор файлов настройки. Ключ модели формируется как Вендор.Название, например Cisco.CP-98xx.

Встроенные модели доступны для просмотра, но их нельзя изменять или удалять. Пользовательские модели можно создавать, редактировать и удалять.

Чтобы открыть список моделей, перейдите в раздел Автоконфигурирование на вкладку Модели телефонов.

Модели телефонов

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

Настройки модели телефона

В столбце Встроенная модель значение Да обозначает модель из поставки IVA CS, значение Нет — пользовательскую модель. Состав пользовательских моделей зависит от настроек конкретной установки; их названия не входят в перечень встроенных моделей ниже.

Если поле Максимальное количество аккаунтов пустое, значение в модели не задано. Число SIP-аккаунтов, поддерживаемое телефонным аппаратом, необходимо уточнять по его модели и прошивке.

Встроенные модели

Ключ модели Встроенная Максимум SIP-аккаунтов модели Назначение

AudioCodes.400HD

Да

Не задан моделью

Телефоны серии AudioCodes 400HD; проверяемая модель — AudioCodes C450HD

Avaya.J100

Да

Не задан моделью

Телефоны серии Avaya J100

Cisco.Any

Да

1

Телефоны Cisco серий CP-69xx, CP-78xx, CP-88xx и CP-99xx

Cisco.CP-7912

Да

1

Телефон Cisco 7912G

Cisco.CP-98xx

Да

1

Телефоны Cisco серии CP-98xx

IVA.Any

Да

Не задан моделью

IVA Video, IVA Advanced и IVA Advanced M

Polycom.Any

Да

Не задан моделью

Polycom RealPresence Trio 8800 и Polycom VVX 500

Yealink.Any

Да

Не задан моделью

Телефоны Yealink

Коды DSS во встроенных моделях

Внутренняя кодировка DSS-кнопок
Тип Назначение

ACCOUNT

Выбор SIP-аккаунта

BLF

Подписка на состояние произвольного номера и, если это поддерживает телефон, перехват вызова

BLF_SUBSCRIBER

Подписка на состояние абонента IVA CS

BLF_GROUP

Подписка на группу и групповой перехват вызова

DND

Режим Не беспокоить

VOICEMAIL

Код для доступа к сервису голосовой почты. Порядок настройки приведен в подразделе Настройка кнопки голосовой почты

BLF_LIST

Список BLF
Внутренняя кодировка DSS-кнопок

В таблице приведены значения, отображаемые в секции Внутренняя кодировка DSS кнопок. Пустая ячейка означает, что кодирование этой функции в модели не задано. Наличие типа в выпадающем списке формы устройства не подтверждает поддержку функции выбранной моделью.

Модель ACCOUNT BLF BLF_SUBSCRIBER BLF_LIST BLF_GROUP DND VOICEMAIL

AudioCodes.400HD

SIP_ACCOUNT

 — 

 — 

 — 

 — 

 — 

 — 

Avaya.J100

 — 

 — 

 — 

 — 

 — 

 — 

 — 

Cisco.Any

 — 

BLF

BLF

 — 

 — 

DND

VOICEMAIL

Cisco.CP-7912

 — 

 — 

 — 

 — 

 — 

 — 

 — 

Cisco.CP-98xx

 — 

BLF

BLF

 — 

 — 

DND

VOICEMAIL

IVA.Any

1

3

3

 — 

3

21

5

Polycom.Any

 — 

BLF

BLF

 — 

BLF

 — 

 — 

Yealink.Any

15

16

16

 — 

16

5

12

Непустой код означает, что IVA CS может сформировать соответствующий параметр в файле. Фактическая работа кнопки также зависит от модели аппарата, версии прошивки и содержимого шаблона

Добавление пользовательской модели

Пользовательская модель — описание модели телефонного аппарата, добавленное администратором. Она содержит сведения о производителе, названии модели, кодах DSS-кнопок и связанных файлах конфигурации.

Чтобы добавить пользовательскую модель, необходимо:

  1. перейти на вкладку Модели телефонов и нажать кнопку Добавить

    Добавление модели телефона

  2. заполнить поля Название и Вендор

  3. в секции Внутренняя кодировка DSS кнопок задать только те коды, которые поддерживает телефон и использует его конфигурационный файл

  4. нажать кнопку Сохранить

В форме доступны поля ACCOUNT, BLF, BLF_SUBSCRIBER, BLF_LIST, BLF_GROUP, DND и VOICEMAIL. Поле максимального количества SIP-аккаунтов в форме модели отсутствует: это значение задается в карточке устройства.

Ключ Вендор.Название должен быть уникальным. Для каждой используемой DSS-функции необходимо задать код, который поддерживается конфигурационным файлом модели.

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

Файлы автоконфигурирования

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

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

Файл может быть связан либо с моделью, либо с конкретным устройством. Одновременно связать один файл и с моделью, и с устройством нельзя.

Чтобы открыть общий список, необходимо перейти в раздел Автоконфигурирование на вкладку Файлы автоконфигурирования.

Файлы автоконфигурирования

Типы файлов

Тип Название в интерфейсе Связь Шаблон Правило имени и поиска

0

Файл модели

Модель телефона

Всегда Да

Имя содержит $(MAC). Файл выбирается после определения устройства и его модели

1

Константный файл модели

Модель телефона

Всегда Нет

Телефон запрашивает точное постоянное имя, например AppDialRules.xml

При добавлении файла из карточки модели доступны только типы Файл модели и Константный файл модели. Для типа Файл модели интерфейс устанавливает Файл содержит шаблон: Да, для константного файла — Нет.

Размер одного файла не должен превышать 100 Кбайт.

Параметры файла в интерфейсе

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

Настройки файла автоконфигурирования
Поле Описание Особенность

Название

Имя, которое запрашивает телефон, либо шаблон имени с $(MAC)

Именно это поле участвует в сопоставлении запроса

Тип

Один из типов файлов

Набор доступных типов зависит от того, откуда добавляется файл: из модели или устройства

Встроенный файл

Признак системного файла IVA CS

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

Код

Внутренний идентификатор содержимого в хранилище

Не используется телефоном как имя запроса и может отличаться от поля Название

Файл содержит шаблон

Определяет, нужно ли обработать содержимое как шаблон

Для типа 0 — Да, для типов 1 и 2 — Нет

Кодовое имя кодировщика

Служебный параметр обработки содержимого

В форме добавления пользовательского файла текущего интерфейса отдельно не задается

Выберите файл

Загрузка содержимого с локального компьютера

После выбора имя и содержимое можно проверить перед сохранением

Содержимое файла

Текст конфигурации, возвращаемый телефону либо обрабатываемый как шаблон

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

В карточке встроенного файла ciscoCP98xx-SoftKeys.xml поле Код может содержать ciscoCP88xx-SoftKeys.xml. При поиске запроса используется поле Название, поэтому телефон должен запрашивать ciscoCP98xx-SoftKeys.xml

Добавление файла модели

  1. открыть вкладку Модели телефонов и выбрать модель

  2. в секции Список файлов модели нажать кнопку Добавить

  3. ввести Название

  4. выбрать Тип:

    • Файл модели — для персонального имени с $(MAC) и шаблонного содержимого

    • Константный файл модели — для общего файла с постоянным именем и неизменяемым содержимым

  5. загрузить файл или вставьте его содержимое

  6. проверить содержимое и нажать кнопку Сохранить

Для файлов типа 0 сочетание имени и модели должно быть уникальным. Одинаковое имя, например $(MAC).cfg, допустимо у разных моделей. Два пользовательских константных файла с одним и тем же запрашиваемым именем создавать не следует. Пользовательский файл может иметь имя встроенного файла, если требуется намеренно переопределить встроенный вариант.

Параметры шаблонных файлов

Содержимое файла типа Файл модели обрабатывается синтаксисом Go text/template. Начальная структура данных доступна через оператор .

Параметр или функция Что содержит Пример обращения

Accounts

Массив SIP-аккаунтов, сформированный из терминалов устройства

{{ range .Accounts }}

SIPServers

Массив адресов SIP-серверов

{{ index .SIPServers 0 }}

SIPServer

Первый элемент массива SIPServers

{{ .SIPServer }}

DSSKeys

Массив настроенных DSS-кнопок устройства

{{ range .DSSKeys }}

Time

Время обращения телефона за файлом

{{ .Time }}

GMTOffset

Смещение часового пояса

{{ .GMTOffset }}

DaylightOffset

Смещение для перехода на летнее время

{{ .DaylightOffset }}

feature(Account)

Объект абонентских функций для выбранного аккаунта

{{ $feature := feature . }}

defaultFeatures(TemplateData)

Объект абонентских функций для первого аккаунта

{{ $feature := defaultFeatures . }}

Account.Index

Индекс аккаунта, начиная с 0

{{ .Index }}

Account.AuthName

Логин SIP-аккаунта

{{ .AuthName }}

Account.Password

Пароль SIP-аккаунта

{{ .Password }}

Account.UserName

Имя терминала

{{ .UserName }}

Account.DomainName

Имя домена

{{ .DomainName }}

Account.DisplayName

Отображаемое имя терминала

{{ .DisplayName }}

Account.LocalSIPPort

Локальный TCP/UDP-порт SIP на устройстве

{{ .LocalSIPPort }}

Account.ConferenceURI

URI конференц-комнаты для кнопочной конференции

{{ .ConferenceURI }}

Пример ниже формирует отдельный блок настроек для каждого SIP-аккаунта устройства. Конструкция range .Accounts повторяет строки внутри блока для всех аккаунтов, а end завершает повторение. Значения .UserName, .AuthName и .Password берутся из текущего аккаунта. Выражение add .Index 1 преобразует индекс, начинающийся с нуля, в номер аккаунта, начинающийся с единицы.

Пример формирования настроек SIP-аккаунтов
{{ range .Accounts }}
account.{{ add .Index 1 }}.enable = 1
account.{{ add .Index 1 }}.user_name = {{ .UserName }}
account.{{ add .Index 1 }}.auth_name = {{ .AuthName }}
account.{{ add .Index 1 }}.password = {{ .Password }}
{{ end }}

Для двух аккаунтов этот шаблон сформирует два блока с префиксами account.1 и account.2. Имена параметров в файле конфигурации необходимо выбирать по формату, который поддерживает модель телефона.

Шаблон получает учетные данные SIP-аккаунтов. Ограничьте доступ к пользовательским файлам и используйте защищенный транспорт, если его поддерживает телефон. Не размещайте выгруженные конфигурации в общедоступном хранилище

Встроенные файлы

В таблице приведен фактический состав вкладки Файлы автоконфигурирования в проверенной версии интерфейса.

Встроенные файлы имеют значение Встроенный файл: Да. Их нельзя изменить или удалить, но можно выгрузить кнопкой Скачать и использовать как основу пользовательского файла. Пользовательские файлы имеют значение Встроенный файл: Нет и доступны для редактирования и удаления.

Модель Название Тип Шаблон

AudioCodes.400HD

$(MAC).cfg

Файл модели

Да

Avaya.J100

AvayaJ100-46xxsettings.txt

Константный файл модели

Нет

Avaya.J100

$(MAC).AvayaJ100.txt

Файл модели

Да

Avaya.J100

J100Supgrade.txt

Константный файл модели

Нет

Cisco.CP-7912

gk$(MAC)

Файл модели

Да

Cisco.Any

AppDialRules.xml

Константный файл модели

Нет

Cisco.Any

SEP$(MAC).cnf.xml

Файл модели

Да

Cisco.Any

ciscoCP88xx-DialTemplate.xml

Константный файл модели

Нет

Cisco.Any

ciscoCP88xx-SoftKeys.xml

Константный файл модели

Нет

Cisco.CP-98xx

ciscoCP98xx.DefaultFP.xml

Константный файл модели

Нет

Cisco.CP-98xx

SEP$(MAC).cnf.xml

Файл модели

Да

Cisco.CP-98xx

ciscoCP98xx-DialTemplate.xml

Константный файл модели

Нет

Cisco.CP-98xx

ciscoCP98xx-SoftKeys.xml

Константный файл модели

Нет

IVA.Any

cfg$(MAC).xml

Файл модели

Да

Polycom.Any

$(MAC).cfg

Файл модели

Да

Polycom.Any

$(MAC)-phone.cfg

Файл модели

Да

Yealink.Any

$(MAC).cfg

Файл модели

Да

Подключение телефонов разных вендоров

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

Вендор или серия DHCP-опция Модель IVA CS Запрашиваемые файлы

AudioCodes 400HD

160

AudioCodes.400HD

$(MAC).cfg

Avaya J100

66 или 242

Avaya.J100

J100Supgrade.txt, AvayaJ100-46xxsettings.txt, $(MAC).AvayaJ100.txt

Cisco 7912

150

Cisco.CP-7912

gk$(MAC)

Cisco CP-69xx, CP-78xx, CP-88xx и CP-99xx

150

Cisco.Any

SEP$(MAC).cnf.xml, AppDialRules.xml, файлы ciscoCP88xx-*

Cisco CP-98xx

150

Cisco.CP-98xx

SEP$(MAC).cnf.xml, ciscoCP98xx.DefaultFP.xml, файлы ciscoCP98xx-*

IVA

66

IVA.Any

cfg$(MAC).xml

Polycom

66 или 160

Polycom.Any

$(MAC).cfg и/или $(MAC)-phone.cfg

Yealink

66

Yealink.Any

$(MAC).cfg

Avaya

Телефон Avaya J100 последовательно получает общие и персональные параметры:

  1. Получает адрес сервера конфигурации через DHCP

  2. Запрашивает J100Supgrade.txt и определяет необходимость обновления прошивки

  3. Запрашивает общий файл AvayaJ100-46xxsettings.txt

  4. Запрашивает персональный файл $(MAC).AvayaJ100.txt

Для серии J100 используются встроенные кнопки конференции (кнопка Conf.), удержания (кнопка Hold) и перевода вызова (кнопка Transfer). Внутренние коды DSS во встроенной модели Avaya.J100 не заданы, поэтому DSS-кнопки через IVA CS для этой модели не настраиваются.

Cisco

Для Cisco используются три отдельные встроенные модели:

  • Cisco.CP-7912 — файл gk$(MAC); DSS-коды не заданы

  • Cisco.Any — серии CP-69xx, CP-78xx, CP-88xx и CP-99xx

  • Cisco.CP-98xx — серия CP-98xx и отдельный набор константных файлов

Автоконфигурирование Cisco CP-78xx и CP-88xx проверялось с SIP-прошивкой CUCM. Зафиксированы следующие проверенные версии:

  • sip88xx.14-0-1-0101-145

  • sip88xx.14-0-1-0201-171

  • sip88xx.14-2-1-0001-14

  • sip88xx.12-8-1-0101-482

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

Поддерживаемые функциональные клавиши устройств Cisco:

Настройка через сторонний TFTP-сервер не гарантирует применение файлов и функций, предусмотренных встроенной моделью IVA CS

  • поддержка сетевой конференции: кнопка Conference / Конференция (Конф.)

  • поддержка BLF (BLF на номер абонента и перехват вызова по кнопке): кнопка BLF

    Устройства серии Cisco 7912 не поддерживают BLF

  • безусловная переадресация вызова: кнопка FwdAll / Переадрес. все

  • удержание вызова: кнопка Hold / Удержание

  • перевод вызова: кнопка Transfer / Перевод

  • установка режима Не беспокоить: поддерживается встроенная работа клавиши DND устройства (статус локального DND телефона не передается с устройства на сервер телефонии IVA CS)

  • поддержка настраиваемых DSS-кнопок:

    Устройства серии Cisco 7912 не поддерживают настройку DSS-кнопок

    • BLF

    • BLF_SUBSCRIBER

    • DND (статус локального DND телефона не передается с устройства на сервер телефонии IVA CS)

Yealink

Встроенная модель Yealink.Any формирует персональный файл $(MAC).cfg. В модели заданы коды ACCOUNT, BLF, BLF_SUBSCRIBER, BLF_GROUP, DND и VOICEMAIL.

Поддерживаемые функциональные клавиши устройств Yealink:

  • поддержка сетевой конференции: кнопка Конференция

  • поддержка BLF (на номер абонента и перехват вызова по кнопке): кнопка BLF

  • удержание вызова: кнопка Hold / Удержание

  • перевод вызова: кнопка Transfer / Трансфер

  • поддержка режима Не беспокоить: настраиваемая функциональная клавиша DND

  • поддержка настраиваемых DSS-кнопок:

IVA

Телефоны IVA используют персональный файл cfg$(MAC).xml. Встроенная модель поддерживает коды ACCOUNT, BLF, BLF_SUBSCRIBER, BLF_GROUP, DND и VOICEMAIL.

Для телефонов IVA поддерживаются следующие функциональные клавиши:

  • удержание вызова: кнопка Удержание

  • перевод вызова: кнопка Трансфер

  • поддержка BLF (подписка на номер абонента / группу и перехват вызова по кнопке): настраиваемая функциональная клавиша BLF

  • перехват вызова: пользователи могут перехватывать звонки прямо с программируемых DSS-кнопок, на которых настроены функции BLF (подписка на группу вызова) или BLF_SUBSCRIBER (подписка на абонента)

  • поддержка сетевой конференции: кнопка Конференция

  • установка режима Не беспокоить: поддерживается встроенная работа клавиши DND устройства (статус DND не передается с устройства на сервер телефонии IVA CS)

  • поддержка настраиваемых DSS-кнопок:

Polycom

Модель Polycom.Any содержит два варианта персонального файла: $(MAC).cfg и $(MAC)-phone.cfg. Фактически запрашиваемое имя зависит от модели и ее настроек provisioning.

Поддерживаемые функциональные клавиши устройств Polycom:

  • поддержка сетевой конференции (без отображения участников)

  • удержание вызова: кнопка Hold

  • перевод вызова: кнопка Transfer

  • поддержка BLF (подписка на номер абонента и перехват вызова по кнопке): кнопка BLF

  • поддержка настраиваемых DSS-кнопок:

AudioCodes

Встроенная модель AudioCodes.400HD предназначена для серии 400HD; в исходной документации в качестве проверяемого аппарата указан AudioCodes C450HD. Модель формирует файл $(MAC).cfg и содержит код ACCOUNT со значением SIP_ACCOUNT.

Поддерживаемые функциональные клавиши устройств AudioCodes:

  • поддержка сетевой конференции (без отображения участников): кнопка Conference

  • удержание вызова: кнопка HOLD

  • перевод вызова: кнопка TRANSFER

  • поддержка настраиваемых DSS-кнопок:

Возможные проблемы

Симптом Возможная причина Что проверить

Вместо списка файлов отображается Отсутствуют права

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

Право Файлы автоконфигурирования в назначенной роли. Подробнее — Права для работы с автоконфигурированием

В списке DSS-кнопок отображается Отсутствуют данные

Для устройства не созданы DSS-кнопки либо записи не соответствуют фильтру

Настройки выбранного устройства и условия фильтрации списка

Пользовательская модель доступна только для просмотра

В роли нет права записи для модели телефона

Право Модель телефона и его уровни в назначенной роли

Телефон получает 404

Не найден константный файл; в запросе нет распознаваемого MAC-адреса; устройство или файл модели отсутствуют

Точное имя запроса, MAC-адрес устройства, выбранную модель и имя файла с $(MAC)

Телефон не обращается к IVA CS

Неверная DHCP-опция, адрес, протокол, маршрут или сетевой доступ

Журнал DHCP, настройки provisioning-сервера в телефоне, доступность TFTP/HTTP/HTTPS и статус swl-provision

Возвращается встроенный файл вместо пользовательского

Имена файлов различаются хотя бы одним символом

Полное имя, регистр, расширение и отсутствие лишних пробелов

Файл найден, но параметры не подставлены

Создан константный файл или нарушен синтаксис шаблона

Тип файла, признак Файл содержит шаблон и выражения {{ …​ }}

DSS-тип отсутствует в форме устройства

Тип недоступен в используемой версии веб-интерфейса

Версию веб-интерфейса и наличие нужного пункта в списке Тип. Для VOICEMAIL — порядок настройки кнопки голосовой почты

DSS-кнопка сформирована, но не работает на телефоне

Код или формат файла не поддерживается моделью либо прошивкой

Руководство вендора, содержимое файла и приемочный тест на той же версии прошивки

Применяется конфигурация другого устройства

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

Уникальность MAC-адресов и пользовательских константных файлов