# Manuale di &kbackup;

## Introduzione

&kbackup; è un programma che permette di salvare copie di sicurezza di qualsiasi cartella o file, che usa una albero di cartelle semplice da usare per selezionare quello che va salvato. Ti permette di salvare le impostazioni in cosiddetti file di profilo, in cui un profilo è un semplice file di testo che contiene le definizioni di cartelle e file da includere o escludere dal processo di salvataggio. Inoltre ti permette di definire dove salvare i dati. La destinazione può essere una cartella locale (⪚ un dispositivo montato localmente come un dispositivo ZIP o USB, &etc;) ma può anche un qualsiasi &URL; remoto (⪚ smb://server_remoto/un_qualche_percorso) per salvare i dati su un server centrale, &etc;

Il programma può anche effettuare automaticamente una copia di sicurezza senza usare un'interfaccia grafica. Basta semplicemente create un profilo ed usare queste impostazioni per dire a &kbackup; cosa fare quando viene eseguito in modalità non interattiva, ⪚ quando viene avviato tramite cron.

Il programma è stato progettato per essere semplice nell'utilizzo per poter essere usato da utenti non esperti.

Il formato di memorizzazione è il ben noto formato TAR, per cui i dati possono essere salvati in formato compresso (xz, bzip2 o gzip).

L'implementazione attuale comprendo solo il passo di salvataggio. Per ripristinare i dati nel sistema attualmente bisogna usare, ⪚, &dolphin; per aprire i file TAR di backup e trascinare i file nel file system. Questo è anche un vantaggio dell'uso del ben noto e ben supportato formato di file TAR.

Se i file sono compressi, puoi decomprimere tutti i file ricorsivamente dalla cartella attuale con il seguente comando:

    find . -name \*bz2 -print0 | xargs -0 bunzip2

In alternativa puoi anche usare &ark; per estrarre una copia di sicurezza completa o solo alcuni file dal backup.

## Uso di &kbackup;

Tutto quello che devi fare è selezionare quali cartelle vanno salvate. Questo si fa selezionando le cartelle nella vista ad albero a sinistra della finestra principale.

Se selezioni una cartella &kbackup; salverà automaticamente tutti i file e le sotto-cartelle incluse. Se vuoi escludere parti di una cartella selezionata, basta deselezionare quei file/cartelle all'interno della cartella ancora selezionata.

Un generale questo vuol dire: una cartella selezionata salverà qualsiasi oggetti al suo interno ricorsivamente, con l'esclusione delle parti deselezionate. Questo vuole anche dire che ogni volta che riusi successivamente un profilo (vedi di seguito) e nuovi file vengono aggiunti ad una cartella già selezionata per il backup, anche tutti i nuovi file saranno salvati.

Questa è una schermata di &kbackup; Schermata della finestra principale

### Uso dei profili

Per mantenere una selezione per un uso successivo basta salvarla in un file di profilo di &kbackup;. Usa il menu File e seleziona Salva profilo.

Per ricaricare una selezione in &kbackup; usa la voce di menu File Carica profilo....

&kbackup; salva in un profilo le selezioni per tutti i file e le cartelle inclusi, tutti i file e le cartelle escluse, la cartella/&URL; di destinazione, il prefisso definito per l'archiviazione, la dimensione massima definita per i file delle porzioni, &etc;

Se vuoi semplificare il salvataggio giornaliero dello stesso insieme di file, memorizza semplicemente le impostazioni in un profilo di &kbackup; (un file `.kbp`) e passa tale file tramite riga di comando.

⪚:

    kbackup mieiDati.kbp

Suggerimento: puoi anche creare una scorciatoia sul desktop verso un file `.kbp` perché questo di file è impostato per avviare &kbackup; al doppio clic.

### Porzioni di archivio

Dato che i supporti dati normalmente hanno una capacità limitata (⪚ un disco ZIP da 100MB), &kbackup; creerà varie porzioni di archivio.

Ogni porzione avrà un proprio nome, che avrà una forma del tipo:

backup_2006.08.26-13.04.44_1.tar

Il nome contiene la data e l'ora di creazione (che saranno le stesse per tutte le porzioni di una copia di sicurezza) e a seguire il numero di sequenza della porzione (_1 nell'esempio).

Nel menu File Impostazioni del profilo... puoi definire un prefisso di archiviazione diverso dal valore predefinito backup.

Nella finestra Impostazioni del profilo puoi anche definire una dimensione massima per le porzioni di archivio, che limite la dimensione delle porzioni anche nel caso in cui ci sia ancora spazio libero sul dispositivo di destinazione. Questo aiuta a creare delle porzioni di archivio che possono in seguito essere masterizzate su un &CD;/&DVD;, &etc;. Se limiti esplicitamente la dimensione di una porzione di archivio, la dimensione disponibile sarà marcata con (*) nella finestra principale.

