Actualizaciones del sistema

JelinaOS admite cuatro categorías de actualización: sistema, kernel, agente y actualizaciones incrementales, mediante canales locales o en la nube. Gracias al sistema dual A/B, toda actualización dispone de una vía de reversión.

Componentes actualizables

Componente	Descripción
Sistema (JelinaOS)	Nuevas versiones con mejoras funcionales y correcciones de seguridad
Kernel	Actualizaciones de rendimiento y compatibilidad de hardware
Agente del dispositivo	Actualización del componente de administración
Actualización incremental	Parches incrementales del sistema de rápida implementación

Métodos de actualización

OTA desde la nube (recomendado)

Después de conectar el dispositivo a JelinaCloud, administra las actualizaciones desde las páginas de flotas o dispositivos:

Selecciona la versión de destino del sistema, kernel o agente;
La nube distribuye la actualización según la política, con versiones fijadas y ejecución por etapas;
El dispositivo descarga y aplica la actualización automáticamente, y su estado se muestra en tiempo real en la nube.

La nube también proporciona paquetes de actualización sin conexión para dispositivos sin acceso a la red. Descárgalos y aplícalos en la instalación. También pueden entregarse en medios extraíbles, como memorias USB, y procesarse automáticamente al conectar el medio.

OTA local

Si no utilizas la nube, emplea la herramienta de actualización del dispositivo:

# Consultar versión y estado de actualización
jelina-local-ota -g
jelina-local-ota -s
jelina-local-ota --json --status      # Salida de estado estructurada

# Consultar actualizaciones pendientes de confirmación local
jelina-local-ota --confirmation

# Comprobar previamente el paquete: analizar y validar sin enviarlo
jelina-local-ota --check <paquete-de-actualización>

Después de verificar el paquete, envíalo para aplicarlo. Si está habilitada la confirmación, quedará pendiente hasta que se confirme:

jelina-local-ota <paquete-de-actualización>
jelina-local-ota -c -w    # Confirmar la actualización pendiente y seguir su progreso

Paquetes de un solo componente (.pkg)

El instalador permite aplicar paquetes de un componente, como el agente o componentes de aplicaciones:

jelina-instpackage --pkg-info <paquete-de-componentes.pkg>   # Consultar información del paquete sin instalar
jelina-instpackage <paquete-de-componentes.pkg>              # Instalar un paquete de componentes

Comprueba el origen y la suma de verificación del paquete antes de instalarlo. Algunos componentes requieren reiniciar para activar la actualización.

Tipos de paquetes

JelinaOS utiliza dos formatos de paquete con finalidades y herramientas diferentes:

Tipo	Formato	Finalidad	Herramienta
Paquete de un componente	`.pkg`	Actualizar un componente: sistema, kernel, agente, componente de aplicación, etc.	`jelina-instpackage`
Paquete OTA	`.zip`	Actualización completa con estado deseado y varios componentes, coordinada por el agente	`jelina-local-ota`

Métodos de instalación

Los paquetes de un componente utilizan distintos métodos según el destino:

Método	Descripción
Escritura completa	Escribe en la partición de destino, habitualmente la partición A/B de respaldo
Extracción	Extrae el contenido en una partición, archivo o directorio específico
Instalación incremental	Instala una capa superpuesta sin cambiar de partición
Instalación y ejecución	Instala y ejecuta una vez; de alto riesgo y solo para casos específicos

Una instalación correcta no implica activación

Que el instalador termine correctamente no significa que el nuevo contenido esté activo. El sistema, el kernel y otros componentes requieren reiniciar o volver a montar para activarse. Después de reiniciar, comprueba la versión y la partición realmente utilizadas antes de dar la actualización por terminada.

No intercambiar los dos tipos de paquete

No envíes paquetes OTA (.zip) al instalador de componentes ni instales paquetes .pkg manualmente eludiendo el estado deseado: esto altera el orden de actualización entre componentes;
Aplica los paquetes OTA sin conexión descargados desde la nube mediante jelina-local-ota.

Confirmación de actualizaciones

En instalaciones críticas, las actualizaciones pueden configurarse para ejecutarse solo después de la confirmación local:

La nueva versión se guarda al llegar al dispositivo, sin instalarse inmediatamente;
La ejecución comienza cuando el personal local la confirma;
La confirmación puede realizarse por comando o desde la interfaz del dispositivo;
Hasta entonces, el dispositivo mantiene la versión actual y el personal de la instalación conserva la decisión final.

Proceso y garantías de seguridad

Descargar actualización → Validar integridad → Escribir partición de reserva → Reiniciar y cambiar → Verificar arranque
                                                                                                         │
                                                                                             ✅ Correcto: continuar
                                                                                             ❌ Fallo: reversión automática

Continuidad durante la actualización: la descarga y la escritura se realizan en segundo plano mientras el dispositivo sigue funcionando;
Reversión automática ante fallos: si la validación falla tras la conmutación, se vuelve al sistema anterior;
Reversión de versiones: si una versión aplicada presenta problemas, se puede regresar a la anterior.

Consultar el estado de actualización

jelina-info          # Consultar la versión y la partición de arranque actuales
jelina-local-ota -s  # Consultar el estado y las actualizaciones pendientes

El panel del dispositivo en la nube también muestra las versiones y el estado de actualización.

Recomendaciones

Situación	Recomendación
Mantenimiento periódico	Aplica los parches a tiempo para mantener el nivel básico de seguridad
Cambio de versión	Valida primero en dispositivos de prueba y después implementa por lotes
Sectores con requisitos estrictos de conformidad	Activa la confirmación local y realiza una validación completa previa
Instalaciones con ancho de banda limitado	Utiliza actualizaciones incrementales o paquetes sin conexión

Documentación relacionada

Actualización y recuperación ante desastres — principios y garantías de seguridad
Implementación de aplicaciones desde la nube y OTA — operaciones desde la nube
Sistema dual A/B y conmutación — conmutación y reversión