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

Установка и настройка модуля 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 по указанным портам:

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

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

    • TCP/443, UDP/10000

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

Установка Docker Engine

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

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

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

Установка mint_sip

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

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

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

Примечание

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

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

Важно

Если установка mint_sip производится на один сервер с 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/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