Instalación¶
Agora se instala desde los paquetes del repositorio de Flussonic. Son dos, y elegir entre ellos es elegir el papel de la máquina.
agora— el equipo entero: el plano de control, el panel y un streamer en una sola máquina. Se instala el primero, y en una instalación pequeña es el único.agora-base— un servidor sin base PostgreSQL propia. Puede unirse al clúster como streamer o convertirse en otra instancia de central sobre la base compartida.
El paquete agora arrastra a agora-base: el equipo es ese mismo servidor más lo que lo convierte en plano de control.
Cómo pasar de una máquina limpia a una transmisión en marcha de una sola vez está en la página Inicio rápido. Lo que sigue es lo que necesita una instalación real.
Qué hace la instalación del equipo¶
Durante la instalación, el paquete agora:
- pide la clave de licencia y la deja en
/etc/agora/license.txt; - crea el rol y la base de datos
agora; - genera la contraseña de la base de datos y la del administrador y las escribe en
/etc/agora/secrets.env(modo0600, 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. Una actualización o una reinstalación reutilizan los secretos ya escritos.
Qué hacer después con esas contraseñas está en Administradores: las credenciales estáticas quedan como la entrada de emergencia, y el trabajo se hace con cuentas nominales.
Qué hace la instalación de un nodo¶
El paquete agora-base pregunta qué va a ser esta máquina:
- Una dirección de base de datos — si la máquina levanta su propio plano de control sobre una base ya existente.
- Unirse a un clúster — si no: la instalación pregunta entonces la dirección del plano de control y un token de acceso.
El token se obtiene en el panel, en Clúster → Streamers, con el botón Permitir la incorporación; la ventana dura una hora (véase Streamers). Tras la instalación el nodo acude solo al plano de control y aparece en la lista.
A una máquina ya configurada no se le vuelve a preguntar: la dirección y el token se escriben una vez, y una actualización del paquete no repite la pregunta.
Dónde se guarda cada cosa¶
/etc/agora/— los ajustes del equipo: el fichero de licencia ysecrets.env./var/lib/agora/— el estado de trabajo.agora.service— la unidad de systemd; con ella se para y se arranca el servicio.
Aquí no hay, a propósito, ficheros con la configuración del clúster: la configuración — transmisiones, plantillas, zonas, permisos — vive en la base de datos del plano de control y se edita en el panel. Una máquina guarda solo lo que la hace ser esa máquina.
Actualización¶
La actualización es un apt corriente:
apt update && apt install --only-upgrade agora
En un clúster se actualiza primero el plano de control y después los nodos. El plano de control tolera nodos más antiguos que él; al revés no está garantizado.
Una actualización no vuelve a pedir la licencia y no toca los secretos. El esquema de la base de datos se pone al día cuando arranca por primera vez la nueva versión.
Qué tiene que permitir la red¶
- Los espectadores necesitan acceso a los streamers, no al plano de control: el plano de control decide adónde enviarlos, pero la transmisión llega de un servidor.
- Los nodos necesitan acceso al plano de control: sin él un nodo sigue funcionando, pero no recibe asignaciones nuevas.
- La instalación necesita acceso saliente para activar la licencia.