Inicio rápido¶

Esta página lleva una máquina vacía hasta un stream 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.
• Una clave de licencia. Cópiela del área de cliente en my.flussonic.com: la instalación pide la clave por su cuenta, no hace falta crear ningún license.txt a mano.

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

Instalar¶

apt install --install-recommends catena

La instalación pide la clave de licencia — pegue la que copió del área de cliente. El paquete la escribe por su cuenta en /etc/catena/license.txt (propiedad de root, modo 0600). La respuesta puede dejarse vacía: el paquete se instala, pero el servicio no arranca mientras la clave no esté ahí. Si el archivo de licencia ya está en la máquina, la pregunta no se hace — una actualización no vuelve a preguntar nada.

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 stream todavía.

Crear el primer stream¶

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

Escriba quickstart como nombre y pulse Crear. El stream 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 stream necesita además un transcodificador. Abra la pestaña Transcodificador y pulse Standard ladder 1080/720/360 + AAC — un solo preset cubre todo el trabajo. Pulse Guardar.

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

Reproducirlo¶

Vuelva a la pestaña Configuración básica. La página del stream 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 stream 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. La clave no se introdujo durante la instalación. Póngala 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 stream 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 Transcodificador.
• El transcodificador está configurado y aun así el stream 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 stream existe pero no arranca. Mire la página del stream: muestra si el stream 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.