Passa al contenuto principale

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:

  1. Comprimere i dati selezionati,
  2. Cifrare — con la cifratura end-to-end lato client attivata, dal vostro sistema esce solo testo cifrato,
  3. 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.
Open source

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_error in lionbackup.yaml: warn (default) oppure abort per 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-VM lo 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: abort invece 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
FaseQuandoSe il comando fallisce
pre_backupprima di tutto, ancora prima della verifica delle sorgentiL'esecuzione non salva nulla.
post_snapshotappena la copia shadow è pronta, altrimenti dopo la letturaIl backup prosegue, ma termina con un errore.
post_backupsempre alla fine, anche dopo erroriL'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.

I comandi girano con i diritti del client

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.