Backupfile Manual V 0.1 dated 15. november 2008

Licence: GNU GPL2
History: V0.1; 15.11.2008
Contact: pm to newbiefan at www.wl500g.info
         hirau at gmx.at

Generelle Beschreibung:
Der File backupfile muss auf dem Asusrouter im Ordner /opt/etc/backup stehen. Das Script autobackup sollte im selben Ordner stehen.
Backupfile enthlt die Beschreibung welche Shares im Netzwerk gemounted werden, sowie wohin gemounted und gesichert wird.

Beschreibung vom File:
Der File backupfile kann eine beliebige Anzahl von Eintrgen haben, jede Zeile beschreibt welches Share wohin gemounted wird 
und welche Ordner wohin gesichert werden. Die erste Zeile wird generell nicht beachtet, selbst wenn das Comment-Zeichen # 
entfernt wird. Die erste Zeile dient lediglich dem Anwender zur Orientierung.
Jede Zeile muss vollstndig eingetragen werden. Jeder Eintrag wird vom nchsten Eintrag mit einem Doppelpunkt (:) voneinander 
getrennt. Es drfen keine Leerzeichen vorkommen.

Beschreibung einer Zeile: (vollstndiger Eintrag)

IPADDRESS:
Die IP Adresse vom externen Share, egal in welcher Richtung die Sicherung erfolgen soll.
Zur Zeit knnen nur fixe IP Adressen eingetragen werden.
Beispiel: 192.168.2.233

Freigabename:
Der Freigabename muss mit einem / beginnen. Es muss der exakte Namen der Freigabe eingegeben werden, beachten sie auch Gross 
und Kleinschreibung.
Beispiel: /PUBLIC

ASUS-MOUNTPOINT:
Dieser Eintrag muss den vollstndigen Pfad enthalten, an dem das Share gemounted wird. Achten sie unbedingt darauf, dass der
Pfad nur auf ein beschreibbares Verzeichnis zeigt. Weiters kann genau ein Zusatz wie extern1 dem Pfad /tmp/mnt hinzu
gefgt werden. Sollte dieses Verzeichnis nicht existieren, wird es temporr angelegt (bis zum nachsten Reboot).

BACKUP-FROM-DIR:
Hier mssen sie wieder den vollstndigen Pfad vom Mountpoint eingeben und zustzlich den Ordner, welcher gesichert werden
soll. Z.Bspl. es befindet sich unterhalb der Freigabe /PUBLIC ein Ordner mit dem Namen /EBAY, die Freigabe /PUBLIC wurde auf 
den Mountpoint /tmp/mnt/extern gelegt - folglich muss der richtige Eintrag lauten: /tmp/mnt/extern1/EBAY
Der Grund dieser etwas umstndlichen Eingabe liegt einfach in der Mglichkeit, jeden Ordner vom Asus oder vom Share irgendwo
hin sichern zu knnen. Das erlaubt sogar, alle Systemordner usw. vom Asus auf den Share zu sichern.
Es wird dadurch sogar mglich, bei Einhaltung der richtigen Reihenfolge von einem externen Share auf ein weiteres externes 
Share zu sichern. Das erspart unheimlich viel Sicherungsarbeit, wenn man z.Bspl. von einem Windows-PC auf eine NAS sichern
will. Falls sie vorhaben, von einem externen Share auf ein externes Share zu sichern, lesen sie unbedingt vorher "Tips" am
Ende dieses Manuals.

BACKUP-TO:
Hier gilt die gleiche Bedingung wie bei BACKUP-FROM-DIR, lediglich der Name der Sicherung muss hinzu gefgt werden.
z.Bspl. /tmp/mnt/disc0_3/ebay legt ein Sicherungsfile oder Ordner (abhngig vom Filesystem) an, in dem sich die 
gesicherten Dateien befinden.

FILESYSTEM:
Hier gibt es einen wesentlichen Unterschied. Zur Sicherung wird im normalen Fall das Programm rsync verwendet.
Falls es jedoch zu Schwierigkeiten mit einem anderen Filesystem kommt, kann ganz einfach mit dem Eintrag FAT ein
anderes Sicherungsverfahren heran gezogen werden. Wird FAT als Eintrag verwendet, wird ein tar.gz File mit dem Namen
BACKUP-TO (/tmp/mnt/disc0_3/ebay) erzeugt.
Es ist bekannt, dass alle FAT Filesysteme keine oder nur sehr eingeschrnkte Zugriffsrechte haben. Dadurch kann es 
zu Schwierigkeiten kommen - falls dies bei Ihnen der Fall ist, whlen sie als Eintrag: FAT
Ansonsten nehmen sie einfach das verwendete Filesystem als Eintrag - z.Bspl. EXT3, EXT2, NTFS usw.
Wichtig ist, dass der Eintrag FAT gro geschrieben wird.

