%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{TARB - CPIO basiertes Backup-Programm}
\emph{Version 1.1.0 - Stand 05.09.2006\\
(c) Jens Vehlhaber  <jvehlhaber@buchenwald.de>}


\section{Allgemeines }

Das Paket ist eine einfache L"osung zur Erstellung von Backuparchiven, die mit
Hilfsmitteln wie dem Dateimanager Midnight Commander, jederzeit ge"offnet
werden k"onnen.\\

Das Programm soll folgende Funktionen erf"ullen:
\begin{itemize}
\item Erstellen eines Backups von Verzeichnissen und Dateien, die entweder lokal
      vorhanden sind, oder z.B. "Uber das SHFS-Dateisystem kurzfristig angebunden
      werden.
\item Vergleich aller "uberwachten Dateien und Verzeichnisse mit dem
      Erstellungsdatum des letzten Backuparchivs. Nur wenn neuere Dateien
      vorliegen, wird ein Backupvorgang gestartet. Dabei werden alle Dateien,
      nicht nur die ver"anderten, gesichert.
\item Anzahl der gespeicherten Backuparchive ist begrenzbar. Beim "uberschreiten
      wird das jeweils "alteste Archiv gel"oscht.
\item Mount und Umount-Kommandos zum Einbinden eines externen Datentr"agers
      k"onnen vor bzw. nach dem Backup ausgef"uhrt werden.
\end{itemize}


\section{Konfiguration}

Die Konfiguration kann "uber den Men"upunkt ''Edit Configuration'' ge"andert werden.
Nach Beendigung des Editors wird die Konfiguration automatisch auf Fehler
"uberpr"uft. Werden Fehler festgestellt, so sollten die entsprechenden Eintr"age
in jedem Fall korrigiert werden.

\begin{description}

