Тестовый экземпляр на том же хосте¶
Важно
Бета-версия 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) такой порт делится с рабочим узлом, и часть
подключений уходит к тестовому экземпляру.
Неверное значение ключа останавливает запуск с сообщением об ошибке.
Как запустить¶
Создайте каталог настроек тестового экземпляра, например
/opt/pss-test/config, и скопируйте в негоpss.propertiesрабочего узла.В этой копии
pss.propertiesзадайте свои пути: как минимум каталог журналаlog-dir, а также каждый путь к данным, который там задан. Иначе оба экземпляра пишут в один журнал и одну базу статистики.Задайте тестовому экземпляру свои порты в его настройках: порты веб-интерфейса (Веб-сервер и учётные записи), OTT-сервера, включая HTTPS и HTTP/3 (Потоковый HTTP-сервер), и EPG-сервера (EPG-сервер). Порт, который уже слушает рабочий узел, тестовому экземпляру не достанется, если экземпляр запущен с ключом
--bind-addressили--isolated. Если в настройках включён RTMP-сервер (RTMP-сервер), задайте ему другие порты или выключите его (RTMP-порт 0, RTMPS выключен): ключи--bind-addressи--isolatedна него не действуют.Запустите экземпляр с каталогом настроек и ключами:
$ 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
тестовый экземпляр не меняет лицензию хоста: обновить или перенести её из него нельзя.