# Das Handbuch zu &kbackup;

## Einführung

&kbackup; ist ein Programm zur Datensicherung von beliebigen Dateien und Ordnern, wobei es einen einfach zu bedienenden Ordnerbaum zur Auswahl zur Verfügung stellt. Gewählte Einstellungen können in sogenannten Profil-Dateien gespeichert werden, wobei ein Profil eine einfache Textdatei ist, welche die Auswahl für Ordner und Dateien enthält, welche für die Sicherung ein- oder auszuschließen sind. Ebenso enthält es die Definition, wohin die Sicherung geschrieben werden soll. Das Ziel einer Sicherung kann entweder ein lokaler Ordner sein (⪚ ein lokal eingebundenes Gerät wie ein ZIP-Laufwerk, USB-Stick, &etc;) aber es kann auch ein anderer Rechner - unter Angabe einer &URL; (⪚ smb://rechner/ziel) - sein, um die Daten auf einen zentralen Server zu sichern.

Das Programm kann auch eine automatische Sicherung ohne grafische Benutzeroberfläche durchführen. Man erstellt einfach ein Profil, welches &kbackup; sagt, was gesichert werden soll, wenn es im nicht interaktiven Modus gestartet wird, ⪚ aus einem cron-job heraus.

Das Programm wurde so entworfen, dass es möglichst einfach in der Bedienung ist und auch Benutzern mit wenig Erfahrung mit Rechnern bedient werden kann.

Das Archivierungsformat ist das wohl bekannte Tar-Format, wobei die Daten komprimiert gespeichert werden (xz, bzip2 oder gzip) können.

Die aktuelle Implementierung enthält nur den Sicherungsschritt. Um die Daten wieder in das System zurück zuspielen muss man derzeit ⪚ &dolphin; benutzen, um eine TAR-Sicherungsdatei zu öffnen, und dann Teile daraus ⪚ via Ziehen und Ablegen in das System zurückbringen. Das ist einer der Vorteile der Verwendung des weit verbreiteten TAR-Dateiformates.

Wenn die Dateien komprimiert wurden, so kann man alle vom aktuellen Ordner aus rekursiv absteigend mit folgendem Befehl wieder entpacken:

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

Alternativ können Sie mit &ark; die Sicherungsdatei öffnen und die komplette Sicherung oder nur einzelne Datei entpacken.

## Verwendung von &kbackup;

Alles was Sie tun müssen, ist die Auswahl der Ordner, die gesichert werden sollen. Dies wird erreicht, indem man in der Baumansicht auf der linken Seite des Hauptfensters die Ordner anwählt.

Wenn Sie einen Ordner wählen, wird &kbackup; automatisch alle Dateien und Unterordner darin sichern. Wenn Sie Teile in einem ausgewählten Ordner von der Sicherung ausnehmen wollen, müssen Sie einfach die entsprechenden Ordner oder Dateien darin abwählen.

Generell bedeutet das: Ein ausgewählter Ordner wird alle Dateien und Unterordner darin sichern, außer den abgewählten Einträgen. Das bedeutet auch, wann immer Sie ein Profil (siehe weiter unten) wiederverwenden, werden auch alle neuen Ordner und Dateien, die in der Zwischenzeit dazugekommen sind, ebenfalls gesichert.

Hier ist ein Bildschirmfoto von &kbackup; Bildschirmfoto des Hauptfensters

### Verwendung von Profilen

Um eine Auswahl für spätere Verwendung zu behalten, wird diese einfach in ein &kbackup;-Profil gespeichert. Verwenden Sie dafür das Menü Datei und wählen Sie Profil speichern.

Um eine Auswahl wieder zu laden, verwenden Sie den Menüeintrag Datei Profil laden.

&kbackup; speichert in einem Profil die Auswahl für alle ein- und ausgeschlossenen Dateien und Ordner, das Ziel für die Sicherung, das gewählte Archiv-Präfix, das gewählte Größenlimit für einen Archivteil und anderes.

Wenn Sie sich die Aufgabe der täglichen Datensicherung einfach machen wollen, speichern Sie ihre Auswahl in einem Profil (eine Datei mit der Endung `.kbp`) und geben dieses Profil beim Start von &kbackup; als Argument mit an.

⪚:

    kbackup meineDaten.kbp

Hinweis: Sie können auch eine Verknüpfung zu einer `.kbp`-Datei auf dem Arbeitsfläche machen, um gleich direkt &kbackup; mit dessen Einstellungen zu starten, da `.kbp` als bekannter Dateityp registriert ist.

### Archiv aufteilen

Da ein Medium normalerweise nur eine begrenzte Kapazität hat wie ⪚ eine 100MB ZIP-Diskette, teilt &kbackup; die Sicherung in einzelne Teile auf.

Jeder Archivteil hat seinen eigenen Dateinamen, welcher wie folgt aussieht:

backup_2006.08.26-13.04.44_1.tar

Der Name enthält das Datum und die Uhrzeit der Sicherung (welche für jeden Teil der Sicherung gleich bleibt), und eine angehängte Teil-Nummer (_1 in diesem Beispiel).

Über das Menü Datei Profil-Einstellungen kann ein anderes Präfix als Sicherung für die Archive eingestellt werden.

Um unabhängig von der verfügbaren Kapazität des Zielmediums eine Sicherung in mehrere Archivteile einer maximalen Größe trennen zu können, kann man im Dialog Profil-Einstellungen eine Maximalgröße pro Archivteil festlegen. Dies ergibt ⪚ dann Sinn, wenn man eine Sicherung für das nachträgliche Brennen auf eine &CD;/&DVD; vorbereiten will. Wenn Sie die Größe eines Archivteils explizit begrenzen, dann erscheint die verfügbare Größe mit der Markierung (*) im Hauptfenster.

Auch wenn eine unbegrenzte Größe eingestellt wurde, gibt es zusätzliche Einschränkungen für die Größe eines Archivteils:

- begrenzt durch die verfügbare Kapazität im Zielordner, wenn direkt in einen lokalen Ordner gesichert wird

- begrenzt durch den Ordner `/tmp`, wenn die Sicherung durch Angabe einer &URL; auf einen entfernten Rechner kopiert wird, da eine temporäre Datei erzeugt wird, die danach zum Zielrechner übertragen wird.

In den Profil-Einstellungen kann auch festgelegt werden, wie viele komplette Sicherungen maximal in dem Zielordner behalten werden sollen, bevor ältere Sicherungen automatisch gelöscht werden. Wird ⪚ ein Wert von 3 eingestellt, wird &kbackup; die letzten 3 Sicherungen behalten und alle älteren Sicherungen werden gelöscht.

### Inkrementelle Sicherung

Unter inkrementeller Sicherung versteht man, dass nicht immer alle Dateien gesichert werden, sondern nur jene, die sich seit der letzten Sicherung geändert haben. Dies hat den großen Vorteil, dass die inkrementellen Sicherungen üblicherweise wesentlich weniger Dateien beinhalten und der Sicherungsvorgang daher wesentlich schneller beendet ist.

Die Vorgehensweise ist also folgende: Im Profil definiert man ein Intervall in Tagen für eine Komplett-Sicherung, ⪚ 5 Tage. Das bedeutet, &kbackup; sichert alle 5 Tage alle definierten Dateien. An allen Tagen dazwischen - egal wie oft Sie &kbackup; mit diesem Profil starten - werden nur jene Dateien gesichert, die sich seit der letzten Sicherung geändert haben. &kbackup; schreibt dafür die Sicherungs-Zeitstempel in ihr Profil und weiß somit, was das nächste mal zu tun ist.

Die Sicherungsdateien, die hierbei entstehen beinhalten den Text _inc wie ⪚:

backup_2010.06.14-18.50.26_1_inc.tar

Die Dateien einer Komplett-Sicherung haben kein Kürzel _inc im Dateinamen wie ⪚:

backup_2010.06.13-20.58.14_1.tar

Wichtig ist, dass bei einer Wiederherstellung einer Sicherung auf den Rechner nun alle _inc Dateien und zuletzt auch die letzte Komplett-Sicherung durchsucht werden müssen, um den letzten Stand einer Datei zu finden. Genau das ist auch der Nachteil von inkrementellen Sicherungen (kein Vorteil ohne Nachteil ;-) )

