HDD-Check - Festplatte der Dbox2 berprfen
===========================================

Plugin:     Hdd-Check
Version:    0.1
Autor:      DrStoned
Datum:      07.09.2006


Anwendung:
----------

Das Plugin HDD-Check dient dazu, das extfs3-Dateisystem der Dbox-Festplatte
zu berprfen und ntigenfalls zu reparieren. Die Idee dazu kam mir, als es mir 
whrend einer Aufnahme die Festplatte zerschossen hat. Vermutlich kam dieser 
Fehler daher, dass mir die Dbox vorher mehrmals whrend der Aufnahme 
abgestrzt ist. Dabei wurden wahrscheinlich einige Dateien nicht mehr 
geschlossen oder irgendwo auf der Festplatte Datenmll produziert, was 
letztendlich dann das Dateisystem der Festplatte zerschossen hat. 
Um dem vorzubeugen, habe ich dieses Shellskript geschrieben.

Das Skript sollte regelmig ausgefhrt werden, vor allem jedesmal, 
wenn die Dbox whrend einer Aufnahme abgestrzt ist, oder wenn eine Aufnahme 
unvermittelt abbricht. Damit wird einem greren Fehler im Dateisystem der 
Festplatte vorgebeugt.

Vorraussetzung:
---------------

Zuallererst muss natrlich eine Festplatte in die Dbox eingebaut sein.
Fr alle Benutzer, die nicht das JtG-Image verwenden, wie z.B. das DietmarW-Image 
ist ausserdem noch das Messagebox-Plugin 'msgbox' wichtig. Es ist diesem Archiv 
nicht beigefgt, da es im JtG-Image bzw. dem Image von Hallenberg bereits 
eingebaut ist. 
Erhltich ist es bei http://www.jackthegrabber.de/viewtopic.php?t=6036
Die Installation des Messagebox-Plugins ist in der zugehrigen readme.txt 
beschrieben.

Wichtig:
--------

Sehr wichtig ist ausserdem, dass dieses Skript nur fr das extfs3-Dateisystem 
geschrieben wurde. Wenn Ihr es fr das extfs2-Dateisystem verwenden wollt, 
msst Ihr das Skript mit einem UNIX-Editor entsprechend abndern.


Installation:
-------------

Die Dateien werden per FTP in folgende Verzeichnisse kopiert und mit den 
entsprechenden Rechten versehen. Es ist sehr wichtig die Dateien im 
BINR-Modus zu bertragen, sonst luft das Plugin nicht.

Achtung: Bitte beim FTP-Programm 'Filezilla' beachten, dass dieses Programm 
         standardmig, Dateien mit der Endung '.sh', im ASCII-Modus ubertrgt.
         Dann luft das Plugin aber nicht. Also darauf achten, wenn Ihr dieses 
         Programm verwendet, es entsprechend zu konfigurieren. 
         Um zu kontrollieren, ob die Dateien ordnungsgem bertragen wurden,
         einfach nach der bertragung die Dateigren vergleichen.
         

Datei               Speicherort                 Rechte      Gre in Bytes
--------------------------------------------------------------------------

hddcheck.sh          /var/tuxbox/plugins/        755         3001
hddcheck.cfg         /var/tuxbox/plugins/        644          138


Wenn Ihr alle Dateien installiert habt, ist noch folgende Aktion durchzufhren.
Dbox-Taste -> Service -> Plugins neu laden.
Wenn ihr alles richtig gemacht habt, findet Ihr das Skript unter 
Dbox-Taste -> Skripte -> HDD-Check - Festplatte ueberpruefen.


Funktion:
---------

Ruft man das Skript 'HDD-Check - Festplatte ueberpruefen' auf, wird zuerst 
getestet, ob der IDE-Treiber aktiviert ist. Sollte dies nicht der Fall sein,
bricht das Skript mit einer entsprechenden Fehlermeldung ab.
Ist dieser Treiber aktiviert, so kommt man in ein Auswahlmen, in dem erklrt wird,
was bei der Ausfhrung des Skripts zu beachten ist. Hier kann man sich entscheiden, 
ob man das Skript ausfhren mchte oder nicht. Hier die Auswahl zwischen nein/ja 
treffen und mit der OK-Taste besttigen. Nicht die Home-Taste verwenden, sonst 
wird das Skript ausgefhrt, auch wenn man es nicht will. Dies ist eine Eigenheit 
des Messagebox-Plugins und kann nicht so einfach abgefangen werden. 
Bitte die Hinweise im Auswahlmen sorgfltig durchlesen und auch befolgen, ich 
gebe keine Haftung fr einen Datenverlust.

Hat man sich dafr entschieden, das Skript auszufhren, so darf jetzt auf keinen 
Fall mehr die Box ausschalten oder resetten bzw. den Stecker ziehen. 
!!! Sonst droht Datenverlust !!!  
Bitte unbedingt das Skript bis zum Ende laufen lassen. 

Zunchst wird die Festplatte ungemountet. Danach wird getestet, ob das Unmounten 
auch erfolgt ist. Sollte die Festplatte nicht ungemountet werden knnen, 
so wird das Skript mit einer entsprechenden Fehlermeldung abgebrochen. 

Eine Ursache dafr kann sein, dass noch irgendein Programm, das auf der 
Festplatte liegt, noch nicht beendet wurde. Mir ist dies passiert, weil ich das 
WOL-Timer-Plugin auf die Festplatte ausgelagert hatte und dessen 'woltimerd' 
(Daemon) noch lief. Deswegen ist die Unmount-berprfung von mir eingebaut worden.

Danach wird die Festplatte mit dem im Image eingebauten Befehl 'fsck.ext3' 
berprft. Falls Fehler im Dateisystem vorhanden sind, wird versucht das 
Dateisystem zu reparieren. Diese berprfung dauert einige Zeit, bei meiner 
100 GB-Fujitsu 2,5"-Zoll Notebookfestpatte gehen dafr 5 Minuten ins Land. 
Also nicht ungeduldig werden, und das Skript zu Ende laufen lassen.

Ist die berprfung beendet, so wird die Datenpartition der Festplatte wieder 
nach /hdd gemountet. Dann wird noch das Ergebnis der Festplattenberprfung auf 
dem Bildschirm fr 30 Sekunden angezeigt. Wer sich die Daten der berprfung 
genauer ansehen mchte, findet sie in der Datei '/tmp/fsck.log'.

Ich wnsche Euch noch viel Spa mit dem HDD-Check-Plugin. 

Greetz von DrStoned :-) :-) :-)