Ma anche se imposti una dimensione illimitata per le porzioni, ci sono altri vincoli che limitano la dimensione di una porzione:

- limitato dalla cartella di destinazione (quando il salvataggio avviene direttamente in una cartella locale)

- limitato dalla cartella `/tmp` quando viene usata per creare un file temporaneo da inviare successivamente ad un &URL; remoto

Nella finestra Impostazioni del profilo puoi anche definire un numero massimo di copie di sicurezza complete che vengono mantenute nella cartella di destinazione, e quindi eliminando automaticamente tutte le copie più vecchie là presenti. ⪚ se viene impostato a 3, &kbackup; manterrà le ultime 3 copie di backup e rimuoverà tutte quelle più vecchie.

### Copia di sicurezza incrementale

Con una copia di sicurezza incrementale non saranno salvati tutti i file ogni volta che si esegue il processo di copia, ma solo quelli che sono cambiati dall'ultima sua esecuzione. Ciò ha il grande vantaggio che una copia di sicurezza incrementale includerà una quantità significativamente inferiore di file rispetto ad una copia completa, e il processo verrà completato quindi in un tempo molto più rapido.

Funziona in questo modo: nel profilo definisci un intervallo (in giorni) per le copie di sicurezza complete. Quando ⪚ definisci cinque giorni, &kbackup; effettuerà una copia di sicurezza completa di tutti i file ogni cinque giorni. Ogni volta che &kbackup; viene avviato con questo profilo prima della fine dell'intervallo - indipendentemente dal fatto di aver eseguito o meno un'operazione di backup - solo i file cambiati dall'ultima copia saranno salvati. &kbackup; memorizza l'orario le informazioni temporali relative all'ultima copia di sicurezza nel profilo e quindi sa quando eseguirlo successivamente.

I nomi di file delle porzioni creati durante una copia di sicurezza incrementale conterranno il testo _inc, ⪚:

backup_2010.06.14-18.50.26_1_inc.tar

I file delle porzioni delle copie di sicurezza complete non includeranno il testo _inc nel nome, ⪚:

backup_2010.06.13-20.58.14_1.tar

Quando si vogliono ripristinare i file da una copia di sicurezza incrementale è importante cercare la versione più recente di un file da ripristinare in tutti i file _inc e alla fine anche nell'ultimo file di porzione di copia di sicurezza completa. Questo è anche uno svantaggio della copia incrementale (ma non ci sono vantaggi senza svantaggi :-) )

Se vuoi eseguire una copia di sicurezza completa prima del periodo ciclico definito nel profilo per quella incrementale, puoi farlo selezionando l'opzione Forza copia di sicurezza completa nell'interfaccia utente. Quando &kbackup; viene avviato tramite riga di comando lo stesso risultato si può ottenere usando l'opzione `--forceFull`

L'esecuzione forzata di una copia di sicurezza completa riavvierà il ciclo delle copie, &ie; &kbackup; conta i giorni alla prossima copia completa dal momento dell'ultima.

### Compressione dell'archivio

&kbackup; comprimerà i file memorizzati se attivi questa opzione nelle impostazioni del profilo. In base alla disponibilità sul tuo sistema sceglie la compressione `bzip2` o `gzip`. &kbackup; comprimerà ogni file e memorizzerà tutti i file aggiungendo l'estensione al loro nome (`.xz`, `.bzip2` o `.gz`) nell'archivio `.tar` non compresso.

