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

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

Описание

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

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

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

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

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

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

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

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

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

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

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

Например

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

Пространство для хранения записей

Все записи хранятся на сервере mint_mgmt в директории /opt/mint/mgmt/configs/mint_web/files/recordings/

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

Добавьте достаточный объем места, исходя из того, что 1 час записи может занимать до 800 МБ на диске.

IP-адресация

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

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

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

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

Примечание

Для онлайн-трансляций конференций на платформы VK, RuTube и YouTube на сервере mint_rec должен быть сетевой доступ до данных ресурсов.

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

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

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

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

    • TCP/443, UDP/10000

Установка и настройка

Примечание

Все действия в данной инструкции должны выполняться с правами root.

Установка Docker Engine

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

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

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

Установка mint_rec

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

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

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

Примечание

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

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

Важно

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

sudo ufw allow from 172.0.0.0/8

Настройка на отдельном сервере

Важно

Если установка производится на один сервер с mint_mgmt, то пропустите этот пункт и перейдите к следующему пункту настройка на одном сервере с mint_mgmt.

  1. Установите программное обеспечение rsync

    sudo apt update && sudo apt install -y rsync

    sudo dnf install -y rsync

  2. Далее необходимо создать SSH-ключ пользователя root:

    sudo ssh-keygen -t rsa -b 4096 -N "" -f /opt/mint/rec/configs/ssh_keys/id_rsa

  3. Примечание

    Данный пункт выполняется на сервере mint_mgmt.

    Добавьте все содержимое из файла /opt/mint/rec/configs/ssh_keys/id_rsa.pub сервера mint_rec в /home/"username"/.ssh/authorized_keys на сервере mint_mgmt.

    Если файл authorized_keys отсутствует, его необходимо создать.

Общие настройки mint_rec

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

    • DOMAIN — доменное имя сервера mint_mgmt
    • MGS_LOCAL_IP — внутренний (частный) IP-адрес сервера mint_mgmt
    • XMPP_AUTH_PASSWORD — значение XMPP_AUTH_PASSWORD из .env файла модуля mint_mgmt
    • MGMT_USER — имя пользователя сервера mint_mgmt, для которого был добавлен SSH-ключ сервера mint_rec (Оставьте пустым при установке на один сервер)
    • MGMT_SSH_PORT — порт SSH для подключения к mint_mgmt (Оставьте пустым при установке на один сервер)

  2. Запустите контейнеры командой:

    docker compose up -d

    Проверьте, что все контейнеры успешно запустились, командой:

    docker ps -a

    Все контейнеры должны иметь статус “Up”.

Настройка mint_mgmt

Примечание

Данный пункт выполняется на сервере mint_mgmt.

  1. Откройте файл .env в директории /opt/mint/mgmt и укажите IP-адрес сервера записи.

    Если mint_rec на отдельном сервере:

    • Укажите в MRS_HOSTS — внутренний (частный) IP-адрес сервера mint_rec

    Если mint_rec на одном сервере с другими модулями:

    • Укажите в MRS_HOSTS — шлюз сети Docker. Узнайте его, выполнив команду:
    sudo docker network inspect mgmt_mint.network --format '{{ (index .IPAM.Config 0).Gateway }}'

  2. Перезапустите контейнеры, находясь в директории /opt/mint/mgmt, выполнив команды:

    docker compose stop

    docker compose up -d