Will man trotz definiertem inkrementellen Zyklus im Profil vorzeitig eine Komplett-Sicherung durchführen, so kann man dies in der Benutzeroberfläche über die Option Komplett-Sicherung erzwingen starten. Startet man &kbackup; über die Befehlszeile, so kann dies mit der Option -`-forceFull` erledigt werden.

Eine erzwungene Komplett-Sicherung startet das Sicherungsintervall neu, &ie; &kbackup; rechnet den Komplett-Sicherungszyklus immer von der zuletzt durchgeführten Komplett-Sicherung.

### Archiv-Komprimierung

&kbackup; komprimiert die gesicherten Dateien, wenn dies im Profil eingestellt wurde. Abhängig von der Verfügbarkeit auf ihrem System wird entweder `xz`, `bzip2` oder `gzip` als Komprimierung verwendet. &kbackup; wird jede einzelne Datei komprimieren und mit einer angehängten Dateierweiterung `.xz`, (`.bzip2` oder `.gz`) im nicht komprimierten `.tar`-Archiv speichern.

Wenn Sie als Ziel einen lokalen Ordner gewählt haben (⪚ ihre externe Festplatte, ZIP-Laufwerk, &etc;) - &ie; Sie haben keine &URL; angegeben - kann &kbackup; die gesamte Sicherung aufgrund der beschränkten Medienkapazität in einzelne Teilarchive trennen.

