Inicio rápido¶

Esta página lleva una máquina limpia hasta una transmisión en marcha. Todo ocurre en esa máquina: el paquete agora la convierte en una instalación completa — el plano de control y un streamer en un mismo proceso — y de paso prepara su propia base de datos.

Aquí no se configuran la base de datos, los streamers ni el clúster. Eso viene después, cuando la instalación se le quede pequeña a un solo equipo.

Qué hace falta¶

• Una máquina con Ubuntu 24.04 y acceso root.
• Acceso a internet: la licencia se activa en línea.
• Una clave de licencia. Cópiela de su cuenta en my.flussonic.com: la instalación pide la clave por sí misma, no hace falta crear license.txt a mano.

Añadir el repositorio¶

Los paquetes están en el 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 agora

La instalación pide la clave de licencia: pegue la que copió de su cuenta. El paquete la escribe él mismo en /etc/agora/license.txt (propietario root, modo 0600). Puede dejar la respuesta vacía: el paquete se instala, pero el servicio no arranca hasta que haya una clave. Si la máquina ya tiene un fichero de licencia, la pregunta no se hace: una actualización no vuelve a preguntar nada.

Basta con un paquete. agora convierte esta máquina en una instalación de Agora y arrastra todo lo necesario para ello.

--install-recommends no es adorno aquí: los plugins del transcodificador son una dependencia recomendada, no obligatoria. El servidor funciona sin ellos, pero no tiene con qué codificar. Apt instala los paquetes recomendados por defecto, así que en un sistema corriente el flag no cambia nada; en un host con APT::Install-Recommends "false" es justo lo que mantiene la codificación funcionando.

Durante la instalación, el paquete agora:

• crea el rol y la base de datos agora;
• genera la contraseña de la base de datos y la del administrador y escribe ambas en /etc/agora/secrets.env (modo 0600, propietario root);
• arranca agora.service, que en su primera ejecución aplica el esquema de la base de datos.

Las contraseñas no se imprimen en el terminal: se leen del fichero. Reinstalar y actualizar el paquete reutilizan los secretos ya escritos en lugar de regenerarlos.

Entrar en el panel¶

Lea la contraseña del administrador:

grep EDIT_AUTH_PASSWORD /etc/agora/secrets.env

Abra http://<dirección-del-servidor>/ en un navegador y entre como admin con esa contraseña.

Llegará al panel. Vaya a Streams: una instalación recién hecha todavía no tiene ninguno.

Crear la primera transmisión¶

Escriba el nombre townhall y pulse Crear. La transmisión se abre en la pestaña Fuentes, donde aún no hay nada configurado.

Ya hay una fila de fuente vacía. Elija en ella el protocolo Synthetic — el generador incorporado, que permite comprobar la reproducción antes de conectar un estudio real al servidor. Marque las dos casillas — Generar vídeo (barras SMPTE) y Generar audio (beep/bop): los valores que se rellenan solos (1280×720 a 25 fps, 48 kHz estéreo) son justo los que hacen falta. Pulse Guardar.

Unos segundos después aparece sobre el formulario una tarjeta con los parámetros de la entrada: el servidor tomó la señal y la analizó.

Activar el transcodificador¶

El generador entrega vídeo y audio sin comprimir, que ningún reproductor entiende, así que la transmisión hay que codificarla. Vaya a la pestaña Transcodificador y pulse el preset Escalera estándar 1080/720/360 + AAC: configura tres resoluciones de una vez, tal como las necesita una transmisión real — el portátil de la oficina toma la de arriba, el teléfono por VPN la de abajo. Pulse Guardar.

Ver la transmisión¶

Vuelva a la pestaña Ajustes básicos. En cuanto el servidor haya ensamblado los primeros segmentos, el reproductor incorporado muestra la imagen del generador, y encima de él, qué llegó a la entrada y qué salió por la salida.

Una máquina funciona. A continuación:

• Administradores — cree cuentas reales en lugar de la de emergencia.
• Transmisiones — conecte una fuente real en lugar del generador.
• Clúster — añada un segundo servidor cuando uno deje de bastar.