Inicio rápido¶

Esta página lleva una máquina vacía hasta un canal reproduciéndose. Todo ocurre en esa única máquina: el paquete catena la convierte en una instalación completa —plano de control y streamer en un mismo proceso— y aprovisiona su propia base de datos por el camino.

Aquí no se configura PostgreSQL, ni streamers, ni un clúster. Eso viene después, cuando la instalación crece más allá de un solo servidor.

Qué hace falta¶

• Una máquina con Ubuntu 24.04 y acceso root.
• Acceso saliente a internet — la licencia se activa en línea.
• Un archivo con la clave de licencia (license.txt). Catena no arranca sin él.

Conectar el repositorio¶

Los paquetes vienen del repositorio de Flussonic:

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

Colocar la licencia¶

Coloque el archivo de licencia antes de instalar, para que el servicio arranque justo después de la instalación:

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

Si no tiene el archivo a mano, puede saltarse este paso: la instalación pide la clave y la escribe por su cuenta.

Instalar¶

apt install --install-recommends catena

Basta con un paquete. catena convierte esta máquina en una instalación de Catena e instala automáticamente las dependencias necesarias: el servidor de streaming de la versión correspondiente y PostgreSQL.

--install-recommends importa: los plugins del transcodificador (sapsan-transcoder) son una dependencia recomendada, no obligatoria — el servidor funciona sin ellos, pero no se puede codificar nada. Apt instala los paquetes recomendados por defecto, así que en un sistema estándar la opción no cambia nada; en un host configurado con APT::Install-Recommends "false" es lo que mantiene disponible la transcodificación.

Durante la instalación, el paquete catena:

• crea el rol y la base de datos catena en PostgreSQL;
• genera una contraseña para la base de datos y otra para el administrador, y escribe ambas en /etc/catena/secrets.env (modo 0600, propiedad de root);
• arranca catena.service, que aplica el esquema de la base de datos en su primer arranque.

Las contraseñas nunca se imprimen en el terminal: se leen del archivo. Reinstalar o actualizar el paquete reutiliza los secretos existentes en lugar de rotarlos.

Iniciar sesión¶

Lea la contraseña del administrador:

grep EDIT_AUTH_PASSWORD /etc/catena/secrets.env

Abra http://<dirección-del-servidor>/ en un navegador e inicie sesión como admin con esa contraseña. Llegará al Panel de control: un streamer —esta máquina— y ningún canal todavía.

Crear el primer canal¶

Vaya a Canales. Una instalación recién hecha no tiene ninguno.

Escriba quickstart como nombre y pulse Crear. El canal se abre en la pestaña Fuentes, sin nada configurado aún.

Pulse + Añadir fuente y ponga su protocolo en Synthetic — un generador integrado, para verificar la reproducción antes de conectar una fuente real. Marque Generate video (SMPTE bars) y Generate audio (beep/bop): los valores por defecto que aparecen (1280×720 a 25 fps, 48 kHz estéreo) son los que quiere. Pulse Guardar.

El generador emite fotogramas sin comprimir, que ningún reproductor corriente lee, así que el canal necesita además un transcodificador. Abra la pestaña Proceso y pulse Standard ladder 1080/720/360 + AAC — un solo preset cubre todo el trabajo. Pulse Guardar.

Central registra el canal y lo asigna al streamer. En unos segundos el canal aparece como en marcha.

Reproducirlo¶

Vuelva a la pestaña Configuración básica. La página del canal lleva un reproductor integrado: las barras de prueba con un reloj en marcha significan que todo el camino funciona — fuente, transcodificador, streamer y reproducción.

El mismo canal está disponible para cualquier reproductor externo en http://<dirección-del-servidor>/streaming/v/quickstart/index.m3u8.

Si algo salió mal¶

Revise el servicio y su registro:

systemctl status catena
journalctl -u catena -n 50

• El servicio no está en marcha y el registro menciona la licencia. El archivo de licencia no estaba presente en el momento de la instalación. Póngalo en /etc/catena/license.txt y ejecute systemctl start catena.
• La instalación informó de que PostgreSQL no era accesible. La base de datos no se aprovisionó. Créela usted mismo, escriba DATABASE_URL en /etc/catena/secrets.env y ejecute systemctl restart catena.
• El reproductor dice que no puede cargar el vídeo. El canal está en marcha, pero no sale de él nada reproducible — casi siempre es un transcodificador ausente: el generador sintético produce fotogramas en bruto, y un reproductor necesita H.264 y AAC. Revise la pestaña Proceso.
• El transcodificador está configurado y aun así el canal no produce nada. Compruebe que los plugins de codificación estén instalados: dpkg -l | grep sapsan-transcoder. Si solo está el paquete -base, la máquina se instaló sin los paquetes recomendados — ejecute apt install --install-recommends catena.
• El canal existe pero no arranca. Mire la página del canal: muestra si el canal ha sido colocado en un streamer y si su fuente está viva.

Hacia dónde seguir¶

Todo esto cabe en esta única máquina, sin configuración adicional:

• conectar fuentes reales, configurar fuentes de reserva y la conmutación entre ellas;
• añadir transcodificación multibitrate, grabación del archivo y nPVR;
• configurar la reproducción y su autorización.

Cuando una máquina deje de bastar, añada una segunda: el plano de control que ya tiene se queda donde está, no se desmonta nada.