\config{START\_TARB}{START\_TARB}{STARTTARB}
    {Aktiviert den gesamten Backuprozess.

    G"ultige Werte: \emph{yes,no}}

\config{TARB\_BACKUP\_AFTER\_BOOT}{TARB\_BACKUP\_AFTER\_BOOT}{TARBBACKUPAFTERBOOT}
    {F"uhrt ein Backup am Ende des Bootprozesses des Computers aus.

    G"ultige Werte: \emph{yes,no}}

\config{TARB\_N}{TARB\_N}{TARBN}
    {Anzahl aller Backup-Operationen

    Beispiel: \emph{4}}

\config{TARB\_x\_BACKUP\_CRON\_SCHEDULE}{TARB\_x\_BACKUP\_CRON\_SCHEDULE}{TARBxBACKUPCRONSCHEDULE}
    {Startzeitpunkt der entsprechenden Backup-Operation.
    Die 5 Werte stehen f"ur: Minute, Stunde, Tag, Monat, Wochentag.

    Beispiel t"aglich 01:15 Uhr: \emph{'15 1 * * *'}}

\config{TARB\_x\_BACKUP\_NAME}{TARB\_x\_BACKUP\_NAME}{TARBxBACKUPNAME}
    {Dateiname des zu erstellenden Backuparchivs

    Beispiel: \emph{'foobar'}}

\config{TARB\_x\_BACKUP\_TARGET}{TARB\_x\_BACKUP\_TARGET}{TARBxBACKUPTARGET}
    {Hier wird das Zielverzeichnis f"ur den Backupvorgang eingetragen. Der
    unter TARB\_x\_BACKUP\_NAME eingetragen Dateiname wird hier, um das aktuell
    Datum erweitert, gespeichert.

    Beispiel: \emph{'/mo/backup'}}

\config{TARB\_x\_BACKUP\_PATH\_BASE}{TARB\_x\_BACKUP\_PATH\_BASE}{TARBxBACKUPPATHBASE}
    {Basisverzeichnis f"ur die Backupdatei. Wenn ein externes Laufwerk
    eingebunden wird, sollte hier der komplette Mountpunkt stehen. Dadurch
    wird das Backuparchiv so erstellt, als wenn es auf dem entfernten
    Laufwerk erzeugt w"urde.

    Beispiel: \emph{'/mnt/host.foobar.local'}}

\config{TARB\_x\_BACKUP\_PATH\_LIST}{TARB\_x\_BACKUP\_PATH\_LIST}{TARBxBACKUPPATHLIST}
    {Liste mit Verzeichnissen und Dateien, die "uberwacht und gesichert werden
    sollen. Bei Verzeichnissen werden deren Unterverzeichnisse ebenfalls mit
    archiviert.\\
    Achtung, alle Eintr"age erfolgen ohne den ''/'' am Anfang!

    Beispiel: \emph{'etc/config.d etc/group etc/passwd etc/shadow'}}

\config{TARB\_x\_BACKUP\_COMPRESS}{TARB\_x\_BACKUP\_COMPRESS}{TARBxBACKUPCOMPRESS}
    {Schaltet die Komprimierung der Datei (gzip) an und aus. Wenn bereits
    komprimierte Dateien gesichert werden, so kann der Schalter auf 'no'
    gesetzt werden.

    G"ultige Werte: \emph{yes,no}}

\config{TARB\_x\_BACKUP\_MAX}{TARB\_x\_BACKUP\_MAX}{TARBxBACKUPMAX}
    {Maximale Anzahl von Backuparchive, die aufbewahrt werden sollen. Beim
    "uberschreiten wird das "alteste Archiv gel"oscht. Wird dieser Parameter
    auf TARB\_x\_BACKUP\_MAX='0' gesetzt, erfolgt keine Backupvorgang.

    Beispiel: \emph{10}}

\config{TARB\_x\_BACKUP\_MOUNT}{TARB\_x\_BACKUP\_MOUNT}{TARBxBACKUPMOUNT}
    {Erm"oglicht das Ausf"uhren eines Kommandos vor dem Starten des Backup-
    vorganges. Das kann z.B. das Mounten eines MO-Disk Datentr"agers als
    Backup-Laufwerk und eines externen SHFS Hosts gleichzeitig sein.
    (Das genannte Beispiel setzt u.a. Das Paket SHFS voraus.)

    Beispiel: \emph{'mount /mo | mount /mnt/host.foobar.local'}}

\config{TARB\_x\_BACKUP\_UMOUNT}{TARB\_x\_BACKUP\_UMOUNT}{TARBxBACKUPUMOUNT}
    {Erm"oglicht das Ausf"uhren eines Kommandos nach Abschlu"s des Backups.
    So kann z.B. ein Umount Befehl f"ur einen MO-Disk Datentr"ager
    ausgef"uhrt werden. Auch hier sind wieder mehrere Kommandos realisierbar.

    Beispiel: \emph{'umount /mo | umount /mnt/host.foobar.local'}}

\config{TARB\_ALL\_MOUNT}{TARB\_ALL\_MOUNT}{TARBALLMOUNT}
    {Wird f"ur alle Backupauftr"age ausgef"uhrt, allerdings nicht gestartet,
    wenn z. Zt. ein Backupvorgang breits l"auft.

    Beispiel: \emph{'mount /mo'}}

\config{TARB\_ALL\_UMOUNT}{TARB\_ALL\_UMOUNT}{TARBALLUMOUNT}
    {Wird am Ende aller Backupauftr"age ausgef"uhrt. Es k"onnen auch mehrere Befehle
    hintereinander verwendet werden.

    Beispiel: \emph{'umount /mo | halt'}}

\end{description}

\section{Das TARB Men"u}

Das TARB Men"u ist "uber den Men"upunkt ''Service administration'' im
zentralen Setup-Programm zu erreichen. Es ist wie folgt aufgebaut:
\begin{itemize}
\item View documentation\\
      Zeigt die Dokumentation an.
\item Edit configuration\\
      Damit kann die Konfigurationsdatei des TARB-Paketes bearbeitet,
      also die einzelnen Backupvorg"ange festgelegt werden.
\item Advanced configuration file handling\\
      Erm"oglicht eine Versionsverwaltung der TARB-Konfigurationsdatei
\end{itemize}

\section{Anmerkungen}

Nach anf"anglichen Tests mit dem Programm tar, daher auch der Name TAR-Backup,
habe ich mich dann doch f"ur das Programm CPIO entschieden.
Die Nutzung von Bandlaufwerken wurde absichtlich nicht implementiert. Bei der
enormen Installationsgeschwindigkeit von EISFAIR, macht ein komplettes
Backup, also inkl. aller Programme, eigentlich keinen Sinn mehr.
Scherzhafter weise sage ich immer: Wer nur sein Gewissen beruhigen will, der
nutzt ein Bandlaufwerk, wer mit seinen Daten arbeiten muss, greift zum
Wechseldatentr"ager.

