+----------------------------------------------------------------+
|    Anleitung zur Installation von OPT_SARFILE  v2.0.1          |
|                                                                |
| Reiner Schroeppel               mailto: reiner@schroeppel.info |
+----------------------------------------------------------------+


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



###############
# 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.


#################
# 5. Change-Log #
#################
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

