Version: 2026-03-07
Scope: ASH GDrive Backup module with Full Server Recovery (Proxmox DR) profile.

Este procedimiento permite:

• Hacer backup completo del servidor (rootfs) hacia Google Drive.
• Validar que el backup quedó íntegro.
• Restaurar en una VM nueva en Proxmox con el menor reproceso posible.

• Backend y frontend ASH desplegados.
• rclone funcional con destino gdrive:3AV-ASH.
• Espacio suficiente en Google Drive.
• Usuario con acceso a ASH + credenciales de modo privilegiado del sistema (user en este entorno).
• En Proxmox: VM destino con disco igual o mayor al servidor origen.

Ejecutar en servidor ASH (root):

systemctl restart ash-backend.service
systemctl restart ash-frontend.service

Validar servicios:

systemctl is-active ash-backend.service
systemctl is-active ash-frontend.service

Deben responder active.

1. Ir a Administration → GDrive Backup.
2. En Saved backup tasks, cargar la tarea:
   • Full Server Recovery (Proxmox DR)
   • o botón Use Full Server Recovery.
3. Abrir Explore y autenticar modo privilegiado (user + password).
4. Click en Backup now.

• Barra de progreso general.
• Estado por carpeta/componente.
• Eventos/logs en Run history & logs.
• Snapshot remoto en gdrive:3AV-ASH/<run_id> y puntero latest.

1. En Run history, verificar estado SUCCESS.
2. Abrir Repository explorer y validar contenido en latest/:
   • archivos .tar.gz
   • tamaños > 0
3. Revisar errores/warnings del run.

rclone lsd gdrive:3AV-ASH
rclone ls gdrive:3AV-ASH/latest

Regla crítica: no restaurar sobre / en caliente de un sistema en ejecución.
Restaurar desde modo rescue/live o hacia un filesystem montado offline.

1. Crear VM en Proxmox (CPU/RAM según origen).
2. Disco destino igual o mayor al origen.
3. Boot con ISO Linux rescue/live.
4. Crear/ajustar particiones y montar raíz destino en /mnt/target.

Ejemplo (ajustar device real):

mount /dev/sdXn /mnt/target
mkdir -p /mnt/target/boot
# mount /dev/sdXm /mnt/target/boot   # si aplica partición separada

En entorno rescue, configurar rclone y traer snapshot:

mkdir -p /tmp/ash-restore
rclone copy gdrive:3AV-ASH/latest /tmp/ash-restore
ls -lh /tmp/ash-restore

for f in /tmp/ash-restore/*.tar.gz; do
  echo "Extracting $f"
  tar -xzf "$f" -C /mnt/target
done

1) Revisar /mnt/target/etc/fstab (UUID correctos).

2) Montar pseudo-filesystems para chroot:

mount --bind /dev /mnt/target/dev
mount --bind /proc /mnt/target/proc
mount --bind /sys /mnt/target/sys
chroot /mnt/target

3) Reinstalar bootloader (ejemplo Debian/Ubuntu BIOS/UEFI, ajustar según caso):

grub-install /dev/sdX
update-grub
exit

4) Desmontar y reiniciar VM:

umount -R /mnt/target
reboot

• [ ] Backup Full Server Recovery (Proxmox DR) terminó en SUCCESS.
• [ ] Snapshot visible en latest y/o <run_id>.
• [ ] Restauración completada sin errores fatales de extracción.
• [ ] VM en Proxmox arranca correctamente.
• [ ] Servicios clave arriba (ash-backend, ash-frontend, DB, conectores).
• [ ] Acceso UI OK y datos críticos presentes.

Causa:

• archivos volátiles (logs/db wal/tmp).

Acción:

• Reintentar backup.
• Programar backup en ventana de baja actividad.

• Click Refresh.
• Abrir latest explícitamente.
• Verificar rclone remoto y credenciales.

• Si expiró sesión privilegiada, volver a autenticar desde Explore.
• Debe auto-bloquear por timeout e inactividad.

• Ejecutar backup full al menos semanal + incremental lógico diario por tareas específicas.
• Mantener al menos 3 puntos de recuperación (rotación).
• Probar restore en VM sandbox 1 vez por mes.
• Registrar run_id validado para auditoría.

# estado backend/frontend
systemctl is-active ash-backend.service ash-frontend.service
 
# validar remote latest
rclone ls gdrive:3AV-ASH/latest | head

Si ambos checks son correctos, el ciclo de backup está operativo.