USER:
Hier kann ein username fr sptere Erweiterung angegeben werden.
(Wird spter fr smbmount verwendet)

PASSWORD:
Hier kann ein password fr sptere Erweiterung angegeben werden.
(Wird spter fr smbmount verwendet)

backupfile-Beispiel: 
#IPADDRESS:Freigabename:ASUS-MOUNTPOINT:BACKUP-FROM-DIR:BACKUP-TO:FILESYSTEM:USER:PASSWORD
192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/tmp/mnt/extern1/EBAY:/tmp/mnt/disc0_3/ebay:FAT
192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/tmp/mnt/extern1/Sabine:/tmp/mnt/disc0_3/sabine:FAT
192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/opt/var/test:/tmp/mnt/extern1/testsicherung:EXT3


TIPS: Von extern auf extern sichern
    Im Backupfile knnen sie nicht zwei externe IP Adressen und Freigaben eingeben.
    Trotzdem geht es mit einem kleinen Trick:
    Geben sie zuerst ein Laufwerk an und sichern wie gewohnt eben einen kleinen Ordner/File.
    Als zweiten Eintrag geben sie sofort das zweite Laufwerk ein und mounten es ebenfalls.
    Sehen sie sich nachstehenden backupfile an:
	0.)	#IPADDRESS:Freigabename:ASUS-MOUNTPOINT:BACKUP-FROM-DIR:BACKUP-TO:FILESYSTEM:USER:PASSWORD	
	1.)	192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/tmp/mnt/extern1/EBAY:/tmp/mnt/disc0_3/ebay:FAT
	2.)	192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/tmp/mnt/extern1/Sabine:/tmp/mnt/disc0_3/sabine:FAT
	3.)	192.168.178.150:/PUBLIC:/tmp/mnt/extern1:/opt/var/test:/tmp/mnt/extern1/testsicherung:FAT
	4.)	192.168.178.151:/alle:/tmp/mnt/extern2:/tmp/mnt/extern2/AON:/tmp/mnt/extern1/aonsicherung:FAT
	5.)	192.168.178.151:/alle:/tmp/mnt/extern1:/opt/var/test:/tmp/mnt/disc0_3:EXT3
	6.)	192.168.178.151:/alle:/tmp/mnt/extern1:/tmn/mnt/disc0_3/test:/tmp/mnt/extern2/testsicherung:FAT
    Die Zeile 0 muss bleiben, sie wird nie ausgewertet, egal was da stehen wrde.
    Zeile 1.) Mountet die Freigabe 192.168.178.150/PUBLIC nach /tmp/mnt/extern1 und kopiert mit Tar den Ordner 
	EBAY samt Unterordner auf den File /tmp/mnt/disc0_3/ebay.tar.gz 
    Zeile 4.) Mountet die Freigabe 192.168.178.151/alle nach /tmp/mnt/extern2 und kopiert mit Tar den Ordner 
	AON samt Unterordner auf die Freigabe 192.168.178.150/PUBLIC in den File /tmp/mnt/extern1/aonsicherung.tar.gz
    Zeile 5.) Legt eine 1:1 Sicherung vom Asus-Ordner /opt/var/test auf das Laufwerk /tmp/mnt/disc0_3
    Zeile 6.) Aus der 1:1 Sicherung welche mit 5.) erstellt wurde, wird eine Tar Sicherung auf Laufwerk /tmp/mnt/extern2
       mit dem Namen testsicherung.tar.gz gelegt.

TIPS: Die letzte Zeile im File backupfile wird nicht verarbeitet
    ffnen sie den File mit einem beliebigen Linux-Editor und fgen am Ende der letzten Zeile einen Zeilenvorschub ein.
    Dazu brauchen sie nur die ENTER Taste drcken und den File wieder sichern.


HINWEISE:
Bei ausreichendem Interesse werden die Optionen fr tar und rsync im Beschreibungsfile integriert.
Falls bereits jetzt Bedarf besteht, muss das Script selbst angepasst werden.
Bitte bercksichtigen sie auch die GNU GPL2. Falls sie nicht ber die GNU GPL Bescheid wissen, bitte
danach googeln - es gibt unzhlige Seiten in allen mglichen Sprachen.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA  	