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

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

Описание

Каждый установленный экземпляр mint_sip позволяет осуществлять один одновременный вызов на SIP кодек. Во время установки необходимо указать необходимое количество экземпляров mint_sip.

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

Аппаратные требования, предъявляемые к конфигурации серверного оборудования, зависят от количества запущенных копий mint_sip.

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

Операционная система на базе 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 и выше

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

Базовые требования для операционной системы:

  • Процессор – 2 vCPU

  • Оперативная память – 4 ГБ

  • Место на жестком диске – 80 ГБ

Требования для запуска каждой копии mint_sip:

  • Процессор – 4 vCPU

  • Оперативная память – 4 ГБ

  • Место на жестком диске – 4 ГБ

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

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

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

Например

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

IP адресация

При установке на отдельную машину:

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

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

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

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

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

    • 443 TCP, 5222 TCP, 6222 TCP

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

    • 443 TCP, 10000 UDP

  3. С машины mint_sip настроен сетевой доступ до вызываемых кодеков.

Установка Docker Engine

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

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

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

Установка mint_sip

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

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

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

Примечание

Компонента mint_sip будет установлена в директорию /opt/mint/sip.

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

Важно

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

sudo ufw allow from 172.0.0.0/8

Настройка mint_sip

Перейдите в каталог /opt/mint/sip и заполните в файле .env следующие параметры:

  • DOMAIN - доменное имя сервера mint_mgmt
  • MGS_LOCAL_IP - частный (серый) ip адрес сервера mint_mgmt
  • XMPP_AUTH_PASSWORD - значение XMPP_AUTH_PASSWORD из .env файла компоненты mint_mgmt
  • EXTERNAL_IP - ip адрес сетевого интерфейса, с которого будут осуществляться вызовы на кодеки

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

Настройка конфигурации

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

  • SIPGW_HOSTS= частный (серый) ip адрес машины mint_sip

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

docker-compose stop

docker-compose up -d

Добавление кодеков для вызова

На сервере mint_mgmt пропишите ip адреса и имена вызываемых кодеков в файле

/opt/mint/mint_mgmt/configs/mint_web/sip.json

Пример файла sip.json

[
   {
       "id": "sip:sip@10.10.10.150:5060",
       "name": "Имя 1",
       "type": "videosipgw"
   },
   {
       "id": "sip:sip@10.10.10.151:5060",
       "name": "Имя 2",
       "type": "videosipgw"
   }
]

Примечание

При изменении файла sip.json перезапуск контейнеров mint_mgmt не требуется.

Запуск mint_sip

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

docker compose up -d