Мы продолжаем публикацию цикла из трех статей, посвященных автопровижинингу IP‑телефонов Yealink. Первая часть цикла была посвящена обзору функции автопровижининга, во второй части мы рассмотрим принципы работы с конфигурационными файлами.
Конфигурационные файлы — список параметров, которые будут считываться и применяться телефоном в процессе автопровижининга.
Подготовка конфигурационных файлов — неотъемлемая часть процесса автопровижининга. Существует несколько типов конфигурационных файлов:
общий конфигурационный файл (y000000000XXX.cfg);
персонифицированный конфигурационный файл (MAC.cfg);
пользовательский конфигурационный файл (filename.cfg);
общий менеджер конфигурационных файлов (y000000000000.boot);
персонифицированный менеджер конфигурационных файлов (MAC.boot).
Телефон при автопровижининге загружает конфигурационные файлы, придерживаясь следующей последовательности: MAC.boot -> y0000000000xx.boot -> y0000000000xx.cfg -> MAC.cfg.
Типы конфигурационных файлов, используемых в автопровижининге
Boot-файл является необязательным элементом провижининга. Он определяет, какие файлы конфигурации cfg будут загружены определенными группами телефонов, и настраивает последовательность загрузки этих файлов. Сам boot-файл не содержит в себе непосредственно параметров конфигурации телефонов.
Boot-файл обычно применяется в сценариях развертывания большого парка устройств разных моделей, т. к. он позволяет более гибко настроить провижининг, а также упростить управление конфигурационными файлами.
Пример: при стандартном провижининге (с помощью cfg-файлов) будет использовано множество дублирующих друг друга файлов конфигурации. Провижининг через boot-файл решает проблему дублирования конфигов, позволяя провижиниться одновременно множеством cfg-файлов, каждый из которых будет посвящен определенной функции: сеть, настройки функций вызова, настройка функций телефона, настройка справочников и пр.
Cfg-файл — файл непосредственно настроек устройства, его структура — список параметров. Этот файл является обязательным элементом провижининга, который применим и в boot- и в cfg-провижининге (новый и старый механизмы провижининга).
Параметры cfg-файла можно разделить на общие (для некоторого количества устройств, например, DSS-клавиши, активация функций) и персонифицированные (для определенного устройства, например, настройки учетной записи SIP, настройки сети).
Resource files (файлы ресурсов) не являются конфигурационными файлами как таковыми, но их нельзя не упомянуть, говоря о подготовке конфигурационных файлов. Это файл или архив с файлами различного типа (фотографии, скринсейверы, мелодии звонка, справочники и пр.), которые используются телефоном в целях персонификации.
Файлы ресурсов могут быть загружены телефоном во время провижининга путем указания ссылки на них в качестве параметра конфигурационного файла cfg.
Пример: ringtone.url = tftp://192.168.5.25/ringtone.wav
Подготовка конфигурационных файлов
Подготовка boot-файла
Boot-файл прост по своей структуре и состоит из заголовка, списка конфигурационных файлов и небольшого количества параметров, определяющего порядок загрузки и применения конфигурационных файлов. При подготовке этого файла необходимо именовать его должным образом. Общий boot-файл имеет название y000000000000.boot, персонифицированный — MAC.boot.
Структура файла
#!version:1.0.0.1 — заголовок файла. Удалять его нельзя.
include:config — конфигурационные файлы cfg. Каждый конфигурационный файл указывается отдельной строкой. В каждой строке include указывается полный URL-адрес, по которому хранится конфигурационный файл cfg. URL-адрес указывается внутри <> или "".
Пример: include:config http://192.168.5.25/common/cfg/ringtones.cfg
Конфигурационные параметры будут загружаться телефоном в указанном порядке (сверху вниз). Ограничений на количество операторов include:config нет.
К include:config можно добавить приставку [$MODEL] для указания принадлежности данного конфигурационного файла к определенной модели (или моделям) устройств. $MODEL — название модели телефона. При указании нескольких моделей их необходимо разделить запятыми, например, [T46S, T23G].
Допустимые значения параметра: VP59, T58, CP960, CP965, T58W, T57W, T54W, T53W, T53, T48U, T48S, T48G, T46U, T46S, T46G, T43U, T42U, T42S, T42G, T41P, T41S, T40P, T40G, T33P, T33G, T31P, T31G, T31, T30P, T30, T29G, T27G, T23P, T23G, T21P_E2, T19P_E2, CP920, CP925W.
overwrite_mode — включение режима перезаписи. При активации данного параметра (overwrite_mode = 1) и провижининге с помощью конфигурационного файла, если значение параметра конфигурации — "null", отсутствует или параметр закомментирован, вступит в силу заводское значение данного параметра. Отключение этого параметра (overwrite_mode = 0) позволяет параметрам изменяться только в том случае, если было определено их значение.
specific_model.excluded_mode — при включении данного режима телефон будет скачивать только конфигурационные файлы, предназначенные для данной модели устройства, и лишь при их отсутствии телефон скачает общие конфигурационные файлы. При отключении режима телефон загрузит все файлы, кроме тех, что предназначаются для других моделей телефонов.
После подготовки boot-файла необходимо присвоить ему корректное название: y000000000000.boot для общего boot-файла или MAC.boot для персонифицированного boot-файла (где MAC — MAC-адрес устройства, которому адресован конфиг).
Подготовка cfg-файла
Структура cfg-файла — это список параметров в формате параметр = значение параметра, где каждый параметр — отдельная строка списка. Например, параметр account.2.cid_source = 4 означает, что источник caller id (account.X.cid_source) для SIP-аккаунта №2 (2) будет определяться согласно приоритету PAI>RPID>FROM(= 4).
Описание каждого параметра и диапазон допустимых значений этого параметра можно найти в руководстве администратора к конкретному устройству. Скачать руководство администратора можно на сайте support.yealink.com или ipmatika.ru.
При подготовке файла необходимо именовать его должным образом. Общий cfg-файл имеет название y000000000XXX.cfg (значение XXX указано в таблице ниже для различных моделей телефонов), персонифицированный — MAC.cfg (где MAC — MAC-адрес устройства, которому адресован конфиг), пользовательский — filename.cfg (где filename — имя файла, которое может быть любым).
Как упростить подготовку конфигурационных cfg-файлов
Существует множество способов упростить подготовку конфигурационного файла. Перечислим основные.
Подготовка конфигурационных файлов с помощью шаблонов
Yealink предоставляет универсальный шаблон конфигурационного файла для редактирования файлов common.boot, common.cfg и MAC.cfg.
Шаблон довольно прост и представляет собой список параметров, для удобства разделенный по группам. Необходимо произвести его редактирование, заполнив значение этих параметров. Неиспользуемые параметры можно не изменять (при их импорте сохранится значение по умолчанию), удалить или закомментировать. После редактирования файла необходимо переименовать его в соответствии с определенным сценарием провижининга.
Подготовка конфигурационных файлов с помощью утилиты ConfigurationGeneratorTool
Утилита предназначена для облегчения работы над конфигурационными файлами в формате cfg. Она имеет интуитивно понятный графический интерфейс и предоставляет возможность составлять конфигурационные файлы любой сложности. Утилита поддерживает работу с конфигурационными файлами большинства актуальных моделей телефонов Yealink.
Скачать утилиту с официального сайта производителя
Обзор интерфейса утилиты
Вкладка File (1) предназначена для сохранения/загрузки конфиг-файла (в формате cfg).
Вкладка Configuration (2) предназначена для редактирования линий и основных настроек.
Вкладка Phone Configuration (3) предназначена для редактирования настроек программируемых клавиш.
Вкладка Advanced Configuration (4) предназначена для расширенных настроек устройства.
Вкладка CSV Configuration (5) предназначена для импорта/экспорта конфигурации из csv-файла.
Вкладка Configuration Conversion (6) предназначена для шифрования конфигурационных файлов.
Выпадающее меню со списком устройств (7) предназначено для выбора устройства, для которого будет создаваться конфигурационный файл.
Окно справа (8) предназначено для ручного редактирования конфигурации.
Подготовка конфигурационного файла на IP-АТС (на примере IP-АТС Yeastar)
IP-АТС может предоставлять функционал упрощенного редактирования конфигурационных файлов.
В качестве примера рассмотрим IP-АТС Yeastar, которая имеет шаблоны конфигурационных файлов для телефонов Yealink и предоставляет возможность ручного редактирования этих файлов. Таким способом можно подготовить конфигурационные файлы cfg.
Копирование конфигурационного файла
С уже настроенного телефона Yealink можно экспортировать конфигурационный файл через веб-интерфейс.
Веб-интерфейс: Настройки – Конфигурации – Конфигурационный файл CFG – Экспорт конфигурационного файла
Экспортированный файл можно редактировать путем изменения/добавления/удаления строк, а затем использовать его в качестве конфигурационного файла, переименовав в соответствии с определенным сценарием провижининга.
В третьей статье цикла мы рассмотрим практический пример настройки провижн-сервера.
Следите за нашими новостями!