Copia de seguridad¶

La configuración de Agora — streams con sus fuentes, ajustes del transcodificador, envíos, plantillas, zonas de entrega, política de acceso, ajustes de los streamers — vive en la base de datos del plano de control. La sección Clúster → Copia de seguridad la descarga como archivo y la vuelve a subir.

La copia hace falta en dos casos:

• el equipo se perdió — el servidor, un disco o la base de datos ya no están, y hay que levantar la configuración en una máquina nueva sin volver a teclear cien streams;
• reversión — un cambio desafortunado se deshace más fácilmente con una copia hecha antes de él que recordando cómo estaba todo.

La sección solo la ve un superadministrador: el archivo de la copia lleva los secretos de la instalación.

Qué contiene la copia¶

• Streams — con todos sus ajustes: fuentes, transcodificador, envíos, archivo.
• Plantillas y zonas CDN.
• Política de acceso — cómo se protege la reproducción.
• Ajustes de central y políticas de grabación.
• Ajustes de streamers — lo que se edita en la ficha del streamer: discos de archivo y lo demás.
• Catálogo VOD — las descripciones de los activos y en qué discos de qué streamers están sus archivos. Los archivos multimedia no entran en la copia: se quedan en los discos.

La copia no contiene:

• La composición del clúster — qué máquinas se unieron y con qué claves. La clave de un streamer se emite cuando la máquina se une y se guarda en el propio streamer; una copia con las claves antiguas no serviría de nada tras una reinstalación.
• Los administradores. Una lista de administradores restaurada dejaría fuera a quien hace la restauración.
• El historial — el registro de auditoría, las sesiones de espectadores, las estadísticas.
• Los medios — el archivo y los archivos VOD.

El archivo de la copia contiene secretos: claves DRM y contraseñas en las direcciones de fuentes y envíos. Guárdelo con el mismo cuidado que el propio servidor: no lo envíe por correo ni lo deje en carpetas compartidas.

Cómo hacer una copia¶

1. Abra Clúster → Copia de seguridad y pulse Crear copia.
2. La copia se prepara en segundo plano. Mientras tanto, su fila en la lista Copias muestra en curso. No hace falta quedarse en la página: la copia terminada se puede recoger más tarde.
3. Cuando el estado pase a lista, pulse Descargar. El archivo se llama agora-config-<fecha>-<número>.jsonl.gz.

La copia no se guarda en un directorio del disco, sino en la base de datos del plano de control, junto a la configuración; por eso cualquier instancia de central puede servir la descarga. En una instalación con Docker es el volumen de la base de datos PostgreSQL. Ahí las copias viven 30 días y luego se eliminan.

La consecuencia principal: una copia en el equipo muere junto con la base de datos. Ante un desastre solo sobrevive el archivo descargado: sáquelo del equipo.

Haga una copia antes de un cambio notable: antes de mover streams, cambiar la política de acceso o editar plantillas en bloque.

Cómo restaurar¶

La restauración tiene tres pasos: subir el archivo, revisar el plan, confirmar. Antes de la confirmación la configuración no cambia.

1. En el bloque Restauraciones pulse Subir archivo y elija el archivo de la copia.
2. El equipo lee el archivo y construye un plan: qué cambiará exactamente. La fila de la restauración pasa a espera confirmación. Púlsela para abrir el plan.
3. Revise el plan y pulse Restaurar.

Cómo leer el plan¶

El plan es una tabla por secciones de la copia:

• Crear — no existe en el equipo; aparecerá.
• Sobrescribir — existe, pero es distinto; la versión de la copia sustituye a la del equipo.
• Eliminar — existe en el equipo, pero no en la copia. La restauración devuelve la configuración al momento de la copia, así que los streams creados después de la copia se eliminarán. Sus nombres aparecen bajo la fila de la sección; léalos antes de confirmar.
• Sin cambios — coincide con la copia.
• Espera un streamer — ajustes de un streamer que aún no tiene máquina (véase Streamer aplazado).

El catálogo VOD se restaura solo añadiendo: los activos que no están en la copia se quedan donde están. Eliminar un activo borra sus archivos de los discos, y una reversión no debe hacerlo.

Si el plan tiene errores — por ejemplo, la copia contiene más streams de los que permite la licencia del equipo nuevo —, el botón Restaurar queda bloqueado hasta corregir la causa.

Si alguien cambia la configuración entre el momento en que se mostró el plan y la confirmación, el equipo recalcula el plan y pide confirmarlo de nuevo: solo se aplica el plan que usted vio.

La restauración deja huella en el registro de auditoría: una entrada config_restore.apply y entradas por cada stream, plantilla y zona modificados con el número de la restauración.

Un clúster de varios streamers¶

En un solo equipo eso es toda la restauración. En un clúster queda otra pregunta: qué máquina recibe los ajustes de qué streamer.

Por qué los streamers no vuelven solos a su sitio¶

