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

\chapter{Das Bcclient-Paket}

\section{Die Einleitung}

    Beim Bcclient-Paket handelt es sich um den Client-Teil der Backup-Software
    'Bacula'. Dieses Paket muss auf all den Rechnern installiert werden,
    \emph{von} denen Daten gesichert werden sollen. Es enth"alt den
    sogenannte 'File Daemon', welcher f"ur das Lesen der zu sichernden
    Dateien verantwortlich ist. Im Restore-Fall werden durch diesen Prozess
    die gew"unschten Daten auch wieder auf die Festplatte geschrieben.


\section{Die Funktionen}

    Das Bcclient-Paket besteht aus folgender Komponente:

    \begin{itemize}
        \item Bacula - Client-Programm der Backup-Software.\\
            (\url{http://bacula.org/})
        \end{itemize}

\section{Die Voraussetzungen}

    Ein lauff"ahiger \eisfair-Server ;-$)$


\section{Die Installation}

    Das Bcclient-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird deren Konfiguration gesichert
    und das alte Paket deinstalliert bevor die neuen Programmdateien
    installiert werden und die Konfiguration "ubernommen wird.\\
    Nach dem Installieren der Programmdateien wird direkt der Konfigurations-
    Editor gestartet um die Konfiguration anzupassen. Nach Beendigung dieses
    Schrittes werden die Konfigurationsdateien generiert und alle ben"otigten
    Programme gestartet.

\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \begin{itemize}
        \item Bacula
        \begin{itemize}
            \item View package documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Show status: Status des Bcclient-Prozesses anzeigen
            \item Stop file daemon: Bcclient-Prozess beenden
            \item Start file daemon: Bcclient-Prozess starten
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item Return: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration' ge"andert
    werden.  Standardm"a"sig wird der Editor aufgerufen, der in der Environment-
    Konfiguration "uber die Variable 'EDITOR' festgelegt wurde. Nachdem der
    Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden
    soll. Wird dies best"atigt, werden "uber ein Skript die Anpassungen umgehend
    wirksam gemacht.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind folgende
    Parameter vorhanden; wer sie von Hand editieren will findet sie unter
    /etc/config.d/bcclient.


\section{Die Parameter}

\begin{description}

\config{START\_BCCLIENT}{START\_BCCLIENT}{STARTBCCLIENT}
    F"ur die Aktivierung des Bcclient-Paketes muss diese Variable lediglich auf
    den Wert 'yes' gestellt werden. Die Einstellung 'no' schaltet es ab.

    G"ultige Werte: yes, no

    Standardeinstellung: START\_BCCLIENT='no'

\config{BCCLIENT\_DIRECTOR\_NAME}{BCCLIENT\_DIRECTOR\_NAME}{BCCLIENTDIRECTORNAME}
    Hier wird der Name des Directors angegeben, welcher diesen Client steuert.
    Diese Angabe entspricht dem unter BCSRV\_DIRECTOR\_NAME angegebenen Wert,
    wenn das Backup auf einem anderen \eisfair-Server durchgef"uhrt wird.

    Der angegebene Name sollte auf die Zeichenfolge '-dir' enden. Wird diese
    Zeichenfolge nicht vorgefunden, so wird sie automatisch erg"anzt.

    G"ultige Werte: Beliebiger String ohne Leerzeichen

    Standardeinstellung: BCCLIENT\_DIRECTOR\_NAME=''

\config{BCCLIENT\_DIRECTOR\_PASSWORD}{BCCLIENT\_DIRECTOR\_PASSWORD}{BCCLIENTDIRECTORPASSWORD}
    Passwort des Bacula Director Prozesses.

    G"ultige Werte: Beliebiger String

    Standardeinstellung: BCCLIENT\_DIRECTOR\_PASSWORD=''

\config{BCCLIENT\_FD\_NAME}{BCCLIENT\_FD\_NAME}{BCCLIENTFDNAME}
    Hier wird der Name des File Daemon angegeben, welcher f"ur das Backup
    dieses Clients zust"andig ist. Diese Angabe entspricht dem unter 
    BCSRV\_tbd\_NAME angegebenen Wert, wenn das Backup auf einer anderen 
    \eisfair-Server durchgef"uhrt wird.

    Der angegebene Name sollte auf die Zeichenfolge '-fd' enden. Wird diese
    Zeichenfolge nicht vorgefunden, so wird sie automatisch erg"anzt.

    G"ultige Werte: Beliebiger String ohne Leerzeichen

    Standardeinstellung: BCCLIENT\_FD\_NAME=''

\config{BCCLIENT\_MONITOR\_DIRECTOR\_NAME}{BCCLIENT\_MONITOR\_DIRECTOR\_NAME}{BCCLIENTMONITORDIRECTORNAME}

    G"ultige Werte: Beliebiger String ohne Leerzeichen

    Standardeinstellung: BCCLIENT\_MONITOR\_DIRECTOR\_NAME=''

\config{BCCLIENT\_MONITOR\_DIRECTOR\_PASSWORD}{BCCLIENT\_MONITOR\_DIRECTOR\_PASSWORD}{BCCLIENTMONITORDIRECTORPASSWORD}

    G"ultige Werte: Beliebiger String

    Standardeinstellung: BCCLIENT\_MONITOR\_DIRECTOR\_PASSWORD=''

\config{BCCLIENT\_ADVANCED\_SETTINGS}{BCCLIENT\_ADVANCED\_SETTINGS}{BCCLIENTADVANCEDSETTINGS}
    Um die erweiterten Einstellungen modifizieren zu k"onnen, muss dieser
    Punkt auf den Wert 'yes' gesetzt werden.

    G"ultige Werte: yes, no

    Standardeinstellung: BCCLIENT\_ADVANCED\_SETTINGS='no'

\config{BCCLIENT\_FD\_PORT}{BCCLIENT\_FD\_PORT}{BCCLIENTFDPORT}
    Hier kann der zu verwendende Port f"ur den File Daemon festgelegt werden.

    G"ultige Werte: Portnummer

    Standardeinstellung: BCCLIENT\_FD\_PORT='9102'

\config{BCCLIENT\_FD\_WORKING\_DIR}{BCCLIENT\_FD\_WORKING\_DIR}{BCCLIENTFDWORKINGDIR}
    Hier kann das zu verwendende Bacula-Arbeitsverzeichnis festgelegt 
    werden.

    G"ultige Werte: absoluter Pfad

    Standardeinstellung: BCCLIENT\_FD\_WORKING\_DIR='/data/bcsrv'

\config{BCCLIENT\_FD\_PID\_DIR}{BCCLIENT\_FD\_PID\_DIR}{BCCLIENTFDPIDDIR}
    In dem hier angegebenen Verzeichnis legt Bacula w"ahrend der Laufzeit
    die PID ab.

    G"ultige Werte: absoluter Pfad

    Standardeinstellung: BCCLIENT\_FD\_PID\_DIR='/var/run'

\config{BCCLIENT\_FD\_MAX\_JOBS}{BCCLIENT\_FD\_MAX\_JOBS}{BCCLIENTFDMAXJOBS}

    G"ultige Werte: Numerischer Wert

    Standardeinstellung: BCCLIENT\_FD\_MAX\_JOBS='20'

\config{BCCLIENT\_MESSAGES\_NAME}{BCCLIENT\_MESSAGES\_NAME}{BCCLIENTMESSAGESNAME}

    G"ultige Werte: Beliebiger String ohne Leerzeichen

    Standardeinstellung: BCCLIENT\_MESSAGES\_NAME=''

\config{BCCLIENT\_MESSAGES\_DIRECTOR}{BCCLIENT\_MESSAGES\_DIRECTOR}{BCCLIENTMESSAGESDIRECTOR}

    G"ultige Werte: Beliebiger String ohne Leerzeichen

    Standardeinstellung: BCCLIENT\_MESSAGES\_DIRECTOR=''

\config{BCCLIENT\_MESSAGES\_ENTRY\_N}{BCCLIENT\_MESSAGES\_ENTRY\_N}{BCCLIENTMESSAGESENTRYN}
    Anzahl der hinzuzuf"ugenden Nachrichtentypen bzw. Einschr"ankungen.

    G"ultige Werte: Numerischer Wert

    Standardeinstellung: BCCLIENT\_MESSAGES\_ENTRY\_N='3'

\config{BCCLIENT\_MESSAGES\_ENTRY\_x\_TYPE}{BCCLIENT\_MESSAGES\_ENTRY\_x\_TYPE}{BCCLIENTMESSAGESENTRYxTYPE}
    Hier wird der Typ der zu versendenden Nachricht eingestellt. Dabei stehen
    die unten aufgelisteten M"oglichkeiten zur Wahl, welche jeweils durch ein
    vorangestelltes '!' negiert werden k"onnen. Die hier ausgew"ahlten 
    Eintr"age bilden im effektiven Konfigurationsfile eine Liste.

    \begin{itemize}
        \item 'info' - General information messages.\\

        \item 'warning' - Warning messages. Generally these are some unusual
            conditions but not expected to be serious.\\

        \item 'error' - Non-fatal error messages. The job continues running.
            Any error message should be investigated as it means that something
            went wrong.\\

        \item 'fatal' - Fatal error messages. Fatal errors cause the job to
            terminate.\\

        \item 'terminate' - Message generated when the daemon shuts down.\\

        \item 'notsaved' - Files not saved because of some error. Usually
            because the file cannot be accessed (i.e. it does not exist or
            is not mounted).\\

        \item 'skipped' - Files that were skipped because of a user supplied
            option such as an incremental backup or a file that matches an
            exclusion pattern. This is not considered an error condition such
            as the files listed for the notsaved type because the configuration
            file explicitly requests these types of files to be skipped. For 
            example, any unchanged file during an incremental backup, or any
            subdirectory if the no recursion option is specified.\\

        \item 'mount' - Volume mount or intervention requests from the Storage
            daemon. These requests require a specific operator intervention
            for the job to continue.\\

        \item 'restored' - The ls style listing generated for each file
            restored is sent to this message class.\\

        \item 'all' - All message types.\\

        \item 'security' - Security info/warning messages principally from
            unauthorized connection attempts.\\

        \item 'alert' - Alert messages. These are messages generated by tape
            alerts.\\

        \item 'volmgmt' - Volume management messages. Currently there are no
            volume management messages generated.\\
    \end{itemize}

    Standardeinstellung: BCCLIENT\_MESSAGES\_ENTRY\_%\_TYPE=''
\end{description}

