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

Описание

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

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

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

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

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

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

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

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

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

Настройка

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

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

1.2. Авторизоваться в мастер-домене под учетной записью admin:

login

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

root
setup 01

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

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

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

3.1. Открыть в левом меню раздел "Домен" - "Параметры".
3.2. Найти параметр meet_config.
3.3. Указать минимальные необходимые параметры конфигурации сервера EraMeet:

  • era.defaultDomain – домен era в рамках которого будут сохраняться данные EraMeet сервером по умолчанию

  • https.domain – домен по которому будет выполняться подключение к EraMeet по websocket secure, в рамках инструкции - develop.era-platform.ru

  • reportPassword – пароль для доступа к monitoring, report и т.д.

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

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

Указать сертификаты в параметрах certificate_pem и meet_cert_pem.

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

setup cert pem
Figure 2. Пример значения certificate_pem
setup meet cert pem
Figure 3. Пример значения meet_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,
      "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 (т.к. сертификат выписан на данное доменное имя) и авторизоваться указав домен develop.era-platform.ru.

  • Запустить приложение "ВКС" (если приложения нет, то обновить страницу оно должно появиться в течении минуты после назначении роли meet пользователю).

  • Открыть веб-приложение "ВКС"

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

meet client app
  • Создать комнату и проверить работу микрофона и камеры.

Проверка завершена