Dokumentation zum gkrellmd-Paket fuer EIS/FAIR Installation Das gkrellmd-Paket wird ueber das Setup-Menue installiert. Wird eine aeltere Paket-Version vorgefunden, so wird deren Konfiguration gesichert und das alte Paket deinstalliert bevor die neuen Programmdateien installiert und die Konfiguration uebernommen wird. Danach wird der Konfigurations-Editor gestartet um die Konfiguration anzupassen. Menue im Setup-Programm Das Menue besteht aus folgenden Punkten: 1: View documentation: zeigt diese Dokumentation an 2: Configuration: oeffnet den Konfigurationseditor 3: Advanced configuration file handling 4: Show gkrellmd status: Zeigt an, ob gkrellmd laeuft 5: Start gkrellmd services: Startet gkrellmd 6: Stop gkrellmd services: Beendet gkrellmd 0: Exit Die Konfigurationsdatei In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/gkrellmd. START_GKRELLMD Aktiviert gkrellmd Gueltige Werte: yes, no Standard-Einstellung: START_GKRELLMD='yes' GKRELLMD_ALLOW_HOST_N Anzahl der 'allow-host'-Eintraege in der Konfigurationsdatei (/etc/gkrellmd.conf) Gueltige Werte: Zahl Standard-Einstellung: GKRELLMD_ALLOW_HOST_N='1' GKRELLMD_ALLOW_HOST_X Legt fest, welche Rechner sich mit dem gkrellmd-Server verbinden duerfen. Gueltige Werte: IP-Adressen und IP-Adressbereiche in Form von bspw. '192.168.6.*' Standard-Einstellung: GKRELLMD_ALLOW_HOST_1='192.168.6.*' GKRELLMD_USER/GKRELLMD_GROUP Wenn gkrellmd gestartet ist, koennen User und Gruppe dieses Prozesses geaendert werden. Gueltige Werte: existierender User bzw. Gruppe Standard-Einstellung: GKRELLMD_USER='nobody' GKRELLMD_GROUP='nogroup' GKRELLMD_UPDATE_HZ Hiermit laesst 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 gewaehlt werden. Gueltige Werte: 1-10 Standard-Einstellung: GKRELLMD_UPDATE_HZ='3' GKRELLMD_MAX_CLIENTS Legt fest, wieviele Clients sich gleichzeitig maximal mit dem Daemon verbinden koennen. Gueltige Werte: Zahl Standard-Einstellung: GKRELLMD_MAX_CLIENTS='1' GKRELLMD_PORT Mit diesem Parameter kann man einstellen, auf welchem Port der Gkrellm-Daemon auf Client-Verbindungen hoeren soll. Gueltige Werte: Ports (1-65535) Standard-Einstellung: GKRELLMD_PORT='19150' GKRELLMD_IO_TIMEOUT Wenn die hier angegebene Zeit in Sekunden ueberschritten 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. Gueltige Werte: Zahl (Sekunden) Standard-Einstellung: GKRELLMD_IO_TIMEOUT='0' GKRELLMD_RECONNECT_TIMEOUT Hiermit werden angeschlossene Clients angewiesen, nach einem Timeout nach der angebenen 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 durchzufuehren. Gueltige Werte: Zahl (Sekunden) Standard-Einstellung: GKRELLMD_RECONNECT_TIMEOUT='5' GKRELLMD_FS_INTERVAL Dies bezeichnet das Intervall zwischen zwei Dateisystemchecks auf lokalen Dateisystemen. Gueltige Werte: Zahl (Sekunden) Standard-Einstellung: GKRELLMD_FS_INTERVAL='2' GKRELLMD_NFS_INTERVAL Dies bezeichnet das Intervall zwischen zwei Dateisystemchecks auf NFS-Dateisystemen. Ein Wert von 0 schaltet die Dateisystemchecks fuer NFS-Dateisysteme aus. Gueltige Werte: Zahl (Sekunden) Standard-Einstellung: GKRELLMD_NFS_INTERVAL='16' GKRELLMD_INET_INTERVAL Der Internet Monitor liest TCP-Verbindungen einmal pro Sekunde. Bei einem SMP-Kernel sollte dies auf moeglichst niedrige Werte gesetzt werden, weil das haeufige Lesen von /proc/net/tcp betraechtliche CPU-Last erzeugt. Ein Wert von 0 schaltet dieses Feature ab. Gueltige Werte: Zahl (Sekunden) Standard-Einstellung: GKRELLMD_INET_INTERVAL='0' GKRELLMD_MAILBOX_N Anzahl der zu ueberwachenden Mailboxen. Gueltige Werte: Zahl Standard-Einstellung: GKRELLMD_MAILBOX_N='0' GKRELLMD_MAILBOX_X Hier wird der volle Pfad zu einer zu ueberwachenden Mailbox angegeben. Gueltige Werte: absoluter Pfad Standard-Einstellung: GKRELLMD_MAILBOX_1='/var/spool/mail/user' GKRELLMD_PLUGIN_N Anzahl der einzubindenen Plugins. Es gibt nicht viele Plugins, die fuer den serverseitigen Gebrauch geeignet sind, ich habe bis jetzt nur eines gefunden - 'gkrelltopd' (mit 'd'). Dieses mit dem gkrellmd-Paket mitgelieferte Plugin kann die drei prozessorlastigsten Prozesse des Servers an einen Client uebermitteln. Es erfordert jedoch am Client die Installation und Konfiguration des Plugins 'gkrelltop' (ohne 'd'!). Gueltige Werte: Zahl Standard-Einstellung: GKRELLMD_PLUGIN_N='1' GKRELLMD_PLUGIN_X Hier wird das zu verwendende Plugin mit seinem Namen eingetragen. Gueltige Werte: beliebig Standard-Einstellung: GKRELLMD_PLUGIN_1='gkrelltopd' Marcus Roeckrath, 2020-03-26