Перейти к содержанию

Установка и настройка модуля mint_phone

Требования к инфраструктуре

Операционная система

Операционная система на базе Linux.

Рекомендуемые дистрибутивы:

  • Astra Linux — версия 1.7 и выше

  • RedOS — версия 7.3 и выше

  • ALT Linux — версия 9 и выше

  • Ubuntu — версия 20.04 и выше

  • CentOS — версия 7 и выше

  • Debian — версия 11 и выше

  • Fedora — версия 36 и выше

  • RHEL — версия 7 и выше

Примечание

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

Необходимое программное обеспечение

  • Docker Engine версии 24 и выше

  • Пакет python3 версии 3.10 и выше

Системные требования

Требования к серверу:

  • Процессор — 6 vCPU

  • Оперативная память — 6 ГБ

  • Дисковое пространство — 80 ГБ

Требования к процессору

  • Производительность на поток (Single Thread Rating) — не менее 2000 PassMark

  • Общая производительность — не менее 15000 PassMark

Например

Intel Xeon Gold 6126 или аналогичный, Intel Core i7-10700 или аналогичный.

IP-адресация

При установке на отдельный сервер:

  • 1 внутренний (частный) IP-адрес — для взаимодействия с mint_mgmt

При установке на сервер с mint_mgmt:

  • Используется имеющийся внутренний (частный) адрес сервера

Сетевое взаимодействие

  1. С сервера mint_phone доступно соединение к mint_mgmt по указанным портам:

    • TCP/443, TCP/5222, TCP/6222

  2. С сервера mint_phone доступно соединение к mint_media по указанным портам:

    • TCP/443, UDP/10000

  3. С сервера mint_phone настроен сетевой доступ до SIP-АТС.

Установка Docker Engine

Установите Docker Engine с помощью официального скрипта установки

sudo curl -fsSL https://get.docker.com | sh

Либо по инструкции на официальном сайте, предназначенной для вашего дистрибутива Linux. Инструкция по установке Docker Engine

Установка mint_phone

  1. Загрузите архив с дистрибутивом. Скачать

  2. Распакуйте загруженный архив в произвольную директорию, данная директория необходима только на время установки и не будет использоваться для работы ПО.

  3. Запустите скрипт установки install_phone.py из директории mint_phone и следуйте подсказкам установщика.

Примечание

Для работы скрипта установки необходимо наличие python3 версии 3.10 и выше.

Примечание

Модуль mint_phone будет установлен в директорию /opt/mint/phone.

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

Важно

Если установка mint_phone производится на один сервер с mint_mgmt и в операционной системе активен межсетевой экран UFW, необходимо разрешить сетевое взаимодействие между сетями Docker. Для этого выполните команду:

sudo ufw allow from 172.0.0.0/8

Настройка mint_phone

Перейдите в директорию /opt/mint/phone.

В данной директории откройте .env файл и заполните следующие параметры:

  • DOMAIN — доменное имя сервера mint_mgmt
  • XMPP_AUTH_PASSWORD — значение XMPP_AUTH_PASSWORD из .env файла модуля mint_mgmt
  • SIP_URI — логин/внутренний номер учетной записи SIP-АТС
  • SIP_AUTH_NAME — имя пользователя (при необходимости)
  • SIP_PASSWORD — пароль учетной записи SIP-АТС
  • SIP_SERVER — адрес SIP-АТС
  • SIP_PORT — порт SIP-АТС
  • SIP_TRANSPORT — протокол соединения до SIP-АТС (TCP/UDP)

Настройка сервера mint_mgmt

В .env файле сервера mint_mgmt укажите в параметре:

  • SIPGW_HOSTS — внутренний (частный) IP-адрес сервера mint_phone

Перезапустите контейнеры mint_mgmt командами:

docker compose stop

docker compose up -d

Запуск mint_phone

В директории /opt/mint/phone запустите контейнеры командой:

docker compose up -d

Устранение неполадок

Ошибка при наборе номера

При добавлении участника отображается ошибка «Не удалось добавить участников».

Данная ошибка отображается, если mint_phone не подключен к mint_mgmt.

Убедитесь, что параметры DOMAIN и XMPP_AUTH_PASSWORD заполнены корректно, а mint_phone имеет сетевой доступ до mint_mgmt.

Номер добавляется в конференцию, но вызов не поступает на телефон

Убедитесь, что mint_phone зарегистрирован на SIP-сервере. Для этого выполните команду:

docker logs mint_phone 2>&1 | grep 'newState=RegistrationState=Registered'
Если вывод пустой — значит, проблема в регистрации mint_phone на SIP-сервере.

Убедитесь в корректности данных для подключения к SIP-серверу, а также в сетевой доступности SIP-сервера.

Вызов поступает на телефон, но не слышно одну из сторон/обе стороны

В данном случае проблема может быть в доступности RTP-портов.

Убедитесь, что mint_phone и SIP-сервер имеют сетевую связь в диапазоне RTP-портов.

Диапазон RTP-портов mint_phone по умолчанию — 20000–20050.