Actualizaciones y copias de seguridad

Esta página trata de las instalaciones en su propio servidor. Todos los comandos se ejecutan desde el directorio de instalación.

Copias de seguridad

Dos herramientas se complementan:

	Copias de la aplicación	Script de copia del servidor
Dónde	Configuraciones del Sistema → Copias de seguridad	Directorio de instalación
Cuándo	Cada noche, automáticamente, y a demanda	Cuando lo ejecuta o lo programa
Contenido	Datos de gestión y archivos de la aplicación	Todo: datos de gestión, cuentas de usuario, archivos, licencia, configuración
Uso	Recuperar datos de gestión	Reconstruir la instalación, moverla, protegerse antes de una intervención

Las copias de la aplicación se describen en Administración. El resto de esta sección trata del script del servidor, que funciona mientras la aplicación está en marcha: solo lee.

Linux

sh scripts/backup-stack.sh [directorio-de-destino]

Windows

.\scripts\backup-stack.ps1

Sin destino, crea un directorio backup-<fecha>_<hora> que contiene:

• las dos bases de datos (gestión e identidades), en archivos de copia;
• los datos persistentes: documentos financieros, archivos subidos, licencia y datos de la aplicación;
• una copia de la configuración (.env);
• un manifiesto que describe la instalación copiada (versión, componentes).

La copia contiene secretos

La copia de .env contiene las contraseñas de las bases y las claves técnicas. Guarde las copias en un lugar protegido.

Buenas prácticas

• Programe la copia al menos una vez al día: cron en Linux, Programador de tareas en Windows.
• Cópiela fuera del servidor. Una copia que se queda en el disco que protege desaparece con él.
• Vigile el espacio en disco: copias, imágenes y bases comparten el mismo disco. Elimine las copias antiguas según su política de conservación.
• Pruebe una restauración de vez en cuando, en otra máquina: una copia solo es fiable una vez restaurada con éxito.

Actualizar

Nadigit IMS se actualiza con el instalador del nuevo paquete, apuntado a la instalación existente.

1. Descomprima el nuevo paquete junto a la instalación, nunca encima.
2. Desde el directorio del nuevo paquete, ejecute primero una simulación, que muestra lo que cambiaría sin modificar nada:

Linux

./install.sh --upgrade /opt/nadigit-ims --dry-run
./install.sh --upgrade /opt/nadigit-ims

Windows

.\install.ps1 -Upgrade C:\nadigit-ims -DryRun
.\install.ps1 -Upgrade C:\nadigit-ims

3. Después, ejecute la actualización real (segundo comando).

Qué hace la actualización

1. Se niega a volver atrás: un paquete más antiguo que la versión en servicio se rechaza.
2. Carga las imágenes de la nueva versión.
3. Hace una copia de todo antes de tocar nada: bases, datos persistentes y configuración, en backups/pre-upgrade-<de>-to-<a>-<fecha>/.
4. Sustituye los archivos del paquete conservando cada archivo sustituido, y fusiona la configuración: sus respuestas, secretos y ajustes se conservan; solo cambian los valores que modifica la nueva versión.
5. Arranca la nueva versión y espera a cada componente. El esquema de la base se migra automáticamente al arrancar.
6. Ejecuta el diagnóstico completo.

Cada paso muestra un identificador, de UPG-01 a UPG-07, explicado en TROUBLESHOOTING.md y en Solución de problemas de instalación.

Dos reglas que respetar

• La instalación permanece en su directorio. Parte de los datos está ligada al nombre del directorio, y la licencia está ligada al identificador del servidor guardado en esos datos. Mover o renombrar el directorio hace que la aplicación arranque sobre datos vacíos.
• Las credenciales de las bases de datos no cambian nunca. Se fijan al crear las bases; cambiarlas a mano desconecta la aplicación de sus propios datos. La actualización las conserva.

Volver atrás

• Fallo antes de arrancar la nueva versión: nada ha cambiado para la aplicación en servicio, y los archivos ya sustituidos se restauran automáticamente.
• Fallo después del arranque: el instalador muestra los comandos exactos para volver a la versión anterior. Restauran la configuración y los archivos sustituidos, conservados en install/upgrade-<fecha>/previous/.
• Base ya migrada por la nueva versión: la versión anterior se niega a arrancar sobre una base migrada. Hay que restaurar entonces las dos bases desde la copia tomada antes de la actualización; el procedimiento está en TROUBLESHOOTING.md (UPG-04). En caso de duda, contacte con el soporte de Nadigit antes de actuar.

Ver también

• Instalación
• Solución de problemas de instalación
• Administración