<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das Smartmon-Paket}

\section{Allgemeines}

   Das Smartmon-Paket enth{\"a}lt im Wesentlichen die smartmontools

   \url{http://smartmontools.sourceforge.net}.

   Damit ist es m{\"o}glich, bei S.M.A.R.T.-kompatiblen Festplatten
   diverse (teilweise von Hersteller zu Hersteller stark variierende)
   Parameter zum Zustand der Festplatten abzufragen. Desweiteren
   bietet dieses Paket die M{\"o}glichkeit bei P/S-ATA-Festplatten
   alle SMART-Attribute in einem einstellbaren Intervall abzufragen, 
   zu protokollieren und deren zeitlichen Verlauf grafisch darzustellen. 
   Dies erm{\"o}glicht es bei regelm{\"a}{\ss}iger Kontrolle der Grafiken, Tendenzen
   bez{\"u}glich der Entwicklung einzelner Plattenparameter zu erkennen --
   (hoffentlich) noch bevor ein Problem auftritt.

   \textit{Eine grafische Darstellung der S.M.A.R.T.-Attribute bei SCSI-Festplatten 
   ist nicht m{\"o}glich\,!}

\section{Voraussetzungen}

   Dieses Paket ben{\"o}tigt mindestens base Update 1.0.8 sowie eine
   beliebige Version eines Mail-Paketes, um eventuelle Nachrichten
   an den Administrator schicken zu k{\"o}nnen.

\section{Installation}

   Das Smartmon-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{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: Verwalten von Konfigurationen
    \item Show SMART status: Zeigt an, ob der smart-Daemon l{\"a}uft
    \item Start SMART services: Startet die Smartmon-Services
    \item Stop SMART services: Beendet die Smartmon-Services
    \item Show SMART drive status: Zeigt den SMART-Status der {\"u}berwachten Festplatten an
    \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/smartmon+.

\begin{description}
    \config{START\_SMARTMON}{START\_SMARTMON}{STARTSMARTMON}
        Aktiviert die Smartmon-Services.

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

        Standardeinstellung: \verb+START_SMARTMON='yes'+

    \config{SMARTMON\_DEVICE\_N}{SMARTMON\_DEVICE\_N}{SMARTMONDEVICEN}
        Anzahl der Festplatten, die smartd {\"u}berwachen soll.

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+SMARTMON_DEVICE_N='0'+

    \config{SMARTMON\_DEVICE\_N\_ACTIVE}{SMARTMON\_DEVICE\_N\_ACTIVE}{SMARTMONDEVICENACTIVE}
        Soll die Festplatte N {\"u}berwacht werden\,? Mit diesem
        Parameter lassen sich Festplatten vor{\"u}bergehend von
        der {\"U}berwachung ausnehmen, ohne deren Konfiguration
        zu l{\"o}schen.

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

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_ACTIVE='yes'+

    \config{SMARTMON\_DEVICE\_N\_TYPE}{SMARTMON\_DEVICE\_N\_TYPE}{SMARTMONDEVICENTYPE}
       Legt fest, welchen Typs die Festplatte \verb+N+ ist.
       Dabei gibt folgende M{\"o}glichkeiten:

        \begin{tabular}{ll}
        \verb+ata/sat+ &amp; P/S-ATA-Festplatte\\
        \verb+scsi+    &amp; SCSI-Festplatte (\textit{Kein Plotting\,!})\\
        \verb+marvell+ &amp; P/S-ATA-Festplatte, {\"u}ber einen Marvell-Controller angeschlossen\\
        \verb+3ware+   &amp; P/S-ATA-Festplatte in einem 3ware-RAID (AMCC)\\
        \verb+cciss+   &amp; SCSI-Festplatte in einem Compaq Smart Array (\textit{Kein Plotting\,!})\\
        \end{tabular}

       G{\"u}ltige Werte: ata, sat, scsi, marvell, 3ware, cciss

       Standardeinstellung: \verb+SMARTMON_DEVICE_N_TYPE='ata'+

       Eine Angabe der Zahl der angeschlossenen Festplatten ist nicht l{\"a}nger n{\"o}tig.

    \config{SMARTMON\_DEVICE\_N\_NAME}{SMARTMON\_DEVICE\_N\_NAME}{SMARTMONDEVICENNAME}
       Hier wird der Device-Name der zu {\"u}berwachenden
       Platte angegeben, z.B. \verb+/dev/hda+.

       G{\"u}ltige Werte: g{\"u}ltiges device

       Standardeinstellung: \verb+SMARTMON_DEVICE_N='/dev/hda'+

    \config{SMARTMON\_DEVICE\_N\_ARGS}{SMARTMON\_DEVICE\_N\_ARGS}{SMARTMONDEVICENARGS}
       Hier k{\"o}nnen Sie zus{\"a}tzliche Optionen f{\"u}r spezielle
       Festplatten angeben. Diese entnehmen Sie bitte der
       Dokumentation der smartmontools.

       Siehe \url{http://smartmontools.sourceforge.net/man/smartd.8.html}

       G{\"u}ltige Werte: beliebig

       Standardeinstellung: \verb+SMARTMON_DEVICE_N_ARGS=''+

    \config{SMARTMON\_DEVICE\_N\_OVERRIDE\_DEFAULT}{SMARTMON\_DEVICE\_N\_OVERRIDE\_DEFAULT}{SMARTMONDEVICENOVERRIDEDEFAULT}
       Sollten Sie die vom smartmon-Paket benutzten
       Parameter vollst{\"a}ndig durch Ihre eigenen ersetzen
       wollen, tragen Sie diese in den Parameter
       \verb+SMARTMON_DEVICE_N_ARGS+ ein und setzen
       \verb+SMARTMON_DEVICE_N_OVERRIDE_DEFAULT+ auf 'yes'.

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

       Standardeinstellung: \verb+SMARTMON_DEVICE_N_OVERRIDE_DEFAULT='no'+

    \config{SMARTMON\_DEVICE\_N\_WARN\_N}{SMARTMON\_DEVICE\_N\_WARN\_N}{SMARTMONDEVICENWARNN}
        \emph{Zus{\"a}tzlich} zu bereits {\"u}ber den smart-daemon
        verschickten E-Mails bei Ver{\"a}nderungen k{\"o}nnen
        Sie sich mit Hilfe der folgenden Parameter bei
        {\"U}ber- oder Unterschreitung eines Schwellwertes
        per E-Mail benachrichtigen lassen. \verb+SMARTMON_DEVICE_N_WARN_N+
        legt fest, wieviele Parameter Sie f{\"u}r die aktuelle Festplatte
        {\"u}berwachen wollen. Dies kann z.B. hilfreich sein, um die
        Temperatur einzelner Platten zu {\"u}berwachen und eine
        Warnung zu bekommen, wenn bspw. ein L{\"u}fter ausgefallen
        ist und so die Festplattentemperatur ansteigt, \emph{ohne}
        dass dies in einem Ma{\ss}e geschieht, was zu einer Meldung
        durch den smart-daemon f{\"u}hren w{\"u}rde. Das Intervall
        f{\"u}r diese {\"U}berpr{\"u}fung ist identisch mit dem Intervall
        f{\"u}r die Plotting-Funktion, da sie durch dasselbe
        Script erledigt wird. Eine Verwendung dieses Parameters
        ist also an ein aktiviertes Plotting gekoppelt\,!

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_WARN_N='0'+

    \config{SMARTMON\_DEVICE\_N\_WARN\_N\_ATTRIBUTE}{SMARTMON\_DEVICE\_N\_WARN\_N\_ATTRIBUTE}{SMARTMONDEVICENWARNNATTRIBUTE}
        Legt den Namen des zu {\"u}berwachenden SMART-Attributes
        fest. Hier muss der korrekte Name des Attributes stehen,
        so wie ihn bspw. \verb+smartctl -A /dev/hda+ in der zweiten
        Spalte ausgibt.

        G{\"u}ltige Werte: Nicht leer

        Standardeinstellung:

        \verb+SMARTMON_DEVICE_N_WARN_N_ATTRIBUTE='Temperature_Celsius'+

    \config{SMARTMON\_DEVICE\_N\_WARN\_N\_KIND}{SMARTMON\_DEVICE\_N\_WARN\_N\_KIND}{SMARTMONDEVICENWARNNKIND}
        Legt fest, ob der RAW- oder SMART-Wert {\"u}berwacht werden soll.
        Bei der Temperatur erscheint es sinnvoll, den RAW-Wert zu
        {\"u}berwachen, bei anderen Attrubuten kann es sinnvoll sein, die
        SMART-Werte zu {\"u}berwachen.

        G{\"u}ltige Werte: 'raw' oder 'smart'

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_WARN_N_KIND='raw'+

    \config{SMARTMON\_DEVICE\_N\_WARN\_N\_RELATION}{SMARTMON\_DEVICE\_N\_WARN\_N\_RELATION}{SMARTMONDEVICENWARNNRELATION}
        Hiermit wird festgelegt, ob eine Warnung bei {\"U}ber- oder
        Unterschreiten des Schwellwertes erfolgen soll.

        G{\"u}ltige Werte: 'over' oder 'under'

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_WARN_N_RELATION='over'+

    \config{SMARTMON\_DEVICE\_N\_WARN\_N\_THRESHOLD}{SMARTMON\_DEVICE\_N\_WARN\_N\_THRESHOLD}{SMARTMONDEVICENWARNNTHRESHOLD}
        Hier wird nun der eigentliche Schwellwert eingestellt.
        Sobald dieser Schwellwert {\"u}ber- bzw. unterschritten wird,
        schickt das smartmon-Skript eine Mail an den im Parameter
        \verb+SMARTMON_FAILURE_MAIL_TO+ angegebenen Empf{\"a}nger.

        G{\"u}ltige Werte: Zahl

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_WARN_N_THRESHOLD='30'+

    \config{SMARTMON\_DEVICE\_N\_PLOT}{SMARTMON\_DEVICE\_N\_PLOT}{SMARTMONDEVICENPLOT}
        Das smartmon-Paket ist in der Lage, \textit{f{\"u}r ATA-Festplatten} S.M.A.R.T.-Werte in
        Log"=Dateien abzulegen und die zeitliche Entwicklung der S.M.A.R.T.-Werte
        grafisch aufzubereiten. Dies erfolgt {\"u}ber das
        Programm gnuplot und kann der Erkennung von
        Tendenzen hinsichtlich der Platten-"`gesundheit"'
        dienen. Die Grafiken werden zusammen mit einer
        Webseite unter dem Verzeichnis \verb+/var/smartmon/plot+ abgelegt.
        Sie k{\"o}nnen bei installiertem Webserver {\"u}ber

               \verb+http://&lt;server-ip&gt;/smartmon+

        angesehen werden.
        Mit diesem Parameter k{\"o}nnen Sie
        festlegen, ob die betreffende Festplatte in der
        grafischen Auswertung erscheinen soll. Beachten
        Sie dazu auch den Parameter \verb+SMARTMON_PLOT_CRON_SCHEDULE+.

	\textit{F{\"u}r SCSI-Festplatten ist kein Plotting m{\"o}glich\,!}

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

        Standardeinstellung: \verb+SMARTMON_DEVICE_N_PLOT='yes'+

        Zur Interpretation der Grafiken sei folgendes gesagt:
        Die Firmware der Festplatte rechnet die "`echten"'
        RAW-Werte in interne Werte um (VALUE). Je {\"a}lter
        die Platte wird oder je umfangreicher die
        Funktionsfehler, desto kleiner (!) werden die
        internen Werte. Zu jedem VALUE gibt es einen
        WORST-Wert, der den bislang schlimmsten
        erreichten (bereits umgerechneten) Wert
        rep{\"a}sentiert. Au{\ss}erdem gibt es noch einen
        Schwellwert (THRESHOLD), der die "`Grenze zum
        echten Problem"' darstellt. Sollte also in einer
        "`SMART"'-Grafik eine Tendenz "`nach unten"' zu sehen sein,
        sollte man die Platte genauer untersuchen.

    \config{SMARTMON\_STARTUP\_TESTMAIL}{SMARTMON\_STARTUP\_TESTMAIL}{SMARTMONSTARTUPTESTMAIL}
        Soll eine Test-E-Mail beim Start des smartd verschickt werden?

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

        Standardeinstellung: \verb+SMARTMON_STARTUP_TESTMAIL='yes'+

    \config{SMARTMON\_FAILURE\_MAIL\_TO}{SMARTMON\_FAILURE\_MAIL\_TO}{SMARTMONFAILUREMAILTO}
        Hier kann der Empf{\"a}nger der E-mail-Warnungen angegeben werden.

        G{\"u}ltige Werte: E-mail-Adresse

        Standardeinstellung: \verb+SMARTMON_FAILURE_MAIL_TO='root@localhost'+


    \config{SMARTMON\_PLOT}{SMARTMON\_PLOT}{SMARTMONPLOT}
        Hier k{\"o}nnen Sie das Logging und das Plotting
        insgesamt aktivieren bzw. deaktivieren.

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

        Standardeinstellung: \verb+SMARTMON_PLOT='yes'+


    \config{SMARTMON\_PLOT\_SHOW\_SN}{SMARTMON\_PLOT\_SHOW\_SN}{SMARTMONPLOTSHOWSN}
        Wenn Sie die Seriennumer der jeweiligen Platte
        auf dem Plot nicht sehen wollen, setzen sie
        diesen Parameter auf 'no'

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

        Standardeinstellung: \verb+SMARTMON_PLOT_SHOW_SN='yes'+

    \config{SMARTMON\_PLOT\_CRON\_SCHEDULE}{SMARTMON\_PLOT\_CRON\_SCHEDULE}{SMARTMONPLOTCRONSCHEDULE}
        Hiermit legen Sie in Cron-Syntax fest, in welchem
        Intervall smartmon die Festplatten/Controller (die
        sie mittels \verb+SMARTMON_DEVICE_N_PLOT='yes'+ bestimmt
        haben) abfragt, um Daten f{\"u}r die grafische
        Darstellung zu sammeln sowie eventuelle Warnungen
        per E-Mail zu verschicken, die Sie {\"u}ber
        \verb+SMARTMON_DEVICE_N_WARN_N+ konfiguriert haben.

        G{\"u}ltige Werte: Crontab-Eintrag

        Standardeinstellung: \verb+SMARTMON_PLOT_CRON_SCHEDULE='05 */1 * * *'+
\end{description}
</pre></body></html>