Upgrade, backup, restore y uninstall

Inventario previo

Antes de cambiar nada registra versión, variante del paquete, digest del asset, servicios/procesos activos y configuración de destino. Guarda el inventario con el backup, sin imprimir secretos.

Backup frío verificado

1. Detén ordenadamente sólo los servicios o procesos que estaban activos.
2. Archiva /etc/spot, /var/lib/spot y /var/lib/spot-agent-sap en system; en portable, config, data y run bajo $SPOT_HOME.
3. En suite embedded incluye los datos locales Elasticsearch. En external, SPOT no copia el cluster: usa el snapshot del operador Elasticsearch.
4. Genera sha256sum BACKUP > BACKUP.sha256 y ejecuta sha256sum -c.
5. Al terminar, reinicia exactamente el conjunto que estaba activo.

Guarda el backup fuera del árbol actualizado y protege sus credenciales.

No excluyas /var/lib/spot/license: contiene la licencia instalada, el histórico verificable y la identidad local de esa instalación. En portable se encuentran bajo $SPOT_HOME/data/license. Restaurarlos juntos conserva la continuidad; no copies ese estado a otro host. Si el cambio coincide con una renovación, genera primero un paquete nuevo según Licencias y renovación.

Upgrade dentro de la variante

Instala el mismo nombre de paquete con rpm -Uvh o dpkg -i. El upgrade detiene los servicios antes activos, sustituye código/librerías por payload root-owned limpio y reinicia sólo ese conjunto. También elimina del spot.env heredado variables reservadas de carga y de identidad del paquete. Configuración mutable y datos se preservan; un archivo extraño insertado en un árbol ejecutable antiguo no se conserva.

La suite embedded respeta las dependencias del paquete: Elasticsearch arranca antes que backend y agent. El agent no intenta su bootstrap hasta que el servicio local de Elasticsearch ya ha sido arrancado.

En la suite embedded, /etc/spot/elasticsearch contiene configuración JVM ejecutable y se repone desde defaults confiables durante el upgrade. Personaliza Elasticsearch mediante las opciones soportadas por SPOT, no añadiendo ficheros JVM allí. Los índices permanecen en /var/lib/spot/elasticsearch y sí forman parte del backup frío.

En portable extrae la nueva versión en otro directorio, copia sólo estado documentado y conserva la generación anterior hasta validar health e ingesta.

Restore y rollback

Prueba restore sobre la misma versión y variante: instala primero ese paquete, mantén servicios parados, verifica el backup, restaura estado y ownership y valida health/ingesta. Para rollback instala primero la versión anterior y sólo después restaura su backup compatible.

Migraciones

• Embedded a external: usa el asistente; requiere backup frío y no mueve históricos.
• External a embedded: backup, desinstalación y fresh install de spot-suite.
• Portable external a embedded: usa un $SPOT_HOME nuevo.

Uninstall y purge

La desinstalación normal (rpm -e o dpkg -r) detiene servicios y conserva configuración/datos para recuperación. Purge es una acción posterior, destructiva y explícita: verifica antes el backup y elimina sólo rutas SPOT inventariadas. Para recuperar, reinstala primero la misma versión y variante y aplica el restore.

Verificación final

Comprueba health, servicios esperados, listener 8080, loopback 9200/9300 únicamente en embedded, ausencia completa de payload Elastic en external y connector-only, y que las cuentas runtime no puedan modificar /opt/spot ni /etc/spot/elasticsearch.