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

\chapter{Das Addhost-Paket}


\section{Die Einleitung}

    "Uber die Base-Konfiguration ist es nicht m"oglich zus"atzliche Hosts-Eintr"age
    zu definieren. Das Addhost-Paket behebt dieses Manko, indem es die M"oglichkeit
    bietet weitere Eintr"age persistent zu konfigurieren.


\section{Die Funktionen}

    Das Addhost-Paket beinhaltet keine weiteren externen Komponenten.


\section{Die Voraussetzungen}

    Dieses Paket ben"otigt keine weiteren Pakete um funktionieren zu k"onnen.


\section{Die Installation}

    Das Addhost-Paket wird "uber das Setup-Men"u installiert. Wird eine "altere
    Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen
    Programmdateien installiert werden.


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

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

    \begin{itemize}
        \item View documentation: Anzeigen der Dokumentation
        \item Edit configuration: Bearbeiten der Konfiguration
        \item Return: Untermen"u verlassen
    \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/addhost.


\section{Die Parameter}

\begin{description}
%%  JED - show this description only in the help file
 %  \config{ADDHOST\_DO\_DEBUG}{ADDHOST\_DO\_DEBUG}{ADDHOSTDODEBUG}
 %      Optionaler Parameter: Um den Debug-Modus zu aktivieren muss dieser
 %      Parameter auf den Wert `yes' gesetzt werden. Um den Debug-Modus zu
 %      deaktivieren  muss der Wert auf `no' gesetzt werde.
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardwert: \texttt{ADDHOST\_DO\_DEBUG='no'}

    \config{ADDHOST\_LOCALHOST\_IPADDR}{ADDHOST\_LOCALHOST\_IPADDR}{ADDHOSTLOCALHOSTIPADDR}
        Dieser Parameter zeigt die IP-Adresse des lokalen Rechners an. Der
        Wert wurde aus der Base-Konfiguration gelesen und kann auch nur dort
        angepasst werden.

        \hinweis{Dieser Parameter dient einzig der Anzeige und kann "uber das
            Paket nicht ver"andert werden.}

    \config{ADDHOST\_LOCALHOST\_NAME}{ADDHOST\_LOCALHOST\_NAME}{ADDHOSTLOCALHOSTNAME}
        Dieser Parameter zeigt den vollst"andigen Domainnamen des lokalen
        Rechners an. Der Wert wurde aus der Base-Konfiguration gelesen und
        kann auch nur dort angepasst werden.

        \hinweis{Dieser Parameter dient einzig der Anzeige und kann "uber das
            Paket nicht ver"andert werden.}

    \config{ADDHOST\_LOCALHOST\_ALIAS}{ADDHOST\_LOCALHOST\_ALIAS}{ADDHOSTLOCALHOSTALIAS}
        Dieser Parameter zeigt den Kurznamen (Aliasnamen) des lokalen Rechners an.

        \hinweis{Dieser Parameter dient einzig der Anzeige und kann "uber das
            Paket nicht ver"andert werden.}

    \config{START\_ADDHOST}{START\_ADDHOST}{STARTADDHOST}
        F"ur die Aktivierung des Addhost-Paketes muss diese Variable lediglich
        auf den Wert 'yes' gestellt werden. Die Einstellung 'no' deaktiviert
        das Addhost-Paket.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_ADDHOST='no'}

    \config{ADDHOST\_N}{ADDHOST\_N}{ADDHOSTN}
        "Uber diesen Parameter legt man die Anzahl der zus"atzlichen Hosts-Eintr"age
        fest, welche "uber die folgenden Parameter definiert werden.

        G"ultige Werte: Zahl

        Beispiel: \texttt{ADDHOST\_N='3'}

    \config{ADDHOST\_x\_IPADDR}{ADDHOST\_x\_IPADDR}{ADDHOSTxIPADDR}
        "Uber dieser Parameter legt man die IP-Adresse des zus"atzlichen Rechners
        fest.

        G"ultige Werte: IP-Adresse

        Beispiel: \texttt{ADDHOST\_1\_IPADDR='192.168.0.10'}

    \config{ADDHOST\_x\_NAME}{ADDHOST\_x\_NAME}{ADDHOSTxNAME}
        "Uber dieser Parameter legt man den vollst"andigen Domainnamen des
        zus"atzlichen Rechners fest.

        G"ultige Werte: vollst"andiger Domainname (FQDN)
        
        Beispiel: \texttt{ADDHOST\_1\_NAME='eis2.domain.lan'}

    \config{ADDHOST\_x\_ALIAS\_N}{ADDHOST\_x\_ALIAS\_N}{ADDHOSTxALIASN}
        "Uber dieser Parameter legt man die Anzahl der optionalen Aliasnamen
        des zus"atzlichen Rechners fest.

        G"ultige Werte: Hostname oder vollst"andiger Domainname (FQDN)

        Standardeinstellung: \texttt{ADDHOST\_1\_ALIAS\_N='0'}

        \hinweis{Der Kurzname des Rechners wird standardm"a"sig aus dem "uber den
            Parameter ADDHOST\_x\_NAME definierten vollst"andigen Domainnamen
            abgeleitet.}

    \config{ADDHOST\_x\_ALIAS\_y}{ADDHOST\_x\_ALIAS\_y}{ADDHOSTxALIASy}
        "Uber diesen Parameter legt man einen optionalen Aliasnamen f"ur einen
        zus"atzlichen Rechner fest.

        G"ultige Werte: Aliasname

        Beispiel: \texttt{ADDHOST\_1\_ALIAS\_1='web'}
\end{description}
