%
% nut.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Nut %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Das Nut-Paket}


\section{Die Einleitung}

    NUT ist ein Client/Server-Framework zur Ansteuerung und Verwaltung
    einer USV (unterbrechungsfreie Stromversorgung, englisch: UPS).
    Unterst"utzt werden "uber 100 verschiedene Hersteller und Modelle.
    Einige Programmkomponenten arbeiten als Systemdienst (Daemon), d.h.
    diese werden automatisch beim Einschalten des Rechners gestartet.

\section{Die Funktionen}

    Das Nut-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
        \item Network UPS Tools (NUT) - Programmdateien f"ur die USV-Ansteuerung.\\
            (\url{http://www.networkupstools.org/})
    \end{itemize}

\section{Die Voraussetzungen}

    Um die Funktion `Show UPS key data as chart' auf einem nut-Server "uber
    das Men"u aufrufen zu k"onnen wird ein installiertes gnuplot-Paket ben"otigt.


\section{Die Installation}

    Das Nut-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 Advanced configuration file handling: Konfigurationen verwalten
        \item Show status: Status des NUT-Servers anzeigen
        \item Stop service: NUT-Server stoppen
        \item Start service: NUT-Server starten
        \item View log file: Logmeldungen anzeigen
        \item Show UPS status: USV-Status anzeigen
        \item Show UPS key data as chart: USV-Daten als Grafik ausgeben
        \item Simulate power failure: Einen Stromausfall simulieren
        \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/nut.


\section{Die Parameter}

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

\subsection{Die Starteinstellungen}

\begin{description}
    \config{START\_NUT}{START\_NUT}{STARTNUT}
        Um das Nut-Paket zu aktivieren muss dieser Parameter auf den Wert
        `yes' gesetzt werden, um es zu deaktivieren muss der Wert auf `no'
        gesetzt werde.

        G"ultige Werte: yes, no

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

    \config{NUT\_CLIENT\_MODE}{NUT\_CLIENT\_MODE}{NUTCLIENTMODE}
        Um den Klientenmodus zu aktivieren muss dieser Parameter auf den Wert
        `yes' gesetzt werden, um ihn zu deaktivieren muss der Wert auf `no'
        gesetzt werde.

        \hinweis{NUT\_CLIENT\_MODE und NUT\_SERVER\_MODE d"urfen nicht
            gleichzeitig aktiviert werden!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_CLIENT\_MODE='no'}

    \config{NUT\_SERVER\_MODE}{NUT\_SERVER\_MODE}{NUTSERVERMODE}
        Um den Servermodus zu aktivieren muss dieser Parameter auf den Wert
        `yes' gesetzt werden, um ihn zu deaktivieren muss der Wert auf `no'
        gesetzt werde.

        \hinweis{NUT\_CLIENT\_MODE und NUT\_SERVER\_MODE d"urfen nicht
            gleichzeitig aktiviert werden!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_MODE='no'}
\end{description}

%
% CLIENT SETTINGS
%
\subsection{Die Klienteneinstellungen}

\begin{description}
    \config{NUT\_CLIENT\_UPSMON\_SYNO\_CLIENT}{NUT\_CLIENT\_UPSMON\_SYNO\_CLIENT}{NUTCLIENTUPSMONSYNOCLIENT}
        Falls dieses Paket als Klient eines Synology NAS arbeiten soll, muss
        dieser Parameter auf den Wert `yes' gesetzt werden, falls nicht, so
        k"onnen individuelle Anmeldedaten f"ur den Monitorzugriff "uber die
        Parameter  \jump{NUTCLIENTUPSMONUPSNAME}{NUT\_CLIENT\_UPSMON\_UPSNAME},
        \jump{NUTCLIENTUPSMONUSER}{NUT\_CLIENT\_UPSMON\_USER} und
        \jump{NUTCLIENTUPSMONPASS}{NUT\_CLIENT\_UPSMON\_PASS} definiert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_CLIENT\_UPSMON\_SYNO\_CLIENT='no'}

    \config{NUT\_CLIENT\_UPSMON\_QNAP\_CLIENT}{NUT\_CLIENT\_UPSMON\_QNAP\_CLIENT}{NUTCLIENTUPSMONQNAPCLIENT}
        Falls dieses Paket als Klient eines QNAP NAS arbeiten soll, muss
        dieser Parameter auf den Wert `yes' gesetzt werden, falls nicht, so
        k"onnen individuelle Anmeldedaten f"ur den Monitorzugriff "uber die
        Parameter \jump{NUTCLIENTUPSMONUPSNAME}{NUT\_CLIENT\_UPSMON\_UPSNAME},
        \jump{NUTCLIENTUPSMONUSER}{NUT\_CLIENT\_UPSMON\_USER} und
        \jump{NUTCLIENTUPSMONPASS}{NUT\_CLIENT\_UPSMON\_PASS} definiert werden.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_CLIENT\_UPSMON\_QNAP\_CLIENT='no'}

    \config{NUT\_CLIENT\_UPSMON\_UPSNAME}{NUT\_CLIENT\_UPSMON\_UPSNAME}{NUTCLIENTUPSMONUPSNAME}
        "Uber diesen Parameter wird der Name der USV angegeben, zu welcher
        sich dieser USV-Klient verbinden soll.

        G"ultige Werte: beliebiger Name in Kleinbuchstaben

        Beispiel: \texttt{NUT\_CLIENT\_UPSMON\_UPSNAME='ups'}

    \config{NUT\_CLIENT\_UPSMON\_USER}{NUT\_CLIENT\_UPSMON\_USER}{NUTCLIENTUPSMONUSER}
        "Uber diesen Parameter wird der Benutzername festgelegt, welcher zur
        Authentifizierung gegen"uber einem NUT-Server verwendet werden soll.

        G"ultige Werte: Benutzername

        Standardeinstellung: \texttt{NUT\_CLIENT\_UPSMON\_USER='monuser'}

    \config{NUT\_CLIENT\_UPSMON\_PASS}{NUT\_CLIENT\_UPSMON\_PASS}{NUTCLIENTUPSMONPASS}
        "Uber diesen Parameter wird das Kennwort festgelegt, welches zur
        Authentifizierung gegen"uber einem NUT-Server verwendet werden soll.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{NUT\_CLIENT\_UPSMON\_USER='pass'}

    \config{NUT\_CLIENT\_UPSMON\_SERVER\_IP}{NUT\_CLIENT\_UPSMON\_SERVER\_IP}{NUTCLIENTUPSMONSERVERIP}
        "Uber diesen Parameter wird die IP-Adresse des NUT-Servers festgelegt,
        als dessen Klient dieses NUT-Dienst arbeiten soll.

        G"ultige Werte: IP-Adresse

        Standardeinstellung: \texttt{NUT\_CLIENT\_UPSMON\_SERVER\_IP=$''$}
\end{description}

%
% SERVER SETTINGS
%
\subsection{Die Server-Einstellungen}

\begin{description}
    \config{NUT\_SERVER\_UPSMON\_ADMIN\_USER}{NUT\_SERVER\_UPSMON\_ADMIN\_USER}{NUTSERVERUPSMONADMINUSER}
        "Uber diesen Parameter wird der Name des Administrators festgelegt,
        welcher erweitere USV-Abfragen durchf"uhren oder USV-Einstellungen
        ver"andern darf.

        G"ultige Werte: Benutzername

        Standardeinstellung: \texttt{NUT\_SERVER\_UPSMON\_ADMIN\_USER='admin'}

    \config{NUT\_SERVER\_UPSMON\_ADMIN\_PASS}{NUT\_SERVER\_UPSMON\_ADMIN\_PASS}{NUTSERVERUPSMONADMINPASS}
        "Uber diesen Parameter wird das Kennwort des Administrators festgelegt,
        welcher erweitere USV-Abfragen durchf"uhren oder USV-Einstellungen
        ver"andern darf.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{NUT\_SERVER\_UPSMON\_ADMIN\_PASS='geheim'}

    \config{NUT\_SERVER\_UPSMON\_ADMIN\_EMAIL}{NUT\_SERVER\_UPSMON\_ADMIN\_EMAIL}{NUTSERVERUPSMONADMINEMAIL}
        Optionaler Parameter: "Uber diesen Parameter kann eine vom Standard
        abweichende E-Mail-Adresse f"ur den Versand von Status- und Alarmmeldungen
        des USV-Monitors festgelegt werden. Wird dieser Parameter nicht gesetzt,
        so werden alle Meldungen an die E-Mail-Adresse des root-Anwenders geschickt.

        G"ultige Werte: E-Mail-Adresse

        Beispiel: \texttt{NUT\_SERVER\_UPSMON\_ADMIN\_EMAIL='tommy@domain.de'}

    \config{NUT\_SERVER\_N}{NUT\_SERVER\_N}{NUTSERVERN}
        "Uber diesen Parameter wird die Anzahl der einzurichtenden NUT-Serverdienste
        angegeben.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{NUT\_SERVER\_N='1'}

    \config{NUT\_SERVER\_x\_ACTIVE}{NUT\_SERVER\_x\_ACTIVE}{NUTSERVERxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der Datensatz
        aktiviert, der Wert `no' deaktiviert ihn.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_ACTIVE='no'}

    \config{NUT\_SERVER\_x\_COMMENT}{NUT\_SERVER\_x\_COMMENT}{NUTSERVERxCOMMENT}
        Dies ist ein Kommentarfeld, welches einzig der Beschreibung des
        NUT-Serverdienstes dient.

        G"ultige Werte: beliebiger Text

        Beispiel: \texttt{NUT\_SERVER\_1\_COMMENT='Meine erste USV'}

    \config{NUT\_SERVER\_x\_UPSNAME}{NUT\_SERVER\_x\_UPSNAME}{NUTSERVERxUPSNAME}
        Optionaler Parameter: "Uber diesen Parameter kann auf Wunsch ein
        individueller USV-Name festgelegt werden. Falls dieser Parameter
        nicht gesetzt wird, wird der USV-Name automatisch gesetzt. Die
        erste USV erh"alt in diesem Fall den Namen `ups', die zweite USV
        erh"alt den Namen `ups-2', die dritte den Namen `ups-3' usw..

        G"ultige Werte: beliebiger Name in Kleinbuchstaben

        Beispiel: \texttt{NUT\_SERVER\_1\_UPSNAME='ups'}

    \config{NUT\_SERVER\_x\_DRIVER}{NUT\_SERVER\_x\_DRIVER}{NUTSERVERxDRIVER}
        "Uber diesen Parameter wird der zu verwendende USV-Treiber eingestellt,
        welcher zur Kommunikation mit der installierten USV verwendet werden
        soll.

        \hinweis{Alle verf"ugbaren Treiber befinden sich im Verzeichnis
            /usr/lib/ups/driver}

        G"ultige Werte: g"ultiger Treiber

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_DRIVER='apcsmart'}

    \config{NUT\_SERVER\_x\_PORT}{NUT\_SERVER\_x\_PORT}{NUTSERVERxPORT}
        "Uber diesen Parameter legt man die zu verwendende serielle oder
        USB-Schnittstelle fest, "uber welche der konfigurierte USV-Treiber
        mit der USV kommunizieren kann. Die USB-Treiber `usbhid-ups',
        `bcmxcp\_usb', `tripplite\_usb', `blazer\_usb' und `richcomm\_usb'
        ignorieren "ublicherweise den angegebenen Port, sodass hier als
        Wert `\textbf{auto}' eingetragen werden sollte.

        G"ultige Werte: serielle oder USB-Schnittstelle oder `auto'

        Beispiel: \texttt{NUT\_SERVER\_1\_PORT='/dev/ttyS0'}

    \config{NUT\_SERVER\_x\_CABLE}{NUT\_SERVER\_x\_CABLE}{NUTSERVERxCABLE}
        Optionaler Parameter: "Uber diesen kann man bei Bedarf, und wenn
        dies vom verwendeten USV-Treiber unterst"utzt wird, den verwendeten
        Kabeltyp angeben, welcher zur Verbindung mit der USV verwendet
        wurde.

        G"ultige Werte: g"ultiger Kabeltyp

        Beispiel: \texttt{NUT\_SERVER\_x\_CABLE='940\_0024C'}

    \config{NUT\_SERVER\_x\_DELAY}{NUT\_SERVER\_x\_DELAY}{NUTSERVERxDELAY}
        Optionaler Parameter: "Uber diesen Parameter kann festgelegt
        werden, wie lange beim Treiberstart gewartet werden soll bis
        ein Treiber geladen wurde. Durch Setzen des Parameter kann
        verhindert werden, dass ein Server beim Systemstart "uberm"asig
        lange h"angen bleibt, weil ein z.B. ein Treiber oder eine USV
        defekt sind.

        \hinweis{Standardm"a"sig betr"agt die Wartezeit 45s}

        G"ultige Werte: Zahl

        Beispiel: \texttt{NUT\_SERVER\_1\_DELAY='45'}

    \config{NUT\_SERVER\_x\_ORDER}{NUT\_SERVER\_x\_ORDER}{NUTSERVERxORDER}
        Optionaler Parameter: Wenn mehrere USV an einem Server angeschlossen
        sind, kann "uber diesen Parameter festgelegt werden, in welcher
        Reihenfolge diese abgeschaltet werden sollen. Dabei werden erst
        alle USV mit der Kennzeichnung `0', dann `1', `2' usw. abgeschaltet.
        Wird `exclude' gew"ahlt, so wird diese USV von der Abschaltsequenz
        ausgeschlossen.

        \hinweis{Standardm"a"sig wird der Wert `0' gesetzt}

        G"ultige Werte: 'exclude' oder Zahl

        Beispiel: \texttt{NUT\_SERVER\_1\_ORDER='0'}

    \config{NUT\_SERVER\_x\_SERIAL}{NUT\_SERVER\_x\_SERIAL}{NUTSERVERxSERIAL}
        Optionaler Parameter: Wenn mehrere USV "uber z.B. USB-Anschl"usse
        an einem Server angeschlossen wurden, kann "uber diesen Parameter
        die Seriennummer der USV festgelegt werden um eine eindeutige Zuordnung
        zur Konfiguration sicher zu stellen.

        G"ultige Werte: Seriennummer einer USV

        Beispiel: \texttt{NUT\_SERVER\_1\_SERIAL='3B0816X76344'}

    \config{NUT\_SERVER\_x\_UPSMON\_SYNO\_CLIENT}{NUT\_SERVER\_x\_UPSMON\_SYNO\_CLIENT}{NUTSERVERxUPSMONSYNOCLIENT}
        "Uber diesen Parameter wird festgelegt, ob Synology NAS Klienten sich
        mit diesem NUT-Server verbinden und dessen Statusmeldungen auslesen
        d"urfen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_SYNO\_CLIENT='no'}

    \config{NUT\_SERVER\_x\_UPSMON\_SYNO\_CLIENT\_IP}{NUT\_SERVER\_x\_UPSMON\_SYNO\_CLIENT\_IP}{NUTSERVERxUPSMONSYNOCLIENTIP}
        "Uber diesen Parameter wird die IP-Adresse bzw. werden die IP-Adressen
        der Synology NAS-Klienten festgelegt, welche berechtigt werden sollen
        sich mit diesem NUT-Server zu verbinden.

        G"ultige Werte: IP-Adresse

        Beispiel: \texttt{NUT\_SERVER\_1\_UPSMON\_SYNO\_CLIENT\_IP='192.168.6.10'}

    \config{NUT\_SERVER\_x\_UPSMON\_QNAP\_CLIENT}{NUT\_SERVER\_x\_UPSMON\_QNAP\_CLIENT}{NUTSERVERxUPSMONQNAPCLIENT}
        "Uber diesen Parameter wird festgelegt, ob QNAP NAS Klienten sich
        mit diesem NUT-Server verbinden und dessen Statusmeldungen auslesen
        d"urfen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_QNAP\_CLIENT='no'}

    \config{NUT\_SERVER\_x\_UPSMON\_QNAP\_CLIENT\_IP}{NUT\_SERVER\_x\_UPSMON\_QNAP\_CLIENT\_IP}{NUTSERVERxUPSMONQNAPCLIENTIP}
        "Uber diesen Parameter wird die IP-Adresse bzw. werden die IP-Adressen
        der QNAP NAS-Klienten festgelegt, welche berechtigt werden sollen
        sich mit diesem NUT-Server zu verbinden.

        G"ultige Werte: IP-Adresse

        Beispiel: \texttt{NUT\_SERVER\_1\_UPSMON\_QNAP\_CLIENT\_IP='192.168.6.10'}

    \config{NUT\_SERVER\_x\_UPSMON\_CLIENT\_N}{NUT\_SERVER\_x\_UPSMON\_CLIENT\_N}{NUTSERVERxUPSMONCLIENTN}
        "Uber diesen Parameter wird die Anzahl der einzurichtenden Klienten
        angegeben, welche berechtigt werden sollen sich mit diesem NUT-Server
        zu verbinden und dessen Statusmeldungen auslesen d"urfen.


        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_CLIENT\_N='0'}

    \config{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_ACTIVE}{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_ACTIVE}{NUTSERVERxUPSMONCLIENTyACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der Datensatz
        aktiviert, der Wert `no' deaktiviert ihn.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_CLIENT\_1\_ACTIVE='no'}

    \config{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_USER}{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_USER}{NUTSERVERxUPSMONCLIENTyUSER}
        "Uber diesen Parameter wird der Benutzername festgelegt, welcher zur
        Authentifizierung des Klienten gegen"uber dem NUT-Server verwendet
        werden soll.

        G"ultige Werte: Benutzername

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_CLIENT\_1\_USER='monuser'}

    \config{NUT\_SERVER\_x\_UPSMON\_CLIENT\_x\_PASS}{NUT\_SERVER\_x\_UPSMON\_CLIENT\_x\_PASS}{NUTSERVERxUPSMONCLIENTyPASS}
        "Uber diesen Parameter wird das Kennwort festgelegt, welcher zur
        Authentifizierung des Klienten gegen"uber dem NUT-Server verwendet
        werden soll.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{NUT\_SERVER\_1\_UPSMON\_CLIENT\_1\_PASS='pass'}

    \config{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_IP}{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_IP}{NUTSERVERxUPSMONCLIENTyIP}
        "Uber diesen Parameter wird die IP-Adresse des NUT-Klienten festgelegt,
        welche berechtigt werden sollen sich mit diesem NUT-Server zu verbinden.

        G"ultige Werte: IP-Adresse

        Beispiel: \texttt{NUT\_SERVER\_x\_UPSMON\_CLIENT\_y\_IP='192.168.6.10'}

    \config{NUT\_SERVER\_LISTEN\_ADDRESSES}{NUT\_SERVER\_LISTEN\_ADDRESSES}{NUTSERVERLISTENADDRESSES}
        Optionaler Parameter: "Uber diesen Parameter wird die IP-Adresse
        bzw. werden die IP-Adressen festgelegt, auf welchen der NUT-Server
        Verbindungsanfragen entgegen nehmen soll.

        \hinweis{Standardm"a"sig wird die IP-Adresse 127.0.0.1 verwendet}

        G"ultige Werte: IP-Adresse bzw. Adressen

        Beispiel: \texttt{NUT\_SERVER\_LISTEN\_ADDRESSES='192.168.6.10'}
\end{description}

%
% WEB GUI SETTINGS
%
\subsection{Die Web-GUI-Einstellungen}
\begin{description}
    \config{NUT\_SERVER\_WEBGUI}{NUT\_SERVER\_WEBGUI}{NUTSERVERWEBGUI}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird die
        NUT-Weboberfl"ache aktiviert, der Wert `no' deaktiviert sie.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{NUT\_SERVER\_WEBGUI='no'}

    \config{NUT\_SERVER\_WEBGUI\_DOCUMENT\_ROOT}{NUT\_SERVER\_WEBGUI\_DOCUMENT\_ROOT}{NUTSERVERWEBGUIDOCUMENTROOT}
        Optionaler Parameter: "Uber diesen Parameter kann ein vom Standard
        abweichendes Dokumentenstammverzeichnis festgelegt werden. Wird
        dieser Parameter nicht gesetzt, so wird der folgende Verzeichnispfad
        verwendet: /var/www/htdocs/nut.

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{NUT\_SERVER\_WEBGUI\_DOCUMENT\_ROOT='/var/www/htdocs/nut'}
\end{description}

\section{Verschiedenes}

\subsection{Getestet USV-Anbindungen}
\begin{description}
    % APC Smart-UPS 1000 - Juergen Edner, juergen@eisfair.org
    % APC Smart-UPS 1500 - Thomas Ostermaier, thomas.ostermaier@orth-ostermaier.de
    \index{APC Smart-UPS 1500}
    \config{APC{\textregistered} Smart-UPS 1000/1500}{APC Smart-UPS 1000}{APCSmart-UPS1000}
        Diese USV wird "uber ein serielles Kabel angesprochen, dessen
        Typ bei der Konfiguration angegeben werden muss:

        Beispiel:

        \texttt{NUT\_SERVER\_1\_DRIVER='apcsmart'\\
                NUT\_SERVER\_1\_PORT='/dev/ttyS0'\\
                NUT\_SERVER\_1\_CABLE='940\_0024C'}

    % APS Back-UPS BR800 - Ralf Diehl, ralf.r.diehl@web.de
    \config{APC{\textregistered} Back-UPS BR800}{APC Back-UPS BR800}{APCBack-UPSBR800}
        Diese USV wird "uber ein USB-Kabel angesprochen. Falls mehr als eine USV "uber
        die USB-Schnittstelle angeschlossen wird, muss "uber den optionalen Parameter
        NUT\_SERVER\_1\_SERIAL zus"atzlich noch die Seriennummer der USV mitgegeben
        werden.

        Beispiel:

        \texttt{NUT\_SERVER\_1\_DRIVER='usbhid-ups'\\
                NUT\_SERVER\_1\_PORT='/dev/ttyUSB0'\\
                NUT\_SERVER\_1\_CABLE=''\\
                NUT\_SERVER\_1\_SERIAL='valid-serial-number'}

    % PowerWalk VI 1000 LCD - Andreas Lehmler, wuddy@nexgo.de
    \config{{BlueWalker\textregistered} {PowerWalker\textregistered} VI 1000 LCD}{Bluewalker PowerWalker VI 1000 LCD}{BlueWalkerPowerWalkerVI1000LCD}
        Diese USV wird "uber ein USB-Kabel angesprochen.

        Beispiel:

        \texttt{NUT\_SERVER\_1\_DRIVER='nutdrv\_qx'\\
                NUT\_SERVER\_1\_PORT='auto'\\
                NUT\_SERVER\_1\_CABLE=''}
\end{description}
