Настройка ВКС (meet)

Описание

ВКС Эра является сервером аудио и видео конференций, реализующим модель SFU. Медиатраффик перенаправляется между участниками конференции с ручной и автоматической регулировкой качества в зависимости от настроек и ширины канала связи. При этом обработка и микширование траффика осуществляется только при обработке файлов записи, поэтому загрузка ЦП сервера во время конференций минимальна.

Для работы необходим белый IP-адрес, доменное имя и SSL-сертификат.

Веб-сервер по умолчанию использует протокол HTTPS и TCP-порт 443 (можно изменить в файле конфигурации), а для медиа используется динамический диапазон портов 40000-49999 (также можно изменить в файле конфигурации).

Вкс Эра сохраняет данные (о сеансах, комнатах и т.д.) в рамках рабочего домена, поэтому необходим хотя бы один рабочий домен.

Подготовка

В общем случае подготовка состоит из следующих шагов:

  • Определить нужно ли использовать 3 ip адреса: https, ws, turn все на 443 портах. Или достаточно 1: https - 443, wss на произвольном порту

    • 3 отдельных адреса необходимо если будут подключаться клиенты из закрытых сетей, которым разрешено делать запросы только на 80 и(или) 443 порты

  • Определить где будут храниться записи видеоконференций (на каком диске, подключен ли он и т.д.)

  • Проанализировать пропускную способность сети у сервера и потенциальных клиентов и определить нужны ли изменения в конфигурации EraMeet сервера: webRtcTransportOptions. Возможно изменить параметры качества по умолчанию: quality.

  • Подготовить ssl сертификаты (для 1 или 3 используемых доменных имен) для использования EraMeet сервером.

В рамках данной статьи будет рассматриваться базовая настройка:

  • один сервер и используется только под ВКС

  • без дополнительных ip адресов и сертификатов

  • со стандартным расположением файлов записи видеоконференции

  • минимальным изменением конфигурации сервера EraMeet

Настройка

1. Запуск приложения "Настройки"

1.1) Открыть браузер и ввести в адресную строку IP-адрес сервера.

1.2) Авторизоваться в мастер-домене, который был задан при установке на мастер-сервер на шаге 7, под учетной записью admin и аналогичным паролем:

login

1.3) Запустить веб-приложение "Настройки":

root
setup 01

2. Создать дочерний домен

В рамках инструкции создается домен - develop.era-platform.ru, для которого есть выписанный заранее сертификат.
Инструкция по созданию рабочего домена

3. Настроить конфигурацию EraMeet сервера.

3.1. Открыть в левом меню раздел "Домен" - "Параметры".
3.2. Найти параметр meet_config.
3.3. Указать минимальные необходимые параметры конфигурации сервера EraMeet
3.3.1. era.defaultDomain – домен era в рамках которого будут сохраняться данные EraMeet сервером по умолчанию
3.3.2. reportPassword – пароль для доступа к monitoring, report и т.д.

Пример конфигурации EraMeet
{
  "era": {
    "defaultDomain": "develop.era-platform.ru"
  },
  "reportPassword": "new_server_pwd"
}
setup meet config
Figure 1. Конфигурация EraMeet сервера

4. Указать сертификаты

Так как веб-сервер Era выступает как https прокси для сервера EraMeet, то сертификат так же необходимо указать в параметрах cert_pem и meet_cert_pem.

4.1. Открыть в левом меню раздел "Домен" - "Параметры".
4.2. Найти параметр cert_pem и внести в значение сертификат для домена указанного в п.1. в конфигурации сервера EraMeet в defaultDomain (в примере - develop.era-platform.ru).
3.3. Найти параметр meet_cert_pem и внести в значение сертификат для домена указанного в п.1. в конфигурации сервера EraMeet в defaultDomain (в примере - develop.era-platform.ru).

setup meet cert pem
Figure 2. Пример значения meet_cert_pem
setup cert pem
Figure 3. Пример значения cert_pem

5. Активировать роль meet

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

Для активации необходимо:

5.1. Открыть в левом меню раздел "Домен" - "Конфигурации".
5.2. Запустить мастер создания новой конфигурации, не изменяя параметров перейти к просмотру результата

setup config result preview

5.3. Найти в содержимом настройки роли meet и установить параметр роли "enabled": true.

setup config meet enabled
Пример параметров роли
    {
      "_comment": "role is disabled. set enabled to true.",
      "enabled": true,
      "group": 370,
      "iface": "eth0",
      "listeniface": "eth0",
      "name": "meet1",
      "order": 1,
      "port": 4123,
      "roleid": 11400,
      "roletype": "meet",
      "separate": true
    }

5.4. Сохранить конфигурацию и активировать её.

6. Настройка пользователя

6.1. Назначить пользователю роль "meet" через приложение "Настройки"

setup user role meet

Настройка завершена.

Проверка результата

  • Ввести в адресную строку браузера - https://develop.era-platform.ru (т.к. сертификат выписан на данное доменное имя) и авторизоваться в ситеме.

  • Выйти из приложения "Настройки", приложение "ВКС" отобразится в списке примерно через минуту.

  • Перейти в веб-приложение "ВКС"

root apps goto meet
  • Должно отобразиться клиентское приложение EraMeet

meet client app