Cada streamer del clúster tiene un número que el equipo le da cuando la máquina se une. Los ajustes del streamer están ligados a ese número. Un equipo nuevo con la base de datos limpia vuelve a dar los números en el orden en que se unen las máquinas: la que era el streamer n.º 3 puede ser ahora el n.º 2, y el n.º 3 le toca a otra máquina. Restaurar los ajustes por número entregaría los discos de archivo de una máquina a otra.

Por eso la copia guarda los ajustes de cada streamer junto con las señas de su máquina: su identidad (el identificador del servidor, el mismo que ve la licencia) y su nombre de host. Al restaurar, el plan busca una máquina para ellos:

• el streamer local del equipo recibe sus ajustes automáticamente;
• la misma máquina — un streamer que se unió al clúster nuevo con la misma identidad se reconoce automáticamente, tenga el número que tenga;
• el resto lo decide usted: elige un streamer en el plan o deja la decisión para más tarde.

El nombre de host por sí solo no lleva a una asignación: las máquinas desplegadas desde una misma imagen suelen compartirlo. En el plan es una pista para usted.

Ejemplo¶

Un equipo y dos streamers, edge-1 y edge-2, llevan cuatro cámaras con archivo. La copia se hace en el clúster en marcha:

Después el equipo se pierde junto con su base de datos. edge-1 sobrevive, edge-2 se pierde, y se prepara una máquina nueva, edge-3, para sustituirlo.

Mientras no hay equipo, los streamers siguen llevando los streams que tenían: conservan la última configuración recibida y solo dejan de recibir cambios.

Orden de la restauración¶

1. Instale un equipo nuevo — el paquete agora, como en la primera instalación (véase Instalación). Entre con las credenciales estáticas de /etc/agora/secrets.env y cree el primer administrador (véase Administradores): los administradores no están en la copia.
2. Abra la ventana de incorporación: Clúster → Streamers → Permitir unión (véase Incorporar un servidor).

3. Recupere los streamers supervivientes. El equipo nuevo no conoce la clave emitida por el perdido, y la máquina no entrará sola: en el registro del streamer aparece como node key rejected. En cada streamer superviviente escriba el token nuevo en la línea JOIN_TOKEN= de /etc/agora/secrets.env (y la dirección del equipo en CENTRAL_URL=, si ha cambiado), elimine la clave antigua y reinicie el servicio:

   rm /var/lib/agora/identity.json
   systemctl restart agora
   

   Elimine solo el archivo de la clave. No toque el resto de /var/lib/agora: ahí está también la identidad de la máquina, por la que el plan la reconoce y a la que está ligada la licencia. Mientras se reinicia, los streams de esta máquina se interrumpen.

4. Instale las máquinas de sustitución — el paquete agora-base con el mismo token, como en cualquier ampliación del clúster (véase Instalación).

5. Compruebe la composición en Clúster → Streamers. Las máquinas tienen números nuevos: edge-1 se unió en segundo lugar y recibió el n.º 2. Los streamers aún no tienen ajustes — ni discos de archivo ni direcciones, de ahí la marca de dirección ausente: los devuelve la copia.

   

6. Suba la copia y abra el plan. El bloque Streamers muestra adónde irán los ajustes de cada streamer de la copia: el local al local, edge-1 reconocido como la misma máquina y edge-2 sin máquina, así que la elección es suya.

   

7. Elija una máquina para el streamer no reconocido. La lista contiene los streamers libres del clúster nuevo. La marca misma máquina aparece junto al candidato con la misma identidad; edge-3 no la tiene, es otra máquina, y elegirla es decisión suya. Si la máquina de sustitución aún no está lista, deje Más tarde.

   

8. Pulse Restaurar. La configuración se aplica, y el equipo ubica los streams en los streamers igual que tras cualquier otro cambio.

Streamer aplazado¶

Los ajustes aplazados se guardan en la ficha de la restauración junto con las ubicaciones de los archivos VOD en los discos de esa máquina. Mientras no se aplican, el clúster no tiene ninguna máquina con esos ajustes: los streams con archivo se ubican en los streamers que ya tienen discos. En el ejemplo las cuatro cámaras van a edge-1.

Cuando la máquina de sustitución se una al clúster, abra la ficha de la restauración, elíjala en el bloque Streamers que esperan sus ajustes y pulse Aplicar al streamer.

El streamer recibe los ajustes de la copia — discos de archivo y lo demás —, y el equipo puede volver a ubicar trabajo en él. Una máquina de sustitución conserva sus propias direcciones: la copia solo lleva las direcciones a la misma máquina; de lo contrario central seguiría llamando a la perdida. Si el streamer aparece sin dirección, escríbala en su ficha.

Los ajustes aplazados solo los aplica un operador, con el botón. Una máquina que se une al clúster no toma por sí sola los ajustes de otra: la incorporación de una máquina no debe cambiar la configuración sin una persona.

Reversión en un clúster en marcha¶

Si el equipo está intacto y la copia hace falta para deshacer un cambio desafortunado, los pasos de reinstalación no son necesarios: los streamers siguen en el clúster con sus números e identidad, y el plan los asigna automáticamente. Suba la copia, lea lo que dice la columna Eliminar y confirme.