Руководство по установке SIP-коннектора (WRC) ПО МТС Линк on-premise

Установка компонента WRC для работы продуктов МТС Линк совместно с SIP-устройствами

Термины и определения

MCU

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

SIP

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

SSL

Криптографический протокол, использующий асимметричную криптографию, симметричное шифрование и коды аутентификации сообщений

URI

Унифицированный идентификатор ресурса в сети, включающий его имя и адрес

WRC

Webinar Room Connector

Домен

Адрес сайта, место его размещения в сети

Протокол

Совокупность правил и действий для соединения и обмена данными между устройствами в сети

Введение

Данное руководство описывает установку SIP-коннектора (WRC) для программного обеспечения МТС Линк on-premise. Модуль требует обязательной установки ПО МТС Линк on-premise. Встречи на основной сервер.

Требования к оборудованию, сетевым компонентам, а также процесс установки и настройки программного обеспечения МТС Линк on-premise. Встречи подробно описаны в «Руководстве по установке и администрированию программного обеспечения МТС Линк on-premise. Встречи».

Подготовка сервера

Требования к оборудованию

Для работы SIP-коннектора необходимо использовать две виртуальные машины с различными компонентами и характеристиками.

1. Компонент WRC. Рекомендуемые характеристики:

  • 4 vCPU
  • 6 GB RAM
  • 100 GB SSD

2. Компонент MCU Vinteo (см. «Руководство по установке ПО МТС Линк on-premise. SIP-коннектор (Vinteo)» для пилотного проекта или для продуктивной среды). Серверные требования для данного компонента рассчитываются индивидуально персональным менеджером МТС Линк на основе количества планируемых SIP-подключений.

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

Для сервера с компонентом WRC необходимо задать доменное имя вида «sip.example.ru», где:

  • «sip» — субдомен. Его нужно заменить на любое значение;
  • «example» — домен второго уровня. Его нужно заменить на любое значение (как правило, заменяется на имя компании или связанное с компанией название);
  • «ru» — домен верхнего уровня. Зависит от доменной зоны компании.

Это имя будет использоваться для формирования SIP URI. Например, если в качестве имени домена WRC задано sip.example.ru, то SIP URI будет иметь вид sip:хххххххххх@sip.example.ru.


Важно!

1. Доменные имена компонентов WRC и MCU Vinteo должны различаться (достаточно различия на уровне субдомена).

2. Отдельно в /etc/hosts сервера c ПО МТС Линк on-premise. Встречи и отдельно в /etc/hosts сервера c компонентом WRC необходимо добавить запись, содержащую следующие строки:

  • внутренний IP-адрес сервера c ПО МТС Линк on-premise. Встречи и все заданные доменные имена (см. раздел «Настройка доменов» «Руководства по установке ПО МТС Линк on-premise. Встречи»);
  • внутренний IP-адрес сервера c компонентом WRC и заданное имя домена SIP:
    Внутренний IP-адрес Встречи webinars.example.ru webinars-wowza.example.ru webinars-webrtc.example.ru webinars-mgw.example.ru webinars-message.example.ru
    Внутренний IP-адрес WRC sip.example.ru 

Настройка портов

Для работы SIP-коннектора (WRC) необходимо обеспечить связь между серверами. Для этого нужно открыть порты, указанные в таблице:

Протокол

Источник

Приемник

Адрес

Порт

Адрес

Порт

SIP

Интернет

*

SIP-коннектор (WRC)

5060/TCP

5061/TCP

5060/UDP

3238/UDP

36000-42000/UDP

SIP

SIP-коннектор (WRC)

5060/TCP

5061/TCP

5060/UDP

3238/UDP

36000-42000/UDP

Сервер с установленным ПО МТС Линк on-premise. Встречи

443/TCP

1030/TCP

1030/UDP

Установка

Сертификат и секретный ключ шифрования необходимо разместить в директории «certs» в одном каталоге с мастером установки «mts-link-installer.sh».

Важно!

  1. Так как перед запуском установки программа проверяет сертификат, файл .сrt должен:

  • содержать полную цепочку сертификации для того, чтобы браузеры доверяли подключениям;

  • иметь актуальный рабочий срок действия;

  • имя сертификата и секретного ключа должно включать в себя имя домена SIP (sip domain name).

  1. Необходимо предоставить доступ к:

  • rep-box.webinar.ru;

  • on-premise-reg.webinar.ru;

  • репозиториям операционной системы (Debian, РЕД ОС или Astra), в которой разворачивается ПО, и/или их зеркалам.

Установка

  1. Важно!
    В первую очередь должна осуществляться установка компонента MCU Vinteo, так как на этом сервере будет создан пользователь, логин и пароль которого необходимо указать во время последующей установки компонента WRC.
  2. Загрузить на сервер файл установочного скрипта (расположен по ссылке) командой:
    wget https://rep-box.webinar.ru/latest/webinar/mts-link-installer.sh 

  3. Присвоить файлу права на запуск командой:
    chmod +x mts-link-installer.sh 

  4. Открыть файл от имени пользователя с root-привилегиями командой с ключом:
    sudo ./mts-link-installer.sh --sip 

  5. В процессе исполнения программа поставит все необходимые компоненты и запросит дополнительные данные:

    • имя домена SIP (sip domain name) (см. раздел «Настройка доменов»);
    • имя основного домена (main domain name). Это имя основного сервера, на котором установлено ПО МТС Линк on-premise. Встречи;
    • имя домена Vinteo (vinteo domain name). Задается на этапе установки компонента MCU Vinteo (см. раздел «Настройка домена» «Руководства по установке SIP-коннектора (Vinteo) ПО МТС Линк on-premise для пилотного проекта или продуктивной среды»);
    • имя пользователя Vinteo и пароль (vinteo user/vinteo password). Они формируются на этапе установки компонента MCU Vinteo;
    • имя пользователя и пароль (user/password). Они необходимы для доступа к репозиториям;
    • в некоторых случаях нужно будет подтвердить запрос на перезапись уже существующего объекта (‘/etc/apt/trusted.gpg.d/docker-archive-keyring.gpg’).

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

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

1. Для выполнения настроек конфигураций после завершения установки компонента необходимо выполнить команду в консоли управления на сервере с установленным ПО МТС Линк on-premise. Встречи:
./mts-link-installer.sh --sipcfg 

И далее указать имя домена SIP (sip domain name).

Важно!

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

2. После выполнения настроек нужно в файле конфигураций Odin (/opt/webinar/media/odin/config.json) изменить значение параметра «networkDriver» на «ro» (по умолчанию имеет значение «raw»).


После изменений необходимо перезапустить докер-контейнер, выполнив следующие команды:

docker-compose -f /opt/webinar/media/docker-compose.yml down

docker-compose -f /opt/webinar/media/docker-compose.yml up -d


Интерфейс администрирования и финальные настройки

👆 На этом пока всё