Quando hai selezionato la creazione della copia di sicurezza su un file system locale (⪚ un altro disco, un'unità ZIP, &etc;) - in altre parole, non hai inserito un &URL; remoto di destinazione - &kbackup; potrebbe suddividere l'intera copia in diverse porzioni per limitazioni della capacità del supporto.

⪚:

backup_2006.08.26-13.04.44_1.tar

backup_2006.08.26-13.04.44_2.tar

### Automatizzare il processo di backup

Per automatizzare il processo di backup, &kbackup; mette a disposizione varie opzioni a riga di comando che aiutano in tal senso:

- `--auto`

  Quando esegui &kbackup; con questa opzione e un certo profilo `.kbp`, il programma partirà, eseguirà la copia e terminerà quando questa viene completata. Tutto questo viene fatto con l'interfaccia utente di &kbackup; visibile.

- `--autobg`

  Quando esegui &kbackup; con questa opzione e un certo profilo `.kbp`, eseguirà lo stesso processo descritto per l'opzione `--auto` ma senza mostrare l'interfaccia utente grafica, e da qui il suffisso bg che vuol dire background - le operazioni sono svolte dietro le quinte (in background). Pertanto questa è l'opzione giusta da usare quando le copie di sicurezza vengono eseguite ⪚ tramite un processo di cron.

  Quando si usa `--autobg` i messaggi di output di &kbackup; - che mostrano l'avanzamento delle operazioni - sono scritti su stderr. Come impostazione predefinita, l'output include solo alcuni messaggi importanti ed un riepilogo alla fine. Se viene specificata anche l'opzione `--verbose` saranno visibili anche i nomi dei file che vengono man mano salvati.

## Guida ai comandi

### La finestra principale di &kbackup;

#### Il menu File

File Apri recente

- Mostra un sotto-menu con i profili usati di recente per una facile selezione.

File Nuovo profilo

- Cancella la selezione ed il campo per definire la destinazione, in modo da poter definire un nuovo profilo.

File Carica profilo...

- Carica un profilo.

File Salva profilo

- Salva tutte le impostazioni nel profilo attualmente caricato.

File Salva profilo come...

- Salva tutte le impostazioni in un profilo con un nuovo nome.

File Impostazioni del profilo...

- Nelle impostazioni puoi definire se i nomi dei file di porzioni di archivio comincino con il nome predefinito backup o con un altro nome. Puoi anche limitare la dimensione delle porzioni di archivio. Consulta il capitolo sulle porzioni di archivio. Anche queste impostazioni sono memorizzate nel profilo.

&Ctrl;Q File Esci

- Esce da &kbackup;.

#### Il menu Impostazioni

Impostazioni Aggancia al vassoio di sistema

- Quando questa opzione viene attivata viene mostrata un'icona nel vassoio di sistema che riflette lo stato attuale della creazione della copia di sicurezza. Viene anche mostrata un'animazione quando la copia è in corso, altrimenti appare un'icona statica. Se questa opzione è selezionata, la chiusura della finestra principale non determina la chiusura di &kbackup;. L'applicazione dovrà essere terminata esplicitamente selezionando l'azione Esci. Tramite il menu contestuale dell'icona del vassoio di sistema di &kbackup; è possibile avviare ed annullare una copia di sicurezza - le stesse operazioni eseguibili dalla finestra principale. Il suggerimento su questa icona fornisce anche informazioni sull'avanzamento dell'operazione (numero dei file salvati, dimensione della copia ed ultimo file salvato).

Impostazioni Abilita tutti i messaggi

- L'attivazione di questa voce cancella le scelte memorizzate per le opzioni Non chiedere più delle finestre di dialogo di &kbackup;.

Impostazioni Mostra i file nascosti

- Abilita o disabilita la visualizzazione dei file nascosti (preceduti da un carattere punto) nella vista ad albero. Usa questa opzione se vuoi escludere alcuni file nascosti dalla copia di sicurezza. Se vuoi escludere tutti i file nascosti, usa un filtro di nome di file nelle impostazioni del profilo.

#### Il menu Aiuto

&kbackup; ha le normali voci del menu di &kde; Aiuto; per maggiori informazioni leggi la sezione sul menu Aiuto dei fondamentali di &kde;.

## Guida dello sviluppatore di &kbackup;

&kbackup; può essere esteso usando uno script di shell (o qualsiasi altro eseguibile) che verrà avviato in tre diversi punti durante il processo di salvataggio. L'idea di fondo è permettere di montare, smontare, rimuovere supporti multimediali nel modo più appropriato per il sistema, o effettuare altre operazioni con gli archivi generati.

Lo script da eseguire deve essere specificato con l'opzione a riga di comando `--script`.

Questo è uno script di esempio:

### sliceScript.sh

    #!/bin/sh

    mode=$1
    archive=$2
    target=$3
    mountPoint=$4

    case "$mode" in
     "slice_init" )
        if [ "$mountPoint" != "" ]
        then
          mount /media/zip
          rm -f /media/zip/backup_2*.tar*
        fi
     ;;

     "slice_closed" )
     ;;

     "slice_finished" )
        if [ "$mountPoint" != "" ]
        then
          umount /media/zip
          eject /media/zip
        fi
     ;;
    esac

Questo script viene sempre chiamato con quattro argomenti a riga di comando:

- modalità di invocazione

- nome del file di (porzione di) archivio

- cartella/&URL; di destinazione

- punto di montaggio della cartella di destinazione se locale, oppure una stringa vuota

Ci sono tre possibili modalità di invocazione:

- slice_init

  chiamata prima della creazione di una nuova porzione di archivio sul disco

- slice_closed

  chiamata dopo la creazione di una porzione di archivio, ma prima che venga copiata nella cartella di destinazione

  Questa può essere usata se vuoi copiare la porzione di archivio da qualche altra parte, ⪚ l'archivio è inviato al server principale (tramite &URL; di destinazione), ma vuoi mantenere l'ultima copia anche sul disco locale.

- slice_finished

  chiamata quando la porzione di archivio è stata trasferita con successo nella cartella di destinazione

## Riconoscimenti e licenza

&kbackup;

Copyright programma © 2006-2009 Martin Koller kollix@aon.at

Copyright documentazione © 2006-2009 Martin Koller

Luigi Toscanoluigi.toscano@tiscali.it(Traduzione del documento)

&underFDL; &underGPL;
&documentation.index;