Dokumentation zum smartmon-Paket fuer EIS/FAIR Das smartmon-Paket enthaelt im Wesentlichen die smartmontools (http://smartmontools.sourceforge.net). Damit ist es moeglich, 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 Moeglichkeit, alle SMART-Attribute in einem einstellbaren Intervall abzufragen, zu protokollieren und deren zeitlichen Verlauf grafisch darzustellen. Dies ermoeglicht es bei regelmaessiger Kontrolle der Grafiken, Tendenzen bezueglich der Entwicklung einzelner Plattenparameter zu erkennen - (hoffentlich) noch bevor ein Problem auftritt. Voraussetzungen Dieses Paket benoetigt mindestens base Update 1.0.8 sowie eine beliebige Version eines Mail-Paketes, um eventuelle Nachrichten an den Administrator schicken zu koennen. Installation Das Smartmon-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: Verwalten von Konfigurationen 4: Show SMART status: Zeigt an, ob der smart-Daemon laeuft 5: Start SMART services: Startet die Smartmon-Services 6: Stop SMART services: Beendet die Smartmon-Services 7: Show SMART drive status: Zeigt den SMART-Status der ueberwachten Festplatten an 8: Update drives database: Laedt die aktuelle Platten Datenbank herunter; ist das gnupg2-Paket installiert, wird die Datenbank verifiziert 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/smartmon. START_SMARTMON Aktiviert die Smartmon-Services. Gueltige Werte: yes, no Standard-Einstellung: START_SMARTMON='yes' SMARTMON_DEVICE_N Anzahl der Festplatten, die smartd ueberwachen soll. Gueltige Werte: Zahl Standard-Einstellung: SMARTMON_DEVICE_N='0' SMARTMON_DEVICE_N_ACTIVE Soll die Festplatte N ueberwacht werden? Mit diesem Parameter lassen sich Festplatten voruebergehend von der Ueberwachung ausnehmen, ohne deren Konfiguration zu loeschen. Gueltige Werte: yes, no Standard-Einstellung: SMARTMON_DEVICE_N_ACTIVE='yes' SMARTMON_DEVICE_N_TYPE Legt fest, welchen Typs die Festplatte N ist. Dabei gibt es folgende Moeglichkeiten: auto Automatische Erkennung ata SATA/ATA Festplatten scsi SCSI Festplatten; Plotting wird nicht unterstuetzt nvme NVM Express Festplatten sat ATA Festplatten mit SCSI-ATA Uebersetzung usbcypress ATA Festplatten hinter einer Cypress USB zu PATA Bruecke usbjmicron SATA Festplatten hinter einer JMicron USB zu PATA/SATA Bruecke usbprolific SATA Festplatten hinter einer Profilic USB zu SATA Bruecke usbsunplus SATA Festplatten hinter einer SunplusIT USB zu SATA Bruecke sntjmicron NVMe Festplatten hinter einer JMicron USB zu NVMe Bruecke sntrealtek NVMe Festplatten hinter einer Realtek USB zu NVMe Bruecke marvell SATA Festplatten hinter einem Marvell Chipsatz-Controller (deprecated) 3ware ATA Festplatten verbunden mit einem 3ware RAID-Controller cciss SCSI/SAS Festplatten verbunden mit einem cciss RAID-Controller (Compaq Smart Array); Plotting wird nicht unterstuetzt Gueltige Werte: siehe vorstehende Aufstellung oder freie Eingabe (siehe smartctl Manpage) Standard-Einstellung: SMARTMON_DEVICE_N_TYPE='ata' Eine Angabe der Zahl der angeschlossenen Festplatten ist nicht laenger noetig. SMARTMON_DEVICE_N_NAME Hier wird der Device-Name der zu ueberwachenden Platte angegeben, z.B. /dev/hda. Gueltige Werte: gueltiges Device Standard-Einstellung: SMARTMON_DEVICE_N='/dev/hda' SMARTMON_DEVICE_N_ARGS Hier koennen Sie zusaetzliche Optionen fuer spezielle Festplatten angeben. Diese entnehmen Sie bitte der Dokumentation der smartmontools. siehe: http://smartmontools.sourceforge.net/man/smartd.8.html Gueltige Werte: beliebig Standard-Einstellung: SMARTMON_DEVICE_N_ARGS='' SMARTMON_DEVICE_N_OVERRIDE_DEFAULT Sollten Sie die vom smartmon-Paket benutzten Parameter vollstaendig durch Ihre eigenen ersetzen wollen, tragen Sie diese in den Parameter SMARTMON_DEVICE_N_ARGS ein und setzen SMARTMON_DEVICE_N_OVERRIDE_DEFAULT auf 'yes'. Die Defaultwerte sind: -o on -d removable -n sleep -H -I 194:-t -f -l error -l selftest -s (S/../.././02|L/../../6/03) Gueltige Werte: yes, no Standard-Einstellung: SMARTMON_DEVICE_N_OVERRIDE_DEFAULT='no' SMARTMON_DEVICE_N_WARN_N _ZUSAETZLICH!_ zu bereits ueber den smart-daemon verschickten Emails bei Veraenderungen koennen Sie sich mit Hilfe der folgenden Parameter bei Ueber- oder Unterschreitung eines Schwellwertes per E-Mail benachrichtigen lassen. SMARTMON_DEVICE_N_WARN_N legt fest, wieviele Parameter Sie fuer die aktuelle Festplatte ueberwachen wollen. Dies kann z.B. hilfreich sein, um die Temperatur einzelner Platten zu ueberwachen und eine Warnung zu bekommen, wenn bspw. ein Luefter ausgefallen ist und so die Festplattentemperatur ansteigt, OHNE dass dies in einem Masse geschieht, was zu einer Meldung durch den smart-daemon fuehren wuerde. Das Intervall fuer diese Ueberpruefung ist identisch mit dem Intervall fuer die Plotting-Funktion, da sie durch dasselbe Script erledigt wird. Eine Verwendung dieses Parameters ist also an ein aktiviertes Plotting gekoppelt! Gueltige Werte: Zahl Standard-Einstellung: SMARTMON_DEVICE_N_WARN_N='0' SMARTMON_DEVICE_N_WARN_N_ATTRIBUTE Legt den Namen des zu ueberwachenden SMART-Attributes fest. Hier muss der korrekte Name des Attributes stehen, so wie ihn bspw. 'smartctl -A /dev/hda' in der zweiten Spalte ausgibt. Gueltige Werte: Nicht leer Standard-Einstellung: SMARTMON_DEVICE_N_WARN_N_ATTRIBUTE='Temperature_Celsius' SMARTMON_DEVICE_N_WARN_N_KIND Legt fest, ob der RAW- oder SMART-Wert ueberwacht werden soll. Bei der Temperatur erscheint es sinnvoll, den RAW-Wert zu ueberwachen, bei anderen Attrubuten kann es sinnvoll sein, die SMART-Werte zu ueberwachen. Gueltige Werte: 'raw' oder 'smart' Standard-Einstellung: SMARTMON_DEVICE_N_WARN_N_KIND='raw' SMARTMON_DEVICE_N_WARN_N_RELATION Hiermit wird festgelegt, ob eine Warnung bei Ueber- oder Unterschreiten des Schwellwertes erfolgen soll. Gueltige Werte: 'over' oder 'under' Standard-Einstellung: SMARTMON_DEVICE_N_WARN_N_RELATION='over' SMARTMON_DEVICE_N_WARN_N_THRESHOLD Hier wird nun der eigentliche Schwellwert eingestellt. Sobald dieser Schwellwert ueber- bzw. unterschritten wird, schickt das smartmon-Skript eine Mail an den im Paramter SMARTMON_FAILURE_MAIL_TO angegebenen Empfaenger. Gueltige Werte: Zahl Standard-Einstellung: SMARTMON_DEVICE_N_WARN_N_THRESHOLD='30' SMARTMON_DEVICE_N_PLOT Das smartmon-Paket ist in der Lage, *fuer ATA-Festplatten* S.M.A.R.T.-Werte in Log-Dateien (unter /var/smartmon/log) abzulegen und die zeitliche Entwicklung der S.M.A.R.T.-Werte grafisch aufzubereiten. Dies erfolgt ueber das Programm gnuplot und kann der Erkennung von Tendenzen hinsichtlich der Platten-"gesundheit" dienen. Die Grafiken werden zusammen mit einer Webseite unter /var/smartmon/plot abgelegt. Sie koennen bei installiertem Webserver ueber http://server-ip/smartmon angesehen werden. Mit diesem Parameter koennen Sie festlegen, ob die betreffende Festplatte in der grafischen Auswertung erscheinen soll. Beachten Sie dazu auch den Parameter SMARTMON_PLOT_CRON_SCHEDULE. ----------------------------------------------- FUER SCSI-FESTPLATTEN IST KEIN PLOTTING MOEGLICH! ----------------------------------------------- Gueltige Werte: yes, no Standard-Einstellung: 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 aelter 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 repaesentiert. Ausserdem 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. SMARTMON_STARTUP_TESTMAIL Soll eine Test-E-Mail beim Start des smartd verschickt werden? Gueltige Werte: yes, no Standard-Einstellung: SMARTMON_STARTUP_TESTMAIL='yes' SMARTMON_FAILURE_MAIL_TO Hier kann der Empfaenger der E-mail-Warnungen angegeben werden. Gueltige Werte: E-mail-Adresse Standard-Einstellung: SMARTMON_FAILURE_MAIL_TO='root@localhost' SMARTMON_PLOT Hier koennen Sie das Logging und das Plotting insgesamt aktivieren bzw. deaktivieren. Gueltige Werte: yes, no Standard-Einstellung: SMARTMON_PLOT='yes' SMARTMON_PLOT_SHOW_SN= Wenn Sie die Seriennumer der jeweiligen Platte auf dem Plot nicht sehen wollen, setzen sie diesen Parameter auf 'no' Gueltige Werte: yes, no Standard-Einstellung: SMARTMON_PLOT_SHOW_SN='yes' SMARTMON_PLOT_CRON_SCHEDULE Hiermit legen Sie in Cron-Syntax fest, in welchem Intervall smartmon die Festplatten/Controller (die sie mittels SMARTMON_DEVICE_N_PLOT='yes' bestimmt haben) abfragt, um Daten fuer die grafische Darstellung zu sammeln sowie eventuelle Warnungen per E-Mail zu verschicken, die Sie ueber SMARTMON_DEVICE_N_WARN_N konfiguriert haben. Gueltige Werte: Crontab-Eintrag Standard-Einstellung: SMARTMON_PLOT_CRON_SCHEDULE='05 */1 * * *'