Тестовый экземпляр на том же хосте

Важно

Бета-версия 2.1. Описанное здесь есть только в бета-версии 2.1: она ставится из бета-репозитория и только с лицензией, в стабильной версии 2.0.2 и в демоверсии этого нет. Бета-версия поставляется без гарантий, поддержка — по возможности (Программа бета-тестирования).

С версии 2.1.2.612 на хосте, где работает рабочая служба pss, можно запустить второй, тестовый экземпляр стримера — например, чтобы проверить новую сборку на тех же источниках, не останавливая рабочий узел. Тестовый экземпляр работает со своим каталогом настроек и отличается от рабочего тремя ключами командной строки. В файл настроек эти ключи не попадают, поэтому скопированные с рабочего узла настройки их не включат. Без этих ключей стример запускается как раньше.

Ключи запуска

--instance-tag=<метка>

Метка экземпляра: от 1 до 16 символов, строчные латинские буквы, цифры и дефис. Она разводит каналы обмена с транскодерами: без неё два экземпляра с одинаковыми номерами потоков и выходов мешают транскодерам друг друга.

--bind-address=<IPv4-адрес>

Веб-интерфейс, OTT-сервер (HTTP, HTTPS, HTTP/3) и EPG-сервер слушают только этот адрес. Входы и выходы потоков работают со своими адресами из настроек потоков. RTMP-сервер этот ключ не затрагивает (шаг 3 ниже).

--isolated

Экземпляр не обращается наружу: выключены Meshwork и связи с соседями, резерв, внешние получатели алертов (Telegram, почта, webhook, запуск программы) и проверка webhook, получение сертификатов ACME, экстренные оповещения CAP (Автоматические оповещения CAP), LDAP, PMS и DVB; операции с лицензией (обновление, отвязка, перенос) отвечают отказом. Выключены и внешние серверы биллинга (авторизация зрителей через биллинг). Настройки при этом не меняются: всё это выключено только на время работы экземпляра. Собственные потоки экземпляра работают как настроены.

С ключом --bind-address или --isolated порт веб-интерфейса, OTT- или EPG-сервера, который уже занят другим процессом, экземпляр не делит с ним, а получает отказ: в журнале — ошибка Address already in use, при запуске и при каждом применении настроек. Без них (только --instance-tag) такой порт делится с рабочим узлом, и часть подключений уходит к тестовому экземпляру.

Неверное значение ключа останавливает запуск с сообщением об ошибке.

Как запустить

  1. Создайте каталог настроек тестового экземпляра, например /opt/pss-test/config, и скопируйте в него pss.properties рабочего узла.

  2. В этой копии pss.properties задайте свои пути: как минимум каталог журнала log-dir, а также каждый путь к данным, который там задан. Иначе оба экземпляра пишут в один журнал и одну базу статистики.

  3. Задайте тестовому экземпляру свои порты в его настройках: порты веб-интерфейса (Веб-сервер и учётные записи), OTT-сервера, включая HTTPS и HTTP/3 (Потоковый HTTP-сервер), и EPG-сервера (EPG-сервер). Порт, который уже слушает рабочий узел, тестовому экземпляру не достанется, если экземпляр запущен с ключом --bind-address или --isolated. Если в настройках включён RTMP-сервер (RTMP-сервер), задайте ему другие порты или выключите его (RTMP-порт 0, RTMPS выключен): ключи --bind-address и --isolated на него не действуют.

  4. Запустите экземпляр с каталогом настроек и ключами:

    $ sudo /usr/local/bin/pss -c /opt/pss-test/config --instance-tag=test --bind-address=192.0.2.10 --isolated -C
    

    Ключ -C выводит журнал в консоль. Для постоянной работы напишите отдельный systemd-файл службы — копию pss.service со своей строкой ExecStart; пакет второго файла службы не ставит.

Работает ли экземпляр с этими ключами, видно в /data/server: поля instance-tag, isolated="1" и bind-address есть только у экземпляра, запущенного с соответствующим ключом (Управление через HTTP API).

Предупреждение

--isolated не останавливает потоки. Выходы тестового экземпляра — UDP и multicast, публикации SRT и RTMP и другие — уходят в сеть по-настоящему. Не повторяйте в них группы, порты и адреса публикации рабочего узла. Входы читают то, на что указывают: принимать тот же multicast, что и рабочий узел, можно.

Лицензия

Тестовый экземпляр использует тот же ключ защиты, что и рабочий узел. Ограничения лицензии каждый экземпляр проверяет по своим потокам, без сложения с другим. Сетевой ключ с ограничением числа одновременных подключений может отказать второму экземпляру; локальный ключ на этом хосте обычно не отказывает. С --isolated тестовый экземпляр не меняет лицензию хоста: обновить или перенести её из него нельзя.