Files
CloudRecoveryAS/packaging/LEEME.txt
hreyes 0a62b7d0aa docs: documentar el instalador de Windows y corregir lo que contradecía al código
README afirmaba que la app no puede correr como servicio de Windows y sugería
NSSM, contradiciendo a install.ps1 desde que existe. LEEME.txt solo documentaba
el camino manual para Windows, mientras que para Linux ya traía el instalador.

BUILD.md gana -UpdateInPlace, las tres garantías al reemplazar el binario y el
remedio del token filtrado por UAC.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 08:46:28 -06:00

64 lines
2.9 KiB
Plaintext

CloudRestoreAS — despliegue portable
=====================================
El ejecutable es AUTOCONTENIDO: no requiere Python, ni 7-Zip, ni driver ODBC, ni
librerias Qt instaladas en el equipo destino. Todo va embebido dentro del binario.
Windows: copie CloudRestoreAS.exe a la carpeta deseada.
Linux: copie CloudRestoreAS y ejecute chmod +x CloudRestoreAS si hace falta.
1. Ejecute el programa (doble clic o ./CloudRestoreAS).
- Se abre la ventana principal y un icono en la bandeja del sistema.
- El motor arranca automaticamente (CLOUDRESTORE_AUTO_START=true por defecto).
2. Se crean automaticamente: config/, Entrada/, Procesados/, Fallados/, Temp/
3. Edite config/.env con la URL, token e instancia del servicio de bases.
4. Reinicie la aplicacion si cambio la configuracion.
Cerrar la ventana (X) minimiza a la bandeja; la app sigue en ejecucion.
Para salir por completo: clic derecho en el icono de bandeja -> Salir,
o menu Archivo -> Salir.
-------------------------------------
Windows en SERVIDOR (24/7, sin sesion iniciada)
-------------------------------------
Lo normal es que el PANEL instale y actualice solo, desde Versiones CRAS. Esto es
el camino manual, y es lo mismo que el PANEL ejecuta por dentro.
Opcion A - servicio 24/7 (recomendado en servidor SQL):
.\install.ps1 -Service
(registra una tarea programada ONSTART que corre como SYSTEM, sin sesion
iniciada y sin ventana; ver estado: Get-ScheduledTask -TaskName CloudRestoreAS)
Requiere PowerShell como Administrador.
Opcion B - actualizar una instalacion que ya existe:
.\install.ps1 -UpdateInPlace
(reemplaza el binario conservando la tarea y la configuracion; no actua si hay
una restauracion en curso, y revierte solo si la version nueva no arranca)
Opcion C - escritorio Windows (con sesion):
.\install.ps1 -Desktop
No se usa NSSM ni ningun envoltorio de servicio: la tarea programada ya viene en el
SO, y en el servidor destino no se instala ni se descarga nada.
-------------------------------------
Linux en SERVIDOR SIN ESCRITORIO (headless)
-------------------------------------
En un servidor sin pantalla (sin DISPLAY), la app arranca automaticamente en modo
"offscreen": no muestra ventana pero el motor de restauracion trabaja igual. No hay
que instalar nada del sistema.
Opcion A - servicio 24/7 (recomendado en servidor SQL):
sudo ./install.sh --service
(instala una unit systemd que corre el binario con --start-engine --headless;
ver estado: systemctl status cloudrestoreas ; logs: journalctl -u cloudrestoreas -f)
Opcion B - manual:
QT_QPA_PLATFORM=offscreen ./CloudRestoreAS --start-engine --headless
Opcion C - escritorio Linux (con pantalla):
./install.sh --desktop (registra autostart .desktop; requiere sesion grafica)
El servidor SQL destino y su carpeta de datos (data_folder) se toman del PANEL;
con SQL Server sobre Linux use rutas POSIX (p. ej. /var/opt/mssql/data).