+----------------------------------------------------------------+
|    Anleitung zur Installation von OPT_SARFILE  v2.1.2          |
|                                                                |
| Reiner Schroeppel               mailto: reiner@schroeppel.info |
+----------------------------------------------------------------+
| change on 24.04.2005 by Michael Freundt <mail4mike@freenet.de> |
+----------------------------------------------------------------+


!!   THIS SOFTWARE IS PROVIDED AS IS. NO WARRANTY IS GRANTED    !!
!!     BENUTZUNG DIESER SOFTWARE AUF EIGENE VERANTWORTUNG!      !!


!!  ACHTUNG ich habe das Paket von Reiner Schroeppel genommen   !!
!!  und an Fli4l 2.1.x angepasst + kleine Erweiterungen.        !!


###############
# 1. FUNKTION #
###############
Das OPT-Paket SARFILE sichert beliebige Dateien vor einem Reboot und
stellt diese dann nach einem Warmstart wieder her. Im Gegensatz zu
bereits existierenden OPT's (OPT_TCFROMTO, Vers. 0.3 und
OPT_PERSISTANT Vers. 0.12a) werden bei diesem OPT auch Pfade wieder
hergestellt! D.h., wurde auf dem FLI4L-Router ein Verzeichnis
angelegt und dort Dateien hinein kopiert, sind diese nach einem
Reboot verloren. OPT_SARFILE sichert die Dateien im Verzeichnis und
stellt das Verzeichnis beim Booten wieder her und kopiert die beim
Herunterfahren gesicherten Daten wieder in das Verzeichnis.

Ab der Version 2.0.0. knnen jetzt auch Wildcards (*, ?) verwendet werden
und somit natuerlich auch komplette Verzeichnisse auf einmal gesichert und
wieder hergestellt werden.  Siehe dazu Beispiele unter "Parameter".

!!! VORSICHT BEI DER VERWENDUNG VON WILDCARDS !!!
Werden verschiedene Quellverzeichnisse in ein Sicherungsverzeichnis kopiert,
geschieht KEINE Kontrolle, ob eine Datei schon existiert und ueberschrieben
wird, d.h. existiert eine Datei mit gleichem Namen in zwei verschiedenen
Quellverzeichnissen, so geht eine davon verloren (ausser man sichert in 
zwei unterschiedliche Sicherungsverzeichnisse)!!

Angenommen man hat aus dem Verzeichnis /test1/ die Dateien e1e, z1z, d1d
mittels Wildcards (SARFILE_FILE_1='/test1/?1?') in das Sicherungsverzeichnis
/sicher/ gesichert und aus dem Verzeichnis /test2/ die Dateien g1t, w1t, j1k
mittels Wildcards (SARFILE_FILE_2='/test2/?1?') in das gleiche 
Sicherungsverzeichnis /sicher/ gesichert, dann werden beim Wiederherstellen
alle Dateien sowohl nach /test1/, wie auch nach /test2/ zurck gesichert!!


####################
# 2. Voraussetzung #
####################
- Festplatte o.., da durch das Sichern eine Diskette sich schnell
  fllt.


###################
# 3. Installation #
###################
Wie blich die tar.gz-Datei mit Pfad extrahieren.


################
# 4. Parameter #
################
SARFILE_N
     Die Anzahl der Dateien die gesichert/wiederhergetellt sollen.
     Z.B.: SARFILE_N='3'
     (3 Dateien werden gesichert/wiedergergestellt)

SARFILE_FILE_X
     Kompletter Dateiname mit Pfad der Datei die vor dem Reboot
     gesichert werden soll.
     Z.B.: SARFILE_FILE_1='/var/log/messages'
     (Sichern der SYSLOG-Datei)
     Soll ein komplettes Verzeichnis gesichert werden, dann z.B. folgendes
     angeben: 
     SARFILE_FILE_1='/var/log/*'
     (Sichert das komplette LOG-Verzeichnis)
     Sollen nur bestimmte Dateien gesichert werden, z.B. alle Dateien die
     den String "11" enthalten im Verzeichnis /usr/data/test, dann sollte
     folgendes eingetragen werden:
     SARFILE_FILE_1='/usr/data/test/*11*' 

SARFILE_SAVETO_X
     In dieses Verzeichnis wird die bei SARFILE_FILE_X angegebene
     Datei gesichert.
     Z.B.: SARFILE_SAVETO='/data/permanent'
     (Die Datei wird ins Verzeichnis /data/permanent gesichert.

SARFILE_WAIT_BOOT
     Gibt die Pause in Sekunden an die bis zum fortsetzen des Reboot
     gewartet wird. Damit die Dateien auch bei langsamen Floppys
     noch gespeichert werden knnen.
     z.B.: SARFILE_WAIT_BOOT='20'
     (20 sec warten) 

#################
# 5. Change-Log #
#################

2.1.2
- Ergnzung des cp Befehl mit Option "-a" damit das Datum der Original Datei mit
  kopiert wird.
- Einfgen einer pause Option beim reboot/halt damit auch mein langsames Floppy
  die Files speichert (!?!?).
- Anpassung der Variablen Namen zur besseren bersicht in der config.

2.1.1
- OPT Paket von Reiner Schroeppel genommen und an Fli4l version 2.1.x angepasst.
  (opt/sarfile.txt gendert, sarfile in rc100.sarfile umbennant)

2.0.1
- Fehler bei der Installation behoben, rc.sarfile wurde nicht gefunden,
  da inzwischen umbennant nach rc200.sarfile

2.0.0
- Jetzt mit Wildcard-Untersttzung, es koennen somit auch komplette
  Verzeichnisse gesichert und wieder hergestellt werden.

1.0.0
- Erste Ur-Version


#############
# 6. LIZENZ #
#############
Copyright (C) 2002 Reiner Schroeppel <reiner@schroeppel.info>

Dieses Programm ist freie Software. Sie koennen es unter den
Bedingungen der GNU General Public License, wie von der Free 
Software Foundation herausgegeben, weitergeben und/oder 
modifizieren, entweder unter Version 2 der Lizenz oder (wenn Sie es 
wuenschen) jeder spaeteren Version.

Die Veroeffentlichung dieses Programms erfolgt in der Hoffnung, dass 
es Ihnen von Nutzen sein wird, aber OHNE JEDE GEWAEHRLEISTUNG - 
sogar ohne die implizite Gewaehrleistung der MARKTREIFE oder der 
EIGNUNG FUER EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License.

Free Software Foundation Inc.
59 Temple Place
Suite 330
Boston MA 02111-1307 USA.

Der Text der GNU General Public License ist auch im Internet unter
http://www.gnu.org/licenses/gpl.txt veroeffentlicht. Eine inoffizielle deutsche
Uebersetzung findet sich unter http://agnes.dida.physik.uni-essen.de/~gnu-pascal/gpl-ger.html
Diese Uebersetzung soll jedoch nur zu einem besseren Verstaendnis
der GPL verhelfen, rechtsverbindlich ist die englischsprachige Version.


Bei Fragen, Vorschlaegen und Kritik bitte ein Mail an: 
reiner@schroeppel.info