⪚:

backup_2006.08.26-13.04.44_1.tar

backup_2006.08.26-13.04.44_2.tar

### Automatische Sicherung

Wenn Sie den Vorgang der Sicherung automatisieren möchten, bietet &kbackup; hier verschiedene Befehlszeilenoptionen an:

- `--auto`

  Wird &kbackup; mit dieser Option und einem `.kbp`-Profil gestartet, so wird das Programm starten, das angegebene Profil laden, die Sicherung durchführen und sich nach Fertigstellung beenden. All das wird mit einer sichtbaren &kbackup; Benutzeroberfläche durchgeführt.

- `--autobg`

  Wird &kbackup; mit dieser Option und einem `.kbp`-Profil gestartet, so wird der selbe Ablauf durchgeführt wie mit der Option `--auto`, jedoch wird keine grafische Benutzeroberfläche angezeigt. Daher die Endung bg, was für Background (Hintergrund) steht - alle Operationen werden also im Hintergrund ausgeführt, was damit die passende Option für eine Sicherung darstellt, die ⪚ aus einem cron-job gestartet wurde.

  Mit der Option `--autobg` werden die Ausgaben von &kbackup;, welche den Fortschritt anzeigen, auf die Standard-Fehlerausgabe (stderr) geschrieben. Die Standardeinstellung enthält ein paar wichtige Angaben zum Fortschritt und eine Zusammenfassung am Schluss. Wird die Option `--verbose` noch zusätzlich angegeben, so wird auch der Name jeder einzelnen Datei, die gerade gesichert wird, ausgegeben.

## Befehlsreferenz

### Das &kbackup;-Hauptfenster

#### Das Menü Datei

Datei Zuletzt geöffnete Dateien

- Zeigt ein Untermenü mit den zuletzt verwendeten Profilen.

Datei Neues Profil

- Löscht die Auswahl und das Ziel-Eingabefeld, um ein neues Profil definieren zu können.

Datei Profil laden

- Lädt ein Profil.

Datei Profil speichern

- Speichert alle Einstellungen in eine Profildatei.

Datei Profil speichern unter ...

- Speichert alle Einstellungen in eine Profildatei mit einem neuen Namen.

Datei Profil-Einstellungen

- In den Profil-Einstellungen kann man definieren, ob eine Archivdatei mit dem Namen Sicherung beginnen soll, oder ob ein alternativer Name verwendet werden soll. Ebenso kann die Größe eines Archivteils begrenzt werden werden. Weitere Informationen finden Sie im Kapitel Archiv aufteilen. Diese Einstellungen werden mit in die Profildatei gespeichert.

