Быстрый старт¶

Эта страница доводит одну чистую машину до играющего канала. Всё происходит на ней одной: пакет catena превращает её в полноценную установку — управляющий контур и стример одним процессом — и попутно заводит себе базу.

PostgreSQL, стримеры и кластер вы здесь не настраиваете. Это придёт позже, когда установка перерастёт одну коробку.

Что понадобится¶

• Машина с Ubuntu 24.04 и доступом root.
• Доступ в интернет — лицензия активируется онлайн.
• Файл с лицензионным ключом (license.txt). Без него Catena не стартует.

Подключите репозиторий¶

Пакеты лежат в репозитории Flussonic:

curl -L http://apt.flussonic.ru/repo/master/dev.key > /etc/apt/trusted.gpg.d/dev.gpg
echo "deb http://apt.flussonic.ru/branch/sapsan/master repo/" > /etc/apt/sources.list.d/flussonic.list
apt update

Положите лицензию¶

Положите файл лицензии до установки, чтобы сервис поднялся сразу после неё:

mkdir -p /etc/catena
cp license.txt /etc/catena/license.txt
chmod 600 /etc/catena/license.txt

Если файла под рукой нет, шаг можно пропустить: установка спросит ключ и запишет его сама.

Установите¶

apt install --install-recommends catena

Одного пакета достаточно. catena делает эту машину установкой Catena и тянет за собой всё, что для этого нужно: стриминговый сервер соответствующей версии и PostgreSQL.

--install-recommends здесь не для красоты: плагины транскодера (sapsan-transcoder) — рекомендуемая зависимость, а не обязательная. Сервер работает и без них, но кодировать будет нечем. Apt ставит рекомендуемые пакеты по умолчанию, поэтому на обычной системе флаг ничего не меняет; на хосте с APT::Install-Recommends "false" именно он сохраняет транскодирование рабочим.

При установке пакет catena:

• создаёт роль и базу catena в PostgreSQL;
• генерирует пароль базы и пароль администратора и пишет оба в /etc/catena/secrets.env (режим 0600, владелец root);
• запускает catena.service, который на первом старте накатывает схему базы.

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

Войдите в интерфейс¶

Прочитайте пароль администратора:

grep EDIT_AUTH_PASSWORD /etc/catena/secrets.env

Откройте в браузере http://<адрес-сервера>/ и войдите как admin с этим паролем. Вы попадёте на Панель управления: один стример — эта самая машина — и пока ни одного канала.

Заведите первый канал¶

Перейдите в Каналы. На свежей установке их ещё нет.

Введите имя quickstart и нажмите Create. Канал откроется на вкладке Sources, где пока ничего не настроено.

Нажмите + Add Source и выберите протокол Synthetic — встроенный генератор, чтобы проверить воспроизведение до подключения реального источника. Отметьте обе галочки — Generate video (SMPTE bars) и Generate audio (beep/bop): подставившиеся значения (1280×720 при 25 кадрах, 48 кГц стерео) как раз те, что нужны. Нажмите Save.

Генератор отдаёт несжатые кадры, которые обычный плеер не читает, поэтому каналу нужен ещё и транскодер. Откройте вкладку Process и нажмите Стандартная лестница 1080/720/360 + AAC — один пресет закрывает всю задачу. Нажмите Save.

Central записывает канал и передаёт его стримеру. Через несколько секунд канал показывается запущенным.

Посмотрите его¶

Вернитесь на вкладку Basic Settings. На странице канала есть встроенный плеер: тестовые полосы с бегущими часами означают, что весь путь работает — источник, транскодер, стример, воспроизведение.

Тот же канал доступен любому внешнему плееру по адресу http://<адрес-сервера>/streaming/v/quickstart/index.m3u8.

Если что-то пошло не так¶

Посмотрите сервис и его лог:

systemctl status catena
journalctl -u catena -n 50

• Сервис не запущен, в логе упоминается лицензия. На момент установки файла лицензии не было. Положите его в /etc/catena/license.txt и выполните systemctl start catena.
• Установка сообщила, что PostgreSQL недоступен. База не заведена. Создайте её сами, впишите DATABASE_URL в /etc/catena/secrets.env и выполните systemctl restart catena.
• Плеер пишет, что не может загрузить видео. Канал работает, но наружу не выходит ничего воспроизводимого — почти всегда это отсутствующий транскодер: синтетический генератор отдаёт сырые кадры, а плееру нужны H.264 и AAC. Проверьте вкладку Process.
• Транскодер настроен, но канал всё равно ничего не отдаёт. Проверьте, что плагины кодирования установлены: dpkg -l | grep sapsan-transcoder. Если стоит только пакет -base, коробку ставили без рекомендуемых пакетов — выполните apt install --install-recommends catena.
• Канал есть, но не запускается. Посмотрите страницу канала: там видно, размещён ли канал на стримере и жив ли его источник.

Что дальше¶

Всё это делается на той же одной машине, дополнительной настройки не требуется:

• подключить реальные источники, настроить резервные входы и переключение между ними;
• добавить мультибитрейтный транскодинг, запись архива и nPVR;
• настроить воспроизведение и авторизацию на нём.

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