CloudRestoreAS - Guía Rápida de Inicio

Instalación Express (5 minutos)

1. Pre-requisitos

# Verifica Python 3.11+
python --version

# Verifica ODBC Driver
Get-OdbcDriver | Where-Object {$_.Name -like "*SQL Server*"}

2. Instala y Ejecuta

# Prepara el entorno de desarrollo (Python + venv + requirements)
.\scripts\dev-setup.ps1

# Ejecuta la aplicación
.\venv\Scripts\python.exe runner.py

Para desplegar el binario compilado en un servidor usa install.ps1 (raíz), que es autocontenido y no necesita Python. Ver BUILD.md §6.

Integración con PANEL_BASES_ANEXO24

Si usas el panel para asignar servidores de restauración, ver INTEGRACION_PANEL.md para tokens, catálogo dinámico (target-catalog) y prueba end-to-end.

Prueba local en tu PC (carpetas + config automática):

.\scripts\prepare_local_test.ps1
.\venv\Scripts\python.exe runner.py

Copia el ZIP a C:\CloudRestore\Entrada (ver LEEME.txt en esa carpeta).

3. Configuración Básica (en la aplicación)

Tab Configuración:
- Carpeta Entrada: C:\Backups\Entrada
- Carpeta Procesados: C:\Backups\Procesados
- Carpeta Fallados: C:\Backups\Fallados
- Carpeta Extracción: C:\Temp\CloudRestore
- Carpeta Data SQL: C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA
- 7-Zip: Click "Detectar"
- SQL Server: localhost (Windows Auth)
- Click "Guardar Configuración"

Tab Nodos (ejemplo):

Nuevo Nodo:
- Nombre: BACKUP_VENTAS.ZIP
- DB: Ventas_DB
- Activo: ✓

Menú Motor → Iniciar
Prueba: Copia BACKUP_VENTAS.ZIP a la carpeta de entrada

Flujo Típico

📁 Carpeta Entrada
   └── BACKUP_VENTAS.ZIP    ← Copias el archivo aquí

↓ (10 segundos - verificación de estabilidad)

🔄 Procesamiento Automático
   1. ✓ Detectar archivo estable
   2. ✓ Mapear BACKUP_VENTAS.ZIP → Ventas_DB
   3. ✓ Extraer .bak con 7-Zip
   4. ✓ Obtener estructura lógica (FILELISTONLY)
   5. ✓ Restaurar Ventas_DB (REPLACE)
   6. ✓ Limpiar archivos temporales

↓

📁 Carpeta Procesados/2026-01-25
   └── BACKUP_VENTAS.ZIP    ← Movido automáticamente

✅ Job Completado (ver Dashboard/Jobs)

Comandos Útiles

# Ejecutar aplicación
.\venv\Scripts\python.exe runner.py

# Verificar instalación
.\venv\Scripts\python.exe test_installation.py

# Generar ejecutable
.\build.ps1

# Ver logs en tiempo real
Get-Content .\logs\app.log -Wait -Tail 50

Estructura de Directorios Recomendada

C:\CloudRestore\
├── Entrada\           ← ZIP entrantes
├── Procesados\        ← ZIP exitosos (por fecha)
│   ├── 2026-01-25\
│   └── 2026-01-26\
├── Fallados\          ← ZIP que fallaron
└── Temp\             ← Extracción temporal

Troubleshooting Express

Problema	Solución
Archivo no se procesa	Espera 10s o click "Escanear Ahora"
NODE_NOT_MAPPED	Crea el nodo exacto en Tab Nodos
Error SQL	Verifica permisos y conexión en Tab Config
7-Zip falla	Verifica que el ZIP no esté corrupto

Monitoreo

Dashboard: Contadores en tiempo real
Jobs: Historial y detalles
Logs: Eventos del sistema

Para Ejecutar 24/7

Inicia la aplicación (el motor arranca solo si CLOUDRESTORE_AUTO_START=true)
Cierra la ventana con X — se minimiza a la bandeja del sistema
La app continuará monitoreando en segundo plano
Para salir por completo: bandeja → Salir o menú Archivo → Salir

Tip: Lee el README.md completo para configuración avanzada.

3.7 KiB Raw Blame History