&Ctrl;Q Datei Beenden

- Beendet &kbackup;

#### Das Menü Einstellungen

Einstellungen Im Systembereich der Kontrollleiste andocken

- Wird diese Option eingeschaltet, wird im Systembereich ein Symbol angezeigt, welches den Status einer Sicherung anzeigt. Eine Animation bedeutet, dass gerade eine Sicherung läuft. Ansonsten wird ein statisches Symbol angezeigt. Wenn diese Option gewählt wurde, wird &kbackup; mit dem Schließen des Hauptfensters nicht beendet. Das Programm bleibt so lange verfügbar, bis es explizit durch die Aktion Beenden geschlossen. Über das Kontextmenü am Symbol im Systembereich kann eine Sicherung - genau wie im Hauptfenster - gestartet oder abgebrochen werden. Im Kurzinfo des Symbols wird der Sicherungsstatus angezeigt (Anzahl schon gesicherter Dateien, Summe des Sicherungsvolumens und die zuletzt gesicherte Datei).

Einstellungen Alle Meldungen wieder anzeigen

- Die Aktivierung dieser Option löscht alle intern gespeicherten Einstellungen aller Dialoge Diese Nachfrage nicht mehr anzeigen, die &kbackup; anzeigt.

Einstellungen Versteckte Dateien anzeigen

- Schaltet die Anzeige von versteckten Dateien (Dateien mit einem Punkt am Anfang des Namens) in der Baumansicht ein oder aus. Aktivieren Sie diese Anzeige, um nur einzelne versteckte Dateien von der Sicherung auszuschließen. Möchten Sie alle Dateien von einer Sicherung ausschließen, verwenden Sie einen Filter für Dateinamen in des Profil-Einstellungen.

#### Das Menü Hilfe

&kbackup; benutzt die bekannten &kde;-Einträge im Menü Hilfe, weitere Informationen dazu finden Sie im Abschnitt über das Menü Hilfe der &kde;-Grundlagen.

## Entwickler-Leitfaden zu &kbackup;

&kbackup; kann durch Shell-Skripte oder andere ausführbaren Programme erweitert werden, welche an bestimmten Stellen während der Datensicherung gestartet werden. Dadurch soll es ermöglicht werden, Laufwerke einzubinden, Medien auszuwerfen, oder die erzeugten Archivdateien anderweitig zu verarbeiten.

Das Skript, welches ausgeführt werden soll, muss mit dem Befehlszeilenargument `--script` angegeben werden.

Hier ist ein Beispiel-Skript:

### 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

Das Skript wird immer mit vier Befehlszeilenargumenten aufgerufen:

- Aufrufart

- Dateiname des Archivs oder Archivteils

- Zielordner/&URL;

- Einhängepunkt (mountpoint) des Zielordners, wenn es ein lokaler Ordner ist, ansonsten eine leere Zeichenkette.

Es gibt drei verschiedene Aufrufarten:

- slice_init

  wird aufgerufen, bevor ein neuer Archivteil auf der Festplatte erzeugt wird

- slice_closed

  wird aufgerufen, nachdem ein Archivteil erzeugt wurde, aber bevor dieser in den Zielordner kopiert wurde

  Das kann dazu genutzt werden, um ⪚ den Archivteil noch zusätzlich an einem anderen Ort zu speichern. Wurde als Ziel ein zentraler Server angegeben (mit einer Ziel-&URL;), aber Sie wollen die letzte Sicherung auch noch auf ihrer lokalen Festplatte zur Verfügung haben.

- slice_finished

  wird aufgerufen, nachdem ein Archivteil erfolgreich in den Zielordner kopiert wurde

## Mitwirkende und Lizenz

&kbackup;

Programm Copyright © 2006 - 2010 Martin Koller kollix@aon.at

Dokumentation Copyright © 2006 - 2010 Martin Koller

Übersetzung Martin Kollerkollix@aon.at

&underFDL; &underGPL;
&documentation.index;