Il client lionbackup
Il backup avviene tramite un client leggero scritto in Go e fornito come client open source.
Cosa fa il client
Il client si occupa dell'intera parte locale di un backup:
- Comprimere i dati selezionati,
- Cifrare — con la cifratura end-to-end lato client attivata, dal vostro sistema esce solo testo cifrato,
- Trasferire a un Citadel disponibile della Storage Zone scelta.
Se durante il trasferimento un endpoint fallisce, il client passa automaticamente a un altro Citadel disponibile.
Piattaforme
Il client supporta Linux, Windows e macOS (beta). Sono disponibili binari precompilati per il download; il codice sorgente è pubblicamente consultabile.
Configurazione
Per il funzionamento inserite nella configurazione locale:
- il token di accesso legato al progetto,
- con la cifratura lato client, il materiale delle chiavi,
- i percorsi o le sorgenti dati da salvare.
Essendo il client open source, è possibile verificare come avvengono compressione, cifratura e trasferimento — una trasparenza in linea con l'orientamento sovrano di lionbackup.
Un flusso completo dal login al primo backup è disponibile in Primi passi.
Più job di backup sullo stesso computer
Un progetto può avere più configurazioni, ad esempio un'esecuzione giornaliera
per i documenti e una settimanale per il database. Ogni configurazione dà un
nome al proprio job con name::
lionbackup:
name: daily-docs
Il nome compare nell'output e nel nome del file di log
(lionbackup-<name>-YYYYMMDD.log). Più configurazioni possono così condividere
una log_directory senza che le loro righe si mescolino in un unico file. Se
name: manca, il client lo ricava dal nome del file di configurazione
(daily-docs.yaml → daily-docs). Conviene mantenere uguali nome del file e
name:.
Errori di lettura, cartelle speciali di Windows e trasparenza
Dal client v0.1.2:
- Le junction legacy di Windows (collegamenti di compatibilità nascosti come "Immagini" nel profilo) vengono sempre saltate – sono illeggibili per progetto e non contengono dati.
- Gli errori di lettura sotto una sorgente (accesso negato, file rimosso durante l'esecuzione) producono per default un avviso + salto; alla fine il client riporta il totale degli elementi saltati. Una sorgente mancante o illeggibile continua a interrompere l'esecuzione.
- Il comportamento è configurabile con
on_read_errorinlionbackup.yaml:warn(default) oppureabortper interrompere al primo errore.
on_read_error: warn # oppure: abort
Il client racconta i propri passi ("Passo 1/3: verifica sorgenti …", avanzamento della scansione ogni secondo), così anche con directory molto grandi si vede subito cosa sta succedendo.
Windows: file aperti tramite copia shadow
Su Windows il client legge i file che un programma tiene aperti in modo
esclusivo da una copia shadow (VSS) dell'unità. L'opzione è attiva per
impostazione predefinita (use_vss: true) e richiede diritti di
amministratore. Senza questi diritti il client salta i file bloccati, salva il
resto e li elenca nel log. Per i backup tramite l'Utilità di pianificazione
scegliete quindi "Esegui con i privilegi più elevati".
La copia shadow legge sì i file di un database in esecuzione, ma senza
interpellare il database. Affidabile è un backup scritto dal database stesso,
ad esempio con un comando pre_backup (vedi sotto) in una cartella che il
client salva.
VM Hyper-V
Dal client 0.2.0, su un Windows Server con il ruolo Hyper-V il client salva
intere VM. Nella configurazione compaiono solo i loro nomi, come li mostra
Get-VM; a ogni esecuzione il client chiede a Hyper-V quali file ne fanno
parte.
lionbackup:
hyperv:
vms:
- FILESRV01
- DC01 # oppure "*" per tutte le VM dell'host
files: # facoltativo, può mancare
- D:\Condivisioni
- Coerente a livello applicativo, senza spegnere. La copia shadow viene creata tramite DiskShadow con il writer di Hyper-V. Con il servizio di integrazione per il backup (copia shadow del volume) attivo nel guest si tratta di un backup online, in cui diventano coerenti anche applicazioni come SQL Server; senza di esso Hyper-V mette brevemente la VM in stato salvato.
- Un backup per VM, strutturato come un'esportazione di Hyper-V. Dopo il
ripristino
Import-VMlo importa come copia con un nuovo ID. - Backup completo. Ogni esecuzione salva l'intera VM. Il limite predefinito di 100 GB per backup (vedi Limiti) lo aumentiamo su richiesta.
- Requisiti. Windows Server 2025 o 2022, client eseguito come
amministratore, file delle VM su volumi locali di un host autonomo. Il client
rifiuta con un messaggio le VM su Cluster Shared Volumes o condivisioni SMB,
i dischi pass-through e i VHD Set. Senza DiskShadow (Windows 10/11), o se il
writer di Hyper-V fallisce, salva solo con coerenza da crash e avvisa;
on_writer_error: abortinvece interrompe. - Checkpoint più vecchi dopo l'importazione. Un checkpoint che esisteva già
prima del backup si avvia con Secure Boot nella VM importata solo dopo aver
reimpostato il modello di Secure Boot
(
Set-VMFirmware -VM $vm -EnableSecureBoot On -SecureBootTemplate MicrosoftWindows). Dopo un'importazione dall'esportazione di Hyper-V stesso è lo stesso.
Una guida passo passo con test di ripristino è sul blog: Backup delle VM Hyper-V senza spegnerle e Ripristinare una VM Hyper-V dal cloud.
Comandi prima e dopo il backup
Dal client 0.2.0 il client esegue comandi propri indicati sotto hooks:,
ad esempio un dump del database prima del backup:
lionbackup:
hooks:
pre_backup:
- 'C:\Script\backup-database.cmd'
post_backup:
- 'C:\Script\dopo-il-backup.cmd'
timeout_sec: 3600 # per comando, predefinito 3600
| Fase | Quando | Se il comando fallisce |
|---|---|---|
pre_backup | prima di tutto, ancora prima della verifica delle sorgenti | L'esecuzione non salva nulla. |
post_snapshot | appena la copia shadow è pronta, altrimenti dopo la lettura | Il backup prosegue, ma termina con un errore. |
post_backup | sempre alla fine, anche dopo errori | L'esecuzione termina con un errore. |
Mettete i comandi tra apici singoli: altrimenti due punti seguiti da uno spazio
o un # nel comando rompono lo YAML. Su Windows i comandi vengono eseguiti
tramite cmd.exe /C, su Linux e macOS tramite /bin/sh -c.
Chi può modificare la configurazione può usarla per eseguire comandi, su un
server spesso come amministratore. Salvate la configurazione in modo che solo
gli amministratori possano modificarla. Su Linux e macOS il client rifiuta
hooks: in una configurazione scrivibile dal gruppo o da tutti.