GUIDA.md

Guida step-by-step

La seguente guida spiega come eseguire un backup/snapshot tramite l'utility kelvim.

1. Individuare la VM

Per individuare la VM di cui eseguire il backup usare cockpit aprendo l'indirizzo https://<ip del server>:9090 ed eseguire il login.

Individuare la VM visitano la pagina "Virtual machines".

Aprire la sotto-pagina specifica per la VM, per esempio la VM con ID 039541a9-c976-4ab1-9ef0-2f0d09290612:

Copiare l'ID della VM e aprire un terminale sull'host, per esempio la sezione "Terminal" del Cockpit:

2. Eseguire il backup/snapshot

Inserire il seguente comando nel terminale:

kelvim-snapshot-creator.sh --domain <ID della VM> --external

L'output sarà simile a quello seguente:

La linea di output seguente indica la destinazione del backup:

Starting backup of disk 334ac893d0824efaaee8baef379d41b5 towards /mnt/elemento-vault/snaps/<ID volume>.elsnaps/<data>

3. Verificare lo stato dei backup e degli snapshot

Utilizzando il percorso di destinazione indicato nell'output del comando precedente, inserire il seguente comando nel terminale:

kelvim-snapshot-lister.sh --source /mnt/elemento-vault/snaps/<ID volume>.elsnaps/<data>

L'output elencherà i backup e gli snapshot disponibili, per esempio:

Saranno elencati tutti gli istanti salvati. Il primo backup del giorno è sempre un backup completo, quelli seguenti sono backup incrementali rispetto al primo.

4. Ricostruire il disco di una VM

Il comando per ripristinare uno stato precedente del disco della VM è:

kelvim-snapshot-restorer.sh --source /mnt/elemento-vault/snaps/<ID volume>.elsnaps/<data> --target <destinazione> --until <ID dello snapshot terminale>

Nell'esempio precedente, volendo ripristinare lo stato della VM al backup virtnbdbackup.2, occorrerà utilizzare il comando:

kelvim-snapshot-restorer.sh --source /mnt/elemento-vault/snaps/334ac893d0824efaaee8baef379d41b5.elsnaps/240927 --target /tmp/restored --until virtnbdbackup.2

Nel percorso /tmp/restored verrà rigenerato un file immagine raw contenente tutti i dati della VM fino al backup virtnbdbackup.2.

N.B. la nuove immagine non viene sostituita automaticamente a quella attualmente usata dalla VM. La sovrascrittura deve essere eseguita a mano.

5. Sostituire alla VM il disco attuale con quello ripristinato

Tornare sulla pagina Cockpit della VM (sezione "Virtual machines") e spegnere la VM tramite l'apposito pulsante:

Scorrere fino alla sezione "Disks":

Rimuovere il disco attuale della VM selezionando "Remove" e non "Remove and delete file":

Aggiungere il disco ripristinato:

Avviare la VM tramite il bottone "Run".

Verificare che il rirpristino abbia avuto successo dall'interno della VM.