Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml

в 21:52, , рубрики: 3cx, cloud-init, Debian, автоматическая настройка, Блог компании 3CX Ltd., облако, Серверное администрирование, Сетевые технологии, системное администрирование, файл ответов, метки: , ,

Введение

Вы можете автоматически установить и настроить сервер 3CX используя подготовленный файл ответов. Файл ответов – это XML файл, в котором содержатся те же параметры, которые вы указываете в командной строке или веб интерфейсе Мастера настройки 3CX. Вы можете создать такой файл и размесить его непосредственно на сервере или пакете конфигурации облачного образа cloud.init. На все “вопросы”,  которые обычно задаются в Мастере настройки 3CX, система получает заранее установленные “ответы” из файла. В результате вы за несколько минут получаете полностью настроенную и готовую к работе систему, настроенную по вашему типовому шаблону. Вы также можете включить в файл ответов параметры добавочных номеров, SIP транков и DID линий, которые будут автоматически созданы в процессе настройки.

Обзор технологии

SNAGHTML11c1c48d


Приготовьте XML файл и разместите его на сервере перед началом установки 3CX:

  1. Скачайте пример XML файла ответов setupconfig.xml
  2. Укажите в нем параметры, соответствующие вашей конфигурации
  3. Сохраните setupconfig.xml на сервере в соответствующей папке:
    • Для Linux версии 3CX: /etc/3cxpbx/setupconfig.xml.
    • Для Windows версии 3CX: C:ProgramData3CXDatasetupconfig.xml

  4. При установке 3CX Мастер первоначальной настройки проверяет наличие файла setupconfig.xml.

Вместо копирования файла на сервер, вы можете использовать cloud.init. Скопируйте содержимое setupconfig.xml в раздел Advanced > User data. Ниже приведен пример образа Amazon AWS cloud.init.

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 2

Пример файла cloud.init

Включение setupconfig.xml в cloud.init.

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 3

→ Скачайте пример файла cloud.init

Структура файла Setupconfig.xml

Файл setupconfig.xml разделен на 4 секции:

  • tcxinit — описывает начальный этап Мастера конфигурации АТС. Здесь содержатся ответы на такие вопросы: лицензионный ключ или путь к файлу резервной копии, параметры сети, публичный IP адрес, FQDN имя (выданное 3CX или пользовательское), имя хоста, тип DNS (локальный или от 3CX), HTTP/S порты и подобные параметры.
  • mcwizard — описывает следующий этап Мастера конфигурации АТС. Здесь содержатся ответы на такие вопросы: длина добавочного номера, параметры почтового сервера, часовой пояс, страна и данные о владельце системы 3CX.
  • extensions – в этом разделе указываются параметры добавочных номеров (пользователей).
  • siptrunk – в этом разделе указываются параметры SIP транков и DID номеров. В подразделах inboundrules описываются входящие правила, связанные с DID номерами определенного транка.
  • OutboundRules – в этом разделе описываются параметры исходящих правил.

Пример: ответы Мастера первоначальной конфигурации 3CX

Блок ответов Мастера первоначальной конфигурации 3CX находится в разделе mcwizard:

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 4

Для корректного заполнения параметров CountryName, TimezoneId и LicenseCountry обратитесь к этой таблице и выберите нужное значение. Например, для Мексики укажите такие параметры:

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 5

Пример: добавление добавочных номеров, SIP транков, DID и исходящих правил

В блоках ответов extension, siptrunk, InboundRules и OutboundRules определяются добавочные номера, транки, входящие и исходящие правила, соответственно. Описывая добавочный номер, вы можете закрепить за ним IP телефон. Для этого укажите информацию о шаблонах автонастройки IP телефонов по этой таблице. Например, если необходимо привязать телефон snom 720, найдите в таблице эту модель и соответствующий файл шаблона автонастройки (в данном случае snom.ph.xml). Укажите эту информацию в соответствующем xml теге.

Создание добавочного номера

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 6

Создание SIP транков, DID и входящих правил

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 7

Создание исходящих правил с указанием резервных маршрутов (транков)

Автоматическая настройка 3CX с помощью файла ответов setupconfig.xml - 8

Пример: автоматическая установка SSL сертификатов

Покажем, как можно включить в файл ответов setupconfig.xml данные SSL сертификата. В данном примере речь идет только об SSL сертификате веб сервера. Для других сертификатов, используемых системой, добавьте описание сертификата в других разделах файла ответов. Путь CertificatePath будет общий для всех, однако пароль для каждого сертификата CertificatePassword  будет отличаться.

sslsetupconfig.PNG

Загрузки 3CX

Автор: 3CX Ltd.

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js