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

\chapter{Das Gkrellmd-Paket}

\section{Die Voraussetzungen}

   Dieses Paket ben{\"o}tigt mindestens base Update 1.0.8.

\section{Die Installation}

   Das \verb+Gkrellmd+-Paket wird {\"u}ber das Setup-Men{\"u} installiert. Wird eine
   {\"a}ltere Paket-Version vorgefunden, so wird deren Konfiguration
   gesichert und das alte Paket deinstalliert bevor die neuen
   Programmdateien installiert und die Konfiguration {\"u}bernommen wird.
   Danach wird der Konfigurations-Editor gestartet um die
   Konfiguration anzupassen.

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

   Das Men{\"u} besteht aus folgenden Punkten:

\begin{enumerate}
        \item View documentation: zeigt diese Dokumentation an
        \item Configuration: {\"o}ffnet den Konfigurationseditor
        \item Advanced configuration file handling
        \item Show gkrellmd status: Zeigt an, ob gkrellmd l{\"a}uft
        \item Start gkrellmd services: Startet gkrellmd
        \item Stop gkrellmd services: Beendet gkrellmd
        \item[0.] Exit
\end{enumerate}

\section{Die Konfigurationsdatei}

   In der Konfigurationsdatei, die {\"u}ber das Men{\"u} zug{\"a}nglich ist, sind
   folgende Parameter vorhanden; wer sie von Hand editieren will findet
   sie unter \verb+/etc/config.d/gkrellmd+.

\section{Die Parameter}

\begin{description}
   \config{START\_GKRELLMD}{START\_GKRELLMD}{STARTGKRELLMD}
        Aktiviert gkrellmd

        G{\"u}ltige Werte: yes, no

        Standardeinstellung: \verb+START_GKRELLMD='yes'+

   \config{GKRELLMD\_ALLOW\_HOST\_N}{GKRELLMD\_ALLOW\_HOST\_N}{GKRELLMDALLOWHOSTN}
        Anzahl der 'allow-host'-Eintr{\"a}ge in der
        Konfigurationsdatei (\verb+/etc/gkrellmd.conf+)

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+GKRELLMD_ALLOW_HOST_N='1'+

   \config{GKRELLMD\_ALLOW\_HOST\_X}{GKRELLMD\_ALLOW\_HOST\_X}{GKRELLMDALLOWHOSTX}
        Legt fest, welche Rechner sich mit dem gkrellmd-Server
        verbinden d{\"u}rfen.

        G{\"u}ltige Werte: IP-Adressen/IP-Adressbereiche in Form von bspw. \verb+'192.168.6.*'+

        Standardeinstellung: \verb+GKRELLMD_ALLOW_HOST_1='192.168.6.*'+

   \config{GKRELLMD\_USER/GKRELLMD\_GROUP}{GKRELLMD\_USER/GKRELLMD\_GROUP}{GKRELLMDUSERGROUP}
        Wenn gkrellmd gestartet ist, k{\"o}nnen User und Gruppe
        dieses Prozesses ge{\"a}ndert werden.

        G{\"u}ltige Werte: existierender User bzw. Gruppe

        Standardeinstellung: \verb+GKRELLMD_USER='nobody'+ bzw.\newline
                              \verb+GKRELLMD_GROUP='nogroup'+

   \config{GKRELLMD\_UPDATE\_HZ}{GKRELLMD\_UPDATE\_HZ}{GKRELLMDUPDATEHZ}
        Hiermit l"asst sich die Update-Frequenz des Daemons
        pro Sekunde festlegen. Sie kann zwischen 1 und 10 
        liegen und sollte niedriger liegen als die des 
        Clients. Um den Netzwerkverkehr zu schonen, 
        sollten kleine Werte gew{\"a}hlt werden.

        G{\"u}ltige Werte: 1-10

        Standardeinstellung: \verb+GKRELLMD_UPDATE_HZ='3'+

   \config{GKRELLMD\_MAX\_CLIENTS}{GKRELLMD\_MAX\_CLIENTS}{GKRELLMDMAXCLIENTS}
        Legt fest, wie viele Clients sich gleichzeitig 
        maximal mit dem Daemon verbinden k{\"o}nnen.

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+GKRELLMD_MAX_CLIENTS='1'+

   \config{GKRELLMD\_PORT}{GKRELLMD\_PORT}{GKRELLMDPORT}
        Mit diesem Parameter kann man einstellen, auf 
        welchem Port der Gkrellm-Daemon auf 
        Client-Verbindungen h{\"o}ren soll.

        G{\"u}ltige Werte: Ports (1-65535)

        Standardeinstellung: \verb+GKRELLMD_PORT='19150'+

   \config{GKRELLMD\_IO\_TIMEOUT}{GKRELLMD\_IO\_TIMEOUT}{GKRELLMD_IO_TIMEOUT}
        Wenn die hier angegebene Zeit in Sekunden {\"u}berschritten
        ist, trennen sich die angeschlossenen Clients und versuchen 
        keine Wiederverbindung. Dies dient dazu, bei nicht 
        korrekt beendetem gkrellmd eventuell verbliebene offene
        Socket-Verbindungen zu den Clients zu kappen. Eine Zahl 
        unter 2 bedeutet dabei, dass es keinen I/O-Timeout gibt 
        und die Clients somit angewiesen werden, eine 
        Wiederverbindung zu versuchen.

        G{\"u}ltige Werte: Zahl (Sekunden)

        Standardeinstellung: \verb+GKRELLMD_IO_TIMEOUT='0'+

   \config{GKRELLMD\_RECONNECT\_TIMEOUT}{GKRELLMD\_RECONNECT\_TIMEOUT}{GKRELLMDRECONNECTTIMEOUT}
        Hiermit werden angeschlossene Clients angewiesen, 
        nach einem Timeout nach der angegebenen Zeit in Sekunden 
        zu versuchen, wieder Verbindung mit dem Gkrellm-Server 
        herzustellen. Eine Zahl unter 2 bedeutet dabei, dass 
        die Clients angewiesen werden, keine automatische 
        Wiederverbindung durchzuf{\"u}hren.

        G{\"u}ltige Werte: Zahl (Sekunden)

        Standardeinstellung: \verb+GKRELLMD_RECONNECT_TIMEOUT='5'+

   \config{GKRELLMD\_FS\_INTERVAL}{GKRELLMD\_FS\_INTERVAL}{GKRELLMDFSINTERVAL}
        Dies bezeichnet das Intervall zwischen zwei 
        Dateisystemchecks auf lokalen Dateisystemen.

        G{\"u}ltige Werte: Zahl (Sekunden)

        Standardeinstellung: \verb+GKRELLMD_FS_INTERVAL='2'+

   \config{GKRELLMD\_NFS\_INTERVAL}{GKRELLMD\_NFS\_INTERVAL}{GKRELLMDNFSINTERVAL}
        Das Intervall zwischen zwei Dateisystemchecks auf NFS-Dateisystemen.
        Ein Wert von 0 schaltet die Dateisystemchecks 
        f{\"u}r NFS-Dateisysteme aus.

        G{\"u}ltige Werte: Zahl (Sekunden)

        Standardeinstellung: \verb+GKRELLMD_NFS_INTERVAL='16'+


   \config{GKRELLMD\_INET\_INTERVAL}{GKRELLMD\_INET\_INTERVAL}{GKRELLMDINETINTERVAL}
        Der Internet Monitor liest TCP-Verbindungen einmal pro Sekunde.
        Bei einem SMP-Kernel sollte dies auf m{\"o}glichst niedrige
        Werte gesetzt werden, weil das h{\"a}ufige Lesen von \verb+/proc/net/tcp+
        betr{\"a}chtliche CPU-Last erzeugt.
        Ein Wert von 0 schaltet dieses Feature ab.

        G{\"u}ltige Werte: Zahl (Sekunden)

        Standardeinstellung: \verb+GKRELLMD_INET_INTERVAL='0'+

   \config{GKRELLMD\_MAILBOX\_N}{GKRELLMD\_MAILBOX\_N}{GKRELLMDMAILBOXN}
        Anzahl der zu {\"u}berwachenden Mailboxen.

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+GKRELLMD_MAILBOX_N='0'+


   \config{GKRELLMD\_MAILBOX\_X}{GKRELLMD\_MAILBOX\_X}{GKRELLMDMAILBOXX}
        Hier wird der volle Pfad zu einer zu 
        {\"u}berwachenden Mailbox angegeben.

        G{\"u}ltige Werte: absoluter Pfad

        Standardeinstellung: \verb+GKRELLMD_MAILBOX_1='/var/spool/mail/user'+


   \config{GKRELLMD\_PLUGIN\_N}{GKRELLMD\_PLUGIN\_N}{GKRELLMDPLUGINN}
        Anzahl der einzubindenden Plugins. Es gibt 
        nicht viele Plugins, die f{\"u}r den serverseitigen
        Gebrauch geeignet sind, ich habe bis jetzt 
        nur eines gefunden -- '\verb+gkrelltopd+' (mit 'd').
        Dieses mit dem Gkrellmd-Paket mitgelieferte
        Plugin kann die drei prozessorlastigsten
        Prozesse des Servers an einen Client 
        {\"u}bermitteln. Es erfordert jedoch am Client
        die Installation und Konfiguration des 
        Plugins '\verb+gkrelltop+' (ohne 'd'!).

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+GKRELLMD_PLUGIN_N='1'+

   \config{GKRELLMD\_PLUGIN\_X}{GKRELLMD\_PLUGIN\_X}{GKRELLMDPLUGINX}
        Hier wird das zu verwendende Plugin mit seinem Namen eingetragen.

        G{\"u}ltige Werte: beliebig

        Standardeinstellung: \verb+GKRELLMD_PLUGIN_1='gkrelltopd'+
\end{description}
