# Das &kbackup; Handbuch

## Einführung

&kbackup; ist ein KDE-Programm zur Datensicherung von beliebigen Dateien und Verzeichnissen, wobei es einen einfach zu bedienenden Verzeichnisbaum zur Selektion zur Verfügung stellt. Gewählte Einstellungen können in so genannten "Profil" Dateien gespeichert werden, wobei ein Profil eine einfache Textdatei ist, welche die Auswahl für Verzeichnisse und Dateien beinhält, welche für die Sicherung zu inkludieren oder zu exkludieren sind. Ebenso beinhält es die Definition, wohin die Sicherung geschrieben werden soll. Das Ziel einer Sicherung kann entweder ein lokales Verzeichnis sein (z.B. ein lokal eingebundenes Gerät wie ein ZIP Laufwerk, USB Stick, etc.) aber es kann auch ein anderer Rechner - unter Angabe einer URL (z.B. smb://rechner/ziel) - sein, um die Daten auf einen zentralen Server zu sichern.

Das Programm wurde so entworfen, dass es möglichst einfach in der Bedienung ist und auch von nicht Computer Experten bedient werden kann.

Das Archivierungsformat ist das wohlbekannte Tar-Format, wobei die Daten komprimiert gespeichert werden (bzip2 oder gzip).

Die aktuelle Implementierung beinhält nur den Sicherungs Schritt. Um die Daten wieder in das System zurückzuspielen muß man derzeit z.B. konqueror benutzen, um eine TAR Sicherungs Datei zu öffnen, und dann Teile daraus z.B. via Drag/Drop in das System zurückbringen. Das ist einer der Vorteile der Verwendung des weitverbreiteten TAR Dateiformates.

## Verwendung von &kbackup;

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

Wenn sie ein Verzeichnis wählen, wird &kbackup; automatisch alle Dateien und Unterverzeichnisse darin sichern. Wenn sie Teile in einem selektierten Verzeichnis von der Sicherung ausnehmen wollen, müssen sie einfach die entsprechenden Verzeichnisse oder Dateien darin deselektieren.

Generell bedeutet das: Ein selektiertes Verzeichnis wird alle Dateien und Unterverzeichnisse darin sichern, außer jene Teile, die explizit deselektiert wurden. Das bedeutet auch, wann immer sie ein Profil (siehe weiter unten) wiederverwenden, werden auch alle neuen Verzeichnisse und Dateien, die in der Zwischenzeit dazugekommen sind, ebenfalls gesichert.

Hier ist ein Bildschirmfoto von &kbackup; Bildschirmfoto vom Hauptfenster

### 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 Datei Menü und wählen sie "Speichere Profil".

Um eine Auswahl wieder zu Laden verwenden sie das Datei Menü "Lade Profil".

Um alle Einstellungen und Selektionen wieder zu entfernen verwenden sie das Datei Menü "Neues Profil".

&kbackup; speichert in einem Profil die Selektionen für alle inkludierten Dateien und Verzeichnisse, für alle exkludierten Dateien und Verzeichnisse, das Ziel für die Sicherung, das gewählte Archiv-Präfix, sowie das gewählte Größenlimit für einen Archiv Teil.

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.

z.B.:

kbackup meineDaten.kbp

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

### Archiv Teile

Da ein Medium normalerweise eine limitierte Kapazität hat (z.B. 100MB ZIP Diskette), teilt &kbackup; die Sicherung in einzelne Teile auf.

Jeder Archiv Teil hat seinen eigenen Dateinamen, welcher wie folgt aussieht:

backup_2006.08.26-13.04.44_1.tar

Der Name beinhä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 "backup" für die Archive eingestellt werden.

Um unabhängig von der verfügbaren Kapazität des Zielverzeichnisses eine Sicherung in mehrere Archiv Teile einer maximalen Größe aufteilen zu können, kann man im Profile Einstellungen Dialog eine Maximalgröße pro Archiv Teil festlegen. Dies hat z.B. dann Sinn, wenn man eine Sicherung für das nachträgliche Brennen auf eine CD/DVD vorbereiten will. Wenn sie die Größe eines Archiv Teiles explizit limitieren, dann erscheint die verfügbare Größe mit der Markierung (*) im Hauptfenster.

### Archiv Komprimierung

&kbackup; komprimiert immer die gesicherten Dateien (außer dies wird in den Profil Einstellungen explizit deaktiviert). Abhängig von der Verfügbarkeit auf ihrem System wird entweder bzip2 oder gzip als Komprimierung verwendet.

Wenn sie als Ziel ein lokales Verzeichnis gewählt haben (z.B. ihre extra Festplatte, ZIP Laufwerk, etc.) - d.h. sie haben keine URL angegeben - wird &kbackup; die gesamte Sicherung aufgrund der beschränkten Medium Kapazität in einzelne Archiv Teile aufteilen. &kbackup; wird jede einzelne Datei komprimieren und mit einer angehängten Dateiendung (.bzip2 oder .gz) im nicht komprimierten .tar Archiv speichern.

z.B.: backup_2006.08.26-13.04.44_1.tar

Wenn sie als Ziel eine URL angegeben haben (z.B.: smb://rechner/ziel), wird als Kapazität "unlimitiert" angezeigt. In diesem Fall wird &kbackup; nur eine Archiv Datei erzeugen, welche die unkomprimierten original Dateien beinhält, und es wird zum Schluß das gesamte .tar Archiv komprimiert.

Das Resultat ist dann immer eine Archiv Datei mit der Endung .tar.bzip2 oder .tar.gz

z.B.: backup_2006.08.26-13.04.44_1.tar.bzip2

## Kommando Referenz

### Das &kbackup; Hauptfenster

#### Das Datei Menü

Datei Neues Profil

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

Datei Lade Profil

- Lädt ein Profil

Datei Speichere Profil

- Speichert alle Einstellungen in eine Profil Datei

Datei Profil Einstellungen

- In den Profileinstellungen kann man definieren, ob ein Archiv Datei mit dem Namen "backup" beginnen soll, oder ob ein alternativer Name verwendet werden soll. Ebenso kann die Größe eines Archiv Teiles limitiert werden. Siehe Kapitel "Archiv Teile". Diese Einstellungen werden mit in die Profil Datei gespeichert.

&Strg;Q Datei Beenden

- Beendet &kbackup;

#### Das Einstellungen Menü

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, daß 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 "Beenden" Aktion beendet wird. Über das Kontextmenü am Symbol im Systembereich kann eine Sicherung - genau wie im Hauptfenster - gestartet oder abgebrochen werden. Im Tooltip des Symbols wird der Sicherungs Status angezeigt (Anzahl schon gesicherter Dateien, Summe des Sicherungsvolumens und die zuletzt gesicherte Datei).

#### Das Hilfe Menü

&help.menu.documentation;

## Entwickler Leitfaden zu &kbackup;

&kbackup; kann durch Shellscripte (oder andere ausführbaren Programme) erweitert werden, welche an bestimmten Stellen während der Datensicherung gestartet werden. Die Idee dahinter ist es zu ermöglichen Laufwerke einzubinden, Medien auszuwerfen, oder andere System spezifischen Dinge mit den erzeugten Archiv Dateien zu erledigen.

Das script welches ausgeführt werden soll muß mit dem --script Kommandozeilen Argument angegeben werden.

Hier ist ein Beispiel Script

### 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 script wird immer mit vier Kommandozeilen Argumenten aufgerufen:

- Aufruf Art

- Archiv (Teil) Dateiname

- Ziel Verzeichnis/URL

- Einhängepunkt (mountpoint) des Zielverzeichnisses wenn es ein lokales Verzeichnis ist ansonsten ein Leerstring

Es gibt drei verschiedene Aufruf Arten:

- slice_init

  wird augerufen bevor ein neuer Archiv Teil auf der Festplatte erzeugt wird

- slice_closed

  wird aufgerufen nachdem ein Archiv Teil erzeugt wurde, aber bevor dieser in das Zielverzeichnis kopiert wurde

  Das kann dazu genutzt werden, um z.B. den Archiv Teil noch zusätzlich an einem anderen Ort zu speichern. Z.B. 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 Archiv Teil erfolgreich in das Zielverzeichnis kopiert wurde

Ein weiteres Beispiel script zeigt, wie man die Anzahl der Sicherungs Dateien am Zielort auf eine bestimmte Anzahl eingrenzen kann:

### rotateScript.sh

    #!/bin/sh
    # kbackup script to do a rotating backup (keep only a defined number of backups)

    NUM_BACKUPS=20

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

    case "$mode" in
     "slice_init" )
     ;;

     "slice_closed" )
     ;;

     "slice_finished" )
       count=`ls -A1 $target | wc -l`
       if [ $count -ge $NUM_BACKUPS ]
       then
         removeCount=`expr $count - $NUM_BACKUPS`
         oldest=`ls -A1 ${target}/* | sort | head -n $removeCount`
         rm -f ${oldest}
       fi
     ;;
    esac

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

## Mitwirkende und Lizenz

&kbackup;

Programm Copyright © 2006, 2007 Martin Koller m.koller@surfeu.at

Dokumentation Copyright © 2006, 2007 Martin Koller

&underFDL; &underGPL;

## Installation

### Wie kommt man zu &kbackup;

Sie können &kbackup; von www.kde-apps.org runterladen.

### Kompilation und Installation

&install.compile.documentation;
&documentation.index;