Actualizaciones

Qué significa "actualizar"

Tanto C21 Live Control como C21 Live Encoder se actualizan reejecutando su instalador en modo update. La versión es el tag de release cara al cliente (una versión semántica publicada por Cires21).

Flujo de actualización de C21 Live Control

livecontrol update --check               # Dry-run — chequea versiones y compatibilidad
livecontrol update <version>             # Actualiza a una versión específica
livecontrol update <version> --no-backup # Omite el backup previo (no recomendado)
livecontrol update <version> --force     # Salta los prompts de confirmación y permite reinstalar la misma versión

La actualización ejecuta estos pasos en orden:

1. Backup previo — se toma automáticamente salvo que se use --no-backup. Incluye configuración y dump de base de datos.
2. Pull — se descarga el nuevo set de imágenes desde el registry de Cires21.
3. Aplicar — los contenedores en marcha se paran y se reemplazan con las imágenes nuevas.
4. Migrar — se ejecutan las migraciones de base de datos incluidas en la release.
5. Health check — el instalador espera a que el stack quede sano.
6. Limpieza — se podan las imágenes viejas.
7. Rollback (automático) — si algún paso falla, el instalador restaura el backup previo y vuelve a levantar la versión anterior. La instancia queda en el estado previo a la actualización.

Para hacer rollback manualmente tras una actualización exitosa, restaura el backup previo:

sudo livecontrol restore               # Lista backups disponibles (`/var/backups/livecontrol/`)
sudo livecontrol restore <pre-update>  # Restaura desde el backup nombrado

En el encoder, los backups viven en /var/backups/c21/system/*.tar.gz. Mismo patrón: sudo liveencoder restore lista, sudo liveencoder restore <fichero> restaura.

Flujo de actualización de C21 Live Encoder

curl -fsSL https://get.cires21.com/liveencoder | sudo -E bash -s -- --upgrade -y

El instalador descarga el nuevo set de imágenes del encoder y reemplaza los contenedores en marcha. Cuando el upgrade incluye actualización de driver o kernel que requiera reboot, el instalador reinicia el host y retoma la actualización automáticamente tras el boot.

Rollback

Hay dos rutas para rollback del encoder:

• Desde el CLI: sudo liveencoder update <previous-version>.
• Desde el tarball del bootstrap: curl -fsSL https://get.cires21.com/liveencoder | sudo -E bash -s -- --upgrade --version <X> -y.

Coordina el rollback con el lado de Live Control para que la ventana de compatibilidad siga siendo válida (ver abajo).

Compatibilidad

La versión instalada de Live Control y la del Encoder están emparejadas — cada release set se prueba contra una ventana de compatibilidad. Cuando las versiones se separan fuera de la ventana, Live Control expone los Devices afectados en la página de Devices con un indicador de version-mismatch y los Live streams afectados rechazan arrancar hasta que el encoder se actualice a una release compatible.

Al actualizar en producción, el orden recomendado es:

1. Actualizar Live Encoder primero en una ventana de mantenimiento (uno a uno si hay varios desplegados).
2. Verificar que el Encoder reporta sano y ejecutar un Live stream de prueba.
3. Actualizar Live Control en su propia ventana de mantenimiento.

El orden inverso también es válido cuando la nueva release de Live Control anuncia retrocompatibilidad con la release previa del Encoder — verifícalo en las release notes.

Cross-links

• Instalar C21 Live Control
• Instalar C21 Live Encoder
• Licencias — verifica que la licencia sigue siendo válida tras un cambio mayor de versión.
• Devices — la superficie que expone la versión del encoder en cada Device registrado.