%
% imond.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel IMOND %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Das IMonD Paket}


\section{Allgemeines}


    \eisfair unterst"utzt \glqq{}DSL\grqq{} via PPPoE (externe, "uber
    Ethernet angeschlossene DSL-Modem, "uber die pppoe gefahren wird)

    Das Paket beinhaltet auch den Kommanozeilen-Client 'imonc'
    aufruf imonc \$HOST

    z.B  imonc localhost

    \achtung{Dieses Paket ist deprecated EOL,
             ISDN wird im Kernel nicht mehr unterst"utzt.
             Es gibt f"ur das IMonD Paket keinerlei Support.}

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

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

    \mbox{}

    \begin{tabular}{llll}
    & 4. &  Service administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  IMonD \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 6. & Advanced configuration file handling \\
    & 4. & Show status \\
    & 5. & Stop service \\
    & 6. & Start service \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt \glqq{}Edit configuration\grqq{}
    ge"andert werden.

    Nachdem der Editor beendet wurde, wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, so werden "uber ein Skript
    die Anpassungen umgehend wirksam gemacht. Es ist zu beachten, dass einige
    Programme eigenst"andig, bei erneuter Aktivierung, die Konfigurationsdatei
    erneut einlesen, sodass eine Beantwortung dieser Abfrage mit 'Nein' nur zu
    einem kurzen Aufschub der Aktivierung f"uhrt.




\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\\
    \texttt{/etc/config.d/imond}


\section{Die Parameter}


\begin{description}

\config{START\_IMOND}
{START\_IMOND}
{STARTIMOND}
{
    Mit \texttt{START\_IMOND} kann man einstellen,
    ob der IMonD-Server aktiviert werden soll. IMmonD "ubernimmt
    dabei das Monitoring/Controlling

    G"ultige Werte: yes, no

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


\config{IMOND\_PORT}
{IMOND\_PORT}
{IMONDPORT}
{
    TCP/IP-Port, auf dem IMonD auf Verbindungen horcht.
    Der Standard-Wert '5000' sollte nur in Ausnahmef"allen
    ge"andert werden.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{IMOND\_PORT='5000'}
}


\config{IMOND\_PASS}
{IMOND\_PASS}
{IMONDPASS}
{
    Hier kann ein spezielles User-Password f"ur IMonD gesetzt
    werden. Meldet sich ein Client auf Port 5000 an, erwartet
    IMonD (und damit auch seine Clients) die Eingabe dieses
    Passworts, bevor er irgendeinen Befehl korrekt beantwortet.
    Ausnahme: Befehle 'quit', 'help' und 'pass'. Ist
    \texttt{IMOND\_PASS} leer, wird kein Password ben"otigt.

    G"ultige Werte: Passwort

    Standardeinstellung: \texttt{IMOND\_PASS=''}
}


\config{IMOND\_ADMIN\_PASS}
{IMOND\_ADMIN\_PASS}
{IMONDADMINPASS}
{
    Mit Hilfe der Admin-Passwords erh"alt der Client alle Rechte
    und kann so s"amtliche Steuerfunktionen des IMonD-Servers
    nutzen - und zwar unabh"angig von den Variablen \texttt{IMOND\_ENABLE,
    IMOND\_DIAL} usw. L"asst man \texttt{IMOND\_ADMIN\_PASS}
    leer, so reicht die Eingabe des User-Passwords, um s"amtliche Rechte zu
    erhalten!

    G"ultige Werte: Passwort

    Standardeinstellung: \texttt{IMOND\_ADMIN\_PASS=''}
}


\config{IMOND\_LED}
{IMOND\_LED}
{IMONDLED}
{
    Als Wert von \texttt{IMOND\_LED} muss ein COM-Port angegeben
    werden, also 'com1', 'com2', 'com3' oder 'com4'. Ist keine LED
    angeschlossen, sollte die Variable leer gelassen werden.

    G"ultige Werte: com1 ...

    Standardeinstellung: \texttt{IMOND\_LED=''}
}


\config{IMOND\_BEEP}
{IMOND\_BEEP}
{IMONDBEEP}
{
    Mit \texttt{IMOND\_BEEP='yes'} gibt IMonD einen Zweiklang-Ton
    "uber den PC-Lautsprecher aus, wenn der Zustand von Offline nach
    Online wechselt und umgekehrt. Im ersten Fall wird zuerst
    ein tiefer, dann ein hoher Ton ausgegeben. Beim Wechsel in
    den Offline-Status zur"uck wird zuerst der h"ohere, dann der
    tiefere Ton ausgegeben.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{IMOND\_BEEP='no'}
}


\config{IMOND\_LOG}
{IMOND\_LOG}
{IMONDLOG}
{
    Wird \texttt{IMOND\_LOG='yes'} benutzt, werden in der Datei
    /var/log/imond.log die Verbindungen protokolliert.

    G"ultige Werte: yes, no'

    Standardeinstellung: \texttt{IMOND\_LOG='no'}
}


\config{IMOND\_LOGDIR}
{IMOND\_LOGDIR}
{IMONDLOGDIR}
{
    Ist das Protokollieren eingeschaltet, kann "uber
    \texttt{IMOND\_LOGDIR}
    ein alternatives Verzeichnis statt /var/log angegeben werden,

    G"ultige Werte: Pfad zum Logdir

    Standardeinstellung: \texttt{IMOND\_LOGDIR='/var/log'}
}


\config{IMOND\_ENABLE}
{IMOND\_ENABLE}
{IMONDENABLE}
{
    Durch diese Variable werden bestimmte Kommandos, die von
    imonc-Clients zum IMonD-Server gesendet werden, bereits im
    User-Modus freigeschaltet.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{IMOND\_ENABLE='yes'}
}


\config{IMOND\_DIAL}
{IMOND\_DIAL}
{IMONDDIAL}
{
    Durch diese Variable werden bestimmte Kommandos, die von
    imonc-Clients zum IMonD-Server gesendet werden, bereits im
    User-Modus freigeschaltet.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{IMOND\_DIAL='yes'}
}


\config{IMOND\_ROUTE}
{IMOND\_ROUTE}
{IMONDROUTE}
{
    Durch diese Variable werden bestimmte Kommandos, die von
    imonc-Clients zum IMonD-Server gesendet werden, bereits im
    User-Modus freigeschaltet.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{IMOND\_ROUTE='yes'}
}


\config{IMOND\_REBOOT}
{IMOND\_REBOOT}
{IMONDREBOOT}
{
    Durch diese Variable werden bestimmte Kommandos, die von
    imonc-Clients zum IMonD-Server gesendet werden, bereits im
    User-Modus freigeschaltet.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{IMOND\_REBOOT='yes'}
}

\end{description}
