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

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

    • 443 TCP, 5222 TCP, 6222 TCP

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

    • 443 TCP, 10000 UDP

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

Примечание

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

Установка Docker Engine

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

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

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

Установка mint_rec

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

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

  3. Запустите скрипт установки 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 cat /root/.ssh/id_rsa.pub
    Если ключ есть, переходите к пункту 3, если ключа нет, создайте его командой:

    sudo ssh-keygen -t rsa -b 4096 -N "" -f /root/.ssh/id_rsa

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

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

    Добавьте все содержимое из файла /root/.ssh/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