Installationsanleitung

Transkript

1 Beratung und Support Technische Plattform Support-Netz-Portal paedml stabil und zuverlässig vernetzen Installationsanleitung Backup für Filr Stand paedml Novell Version: Filr 1.0.1

2 Impressum Herausgeber Landesmedienzentrum Baden-Württemberg (LMZ) Support-Netz Rotenbergstraße Stuttgart Autoren der Zentralen Expertengruppe Netze (ZEN), Support-Netz, LMZ Stefan Falk Ulrich Frei Carl Heinz Gutjahr Friedrich Heckmann Hubert Bechthold Uwe Labs Alfred Wackler Endredaktion Dr. Cornelia Glaser Bildnachweis Titelbilder: Thinkstock Weitere Informationen Veröffentlicht: 2014 Landesmedienzentrum Baden-Württemberg

3 Inhaltsverzeichnis Einführung... 4 Voll-Backup der Filr-Inhalte... 4 Vorüberlegungen... 4 Hochladen und Anpassen des Skripts filrbk.sh... 5 Manuelles Backup... 7 Automatisiertes Backup... 8 Rücksicherung eines Backups... 9 Schluss... 10

4 1.Einführung Novell-Filr erfreut sich zurzeit im Rahmen der paedml-novell als weiterer Teil der Schul-Cloud steigender Beliebtheit, da es einen leichten Zugriff auf z.b. das eigene Homeverzeichnis oder weitere freigegebenen Ressourcen in der Schule erlaubt. Zwar speichert man in der Regel keine Dateien auf dem Filr, aber die Verweise auf Dateien im GServer oder die eingelesenen LDAP-Benutzerdaten werden in einer Datenbank auf den Filr gespeichert. Und eventuell lassen Sie persönliche oder öffentliche Bereiche direkt im Filr zu; dann werden im Filerepository Daten liegen. Daher ist es sinnvoll, auch für den Filr eine Datensicherung vorzusehen. Zwei Konzepte sollten hierzu beleuchtet werden: 1. Novell Filr ist eine virtuelle Appliance. Wer diese auf ESXi betreibt, hat zumindest mit ESXi- Essential-Plus oder Software wie Veeam und anderen die Möglichkeit über automatisierte Snapshots in gewissem Rahmen im Ernstfall Rücksicherungen vorzunehmen. 2. Vollständig lassen sich die Filr-Inhalte mit einem MySQL-Dump und der Kopie des vastorage- Verzeichnisses automatisiert sichern. Die zwei Konzepte schließen sich gegenseitig nicht aus und können auch parallel angewendet werden. Die Anwendung der Methode 1 hängt von den technischen Gegebenheiten vor Ort ab und wird in diesem Papier nicht weiter behandelt. Methode 2 kann mit Hilfe eines Skriptes leicht eingesetzt und als Cron-Job automatisiert werden. 2.Voll-Backup der Filr-Inhalte 2.1 Vorüberlegungen Der Filr als Appliance beinhaltet zwei Festplatten, das eigentliche System und die Filr-Inhalte. Im Falle eines Totalausfalls (oder auch eines Updates) wird die Systemplatte ausgetauscht. Die Filr-Inhalte liegen auf der zweiten Platte, die als Verzeichnis vastorage im System eingehängt ist. Es genügt also, das komplette vastorage oder auch nur Teile davon oder nur die eigentliche Datenbank zu sichern. Das Verzeichnis vastorage hat mehrere Unterverzeichnisse: /vastorage conf filr ganglia lost+found mysql search Für eine Sicherung sind davon die wichtigen Teile: conf, filr/filerepository, mysql Obwohl der Suchindex jederzeit wieder neu aufgebaut werden kann, ist es jedoch praktisch, auch noch das Verzeichnis search zu sichern. paedml Novell / Filr Backup / Stand Seite 4

5 Schauen Sie sich einmal die Datenmengen in Ihrem Filr-vastorage-Verzeichnis an. Loggen Sie sich dazu auf dem Filr als root ein und prüfen die Datenmengen mit dem Befehl du: filr:/ # du -h -s /vastorage/ 5.9G /vastorage/ (Dieses Ergebnis entstand übrigens auf einem System, das per LDAP ca. 150 Benutzer hat, die keine persönlichen Bereiche haben und die jeweils auf ihr Homeverzeichnis, auf das Lehrertauschverzeichnis und auf Projektverzeichnisse zugreifen können.) Ist die Gesamtdatenmenge eher klein, so wie im gezeigten Fall, so stellt sich die Frage, ob es nicht sinnvoll ist, einfach das gesamte vastorage-verzeichnis zu sichern. (Das Verzeichnis ganglia enthält nur ca. 224 MB an Daten, also nicht viel.) Selbst wenn pro Woche täglich eine Komplettsicherung durchgeführt wird, ist die Gesamtdatenmenge für eine ganze Woche < 100 GB. Ist die Datenmenge dagegen groß, ist es sinnvoll, doch nur die wichtigen Verzeichnisse zu sichern. Der Nachteil wäre dann nur ein etwas unbequemeres Zurückspielen der Sicherung im Schadensfall (siehe weiter unten). Recht einfach ist es mit Hilfe des Skriptes filrbk.sh die kompletten oder teilweisen Inhalte von Filr zu sichern. Da sich dieses Skript auch per Cron-Job zeitgesteuert starten lässt, kann das Backup automatisiert werden. Die Sicherung beruht auf zwei Schritten, nämlich einem MySQL-Dump und einer per tar archivierten Kopie des Inhalts des Verzeichnisses /vastorage oder eines Teils davon. Das Skript stoppt während der Kopie von /vastorage MySQL und startet es anschließend wieder. Außerdem schreibt das Skript eine LOG-Datei. Die Sicherung kann in ein beliebiges Verzeichnis erfolgen. Am besten ist es, ein USB-Laufwerk oder eine NAS im Verzeichnis /media auf dem Filr einzubinden und das Sicherungsverzeichnis dorthin zu legen. Hier in diesem Dokument liegt das Sicherungsverzeichnis der Einfachheit halber im Verzeichnis /root auf dem Filr, also immerhin auf der ersten Platte im Filr. Die Filr-Inhalte liegen ja auf der 2.Platte im Filr, die als /vastorage eingebunden ist. (Die Datenmenge darf natürlich den freien Platz auf der 1. Platte nicht übersteigen.) Dies sollte für Tests ausreichen. In der Praxis sollte das Backup aber, wie gesagt, außerhalb des Filr liegen. 2.2 Hochladen und Anpassen des Skripts filrbk.sh Öffnen und bearbeiten Sie NICHT das in der gezippten Datei filrbk.zip liegende Skript filrbk.sh, damit nicht versehentlich eine DOS-Formatierung entsteht und auf alle Fälle die UNIX- Formatierung erhalten bleibt! Zum Hochladen und Bearbeiten des Skriptes muss im Filr SSH aktiviert sein. Falls dies nicht der Fall ist, gehen Sie folgendermaßen vor: Melden Sie sich mit einem Browser mit dns>:9443 als vaadmin im Filr an und klicken auf Appliance System Configuration / System Services. paedml Novell / Filr Backup / Stand Seite 5

6 Danach markieren Sie SSH, klicken auf Action und dann auf Start. In der Spalte Status sollte dann Running erscheinen. Wenn dies nicht der Fall sein sollte, müssen Sie den Filr neu starten. Kopieren Sie (z.b. mit WinSCP) die Datei filrbk.zip in das Verzeichnis /root auf dem Filr, entpacken dieses und geben dem Skript nur für den Benutzer root Rechte. Öffnen Sie eine Terminal- Sitzung (z.b. per PuTTY) oder arbeiten Sie an der Server-Konsole (als root angemeldet) und geben Sie ein: cd /root unzip filrbk.zip chmod 700 filrbk.sh Nun müssen einige Anpassungen im Skript mit einem Editor vorgenommen werden. Leider gibt es auf dem Filr nur einen einzigen Editor, und zwar den vi, der nicht jedermanns Sache ist. Ein Ausweg ergibt sich, wenn Sie den Editor von WinSCP verwenden. Klicken Sie mit der rechten Maustaste auf die Datei filrbk.sh und wählen Sie Edit. Mit Strg-S können Sie speichern, wobei Sie noch einmal nach dem root-passwort gefragt werden. Nach einem Einführungstext, den Sie natürlich lesen dürfen, finden Sie den Variablen-Block: # Variablen FILR=/vastorage INCLUDEDIR=* #INCLUDEDIR='conf filr/filerepository mysql search'backupdir=/root/filrbackup/$1 TARFILE=filrbk.tar.gz LOGFILE=/root/filrbackup/filrbk.log MAXLOGFILESIZE=2048 # in Kilobyte MYSQLROOT=root MYSQLROOTPW=12345 paedml Novell / Filr Backup / Stand Seite 6

7 Die Variable FILR enthält das Standard-Filr-Verzeichnis. Hier ist also keine Änderung nötig. Ebenso gilt dies für die Variablen MYSQLROOT und MYSQLROOTPW. Haben Sie jedoch diese Daten mit dem install-programm von Filr verändert, was Sie sicher für das MySQL-Root-Passwort getan haben, so müssen Sie dies natürlich auch hier tun. Geben Sie also bei MYSQLROOT und MYSQLROOTPW Ihren MySQL-Root-User und Ihr MySQL-Root-Passwort ein, die Sie bei der Erstinstallation des Filr eingegeben hatten. In den Vorüberlegungen hatten wir abgewägt, ob einfach das gesamte vastorage-verzeichnis gesichert werden soll, oder nur Teile davon. Je nachdem, muss die Variable INCLUDEDIR angepasst bzw. die korrekte auskommentiert werden: Gesamtes vastorage-verzeichnis: INCLUDEDIR=* Nur wichtige Teile: INCLUDEDIR='conf filr/filerepository mysql search' (Setzen Sie im Skript zum Auskommentieren vor die nicht gewünschte Zeile ein # und nehmen vor der gewünschten Zeile ggf. das # weg.) Möchten Sie ein anderes Backup-Verzeichnis nutzen (z.b. wegen des Einsatzes einer USB-Platte oder einer NAS), so ändern Sie entsprechend die Variable BACKUPDIR. Lassen Sie dabei unbedingt das Anhängsel /$1 stehen (unten dazu mehr). Passend dazu sollten Sie auch die Variable LOGFILE ändern. Für das Sichern auf eine USB-Platte könnte dies beispielhaft so aussehen: BACKUPDIR=/media/usbplatte/filrbackup/$1 LOGFILE=/media/usbplatte/filrbackup/filrbk.log Hinweis: Das Skript macht ein Log-Rotate. Wird die Logdatei größer als in MAXLOGFILESIZE angegeben, wird filrbk.log in filrbk.log.1 umbenannt und eine neue filrbk.log angelegt. Gibt es auch schon filrbk.log.1 wird diese in filrbk.log.2 umbenannt. Es existieren also maximal 3 Logdateien, die nach Bedarf/Größe rotiert werden. Gefällt Ihnen der Archivname nicht, ändern Sie auch noch TARFILE (lassen aber die Endung.tar.gz). 2.3 Manuelles Backup Sie können das Backup von Hand starten, indem Sie das Skript aufrufen: im Verzeichnis /root mit filr:~ #./filrbk.sh sonst /root/filrbk.sh paedml Novell / Filr Backup / Stand Seite 7

8 Schauen Sie sich das Ergebnis an mit filr:~ # ll /root/filrbackup/ total rw-r--r-- 1 root root Jan 20 17:45 all.sql -rw-r--r-- 1 root root 611 Jan 20 17:45 filrbk.log -rw-r--r-- 1 root root Jan 20 17:45 filrbk.tar.gz -rw-r--r-- 1 root root 1227 Jan 20 17:45 information_schema.sql all.sql ist der MySQL-Dump aller Datenbanken, information_schema.sql ein Extra-Dump, der vom all-dump nicht erfasst wird. filrbk.tar.gz ist die komprimierte Kopie oder Teilkopie des Verzeichnisses /vastorage und filrbk.log die Logdatei. Was hat es nun mit dem $1 auf sich? Sie können das Skript auch mit einem Parameter aufrufen, der dann als Unterverzeichnis an das eingestellte Backupverzeichnis angehängt wird, also z.b. /root/filrbk.sh Freitag In diesem Fall geht das Backup nach /root/filrbackup/freitag. Der LOG-File bleibt jedoch in /root/filrbackup, da dieser nicht überschrieben, sondern nur weitergeführt wird. Übrigens müssen Sie die benötigten Verzeichnisse und Unterverzeichnisse nicht von Hand erzeugen, denn sie werden ggf. vom Skript automatisch erzeugt. 2.4 Automatisiertes Backup Schöner geht s natürlich automatisiert. Eine Idee ist es, jeden Tag ein Backup anzulegen. Dazu benutzen wir die $1-Parameter mo,di,..., so für die Wochentage und platzieren das Ganze in die /etc/crontab. Tragen Sie dort mit einem Editor bzw. mit dem WinSCP-Edit ein: # Backup der Filr-Inhalte 30 3 * * 1 root /root/filrbk.sh mo 30 3 * * 2 root /root/filrbk.sh di 30 3 * * 3 root /root/filrbk.sh mi 30 3 * * 4 root /root/filrbk.sh do 30 3 * * 5 root /root/filrbk.sh fr 30 3 * * 6 root /root/filrbk.sh sa 30 3 * * 7 root /root/filrbk.sh so Speichern Sie ab und starten Sie cron neu: /etc/init.d/cron restart Da während eines Teils des Backup-Prozesses MySQL gestoppt ist, ist es wichtig, eine Zeit zu wählen, in der üblicherweise kein Verkehr auf dem Filr zu erwarten ist; hier z.b. um 3:30 Uhr in der Frühe. Auf diese Weise kann man zur Not auf ein Backup bis zu 7 Tage zurückliegend zurückgreifen. Nach 7 Tagen wird überschrieben. Wem das zu viel ist, könnte z.b. nur samstags ein Backup gefahren werden. In diesem Fall wäre der Wochentag-Parameter überflüssig. Ein passender Eintrag in /etc/crontab wäre dann z.b.: # Backup der Filr-Inhalte 30 3 * * 6 root /root/filrbk.sh paedml Novell / Filr Backup / Stand Seite 8

9 2.5 Rücksicherung eines Backups Ist der Notfall eingetreten, so muss ggf. ein Backup zurückgespielt werden. Dies ist naturgemäß immer eine aufregende Sache. Daher sollte man einerseits Ruhe bewahren und andererseits den momentanen Stand des Filr sichern, im virtuellen Fall z.b. mit einem Snapshot, bevor man das Backup einspielt. Ist der Filr selbst beschädigt, muss ein ganz neuer Filr aufgesetzt werden. (Siehe dazu das Dokument paedml-novell-filr-install.pdf des Support-Netzes. Auch sollte dann ggf. ein zuvor vorhandenes Zertifikat wieder installiert werden.) Das oben beschriebene Backup ist mehrteilig. Es besteht zum einen aus dem MySQL-Dump, der wiederum aus den beiden SQL-Dateien all.sql und information_schema.sql besteht, zum anderen aus der komprimierten Kopie des Verzeichnisses /vastorage oder eines Teils davon. Daraus ergeben sich verschiedene Rücksicherungsstrategien: 1. Es gibt die komplette Kopie des Verzeichnisses /vastorage. 2. Es gibt die Teil-Kopie des Verzeichnisses /vastorage, bestehend aus den Unterverzeichnissen conf, filr/filerepository, mysql. 3. Es soll nur der MySQL-Dump zurückgespielt werden. Zu 1.: Dies ist der einfachste und umfassendste Fall. Folgende Schritte sind nötig: a. Wechseln in Ihr(!) Backup-Verzeichnis, also z.b. für Freitag: cd /root/filrbackup/fr b. MySQL stoppen: /etc/init.d/mysql stop c. Inhalt (!) des /vastorage-verzeichnisses löschen: rm R /vastorage/* d. tar-archiv kopieren: cp filrbk.tar.gz /vastorage e. tar-archiv auspacken: cd /vastorage tar xzvf filrbk.tar.gz f. MySQL starten: /etc/init.d/mysql start g. Das tar-archiv kann gelöscht werden: rm /vastorage/filrbk.tar.gz Hinweis: Wenn Sie sich nun über einen Browser erstmalig nach dem Restore wieder am Filr als admin anmelden, kann es zu folgender Fehlermeldung kommen: [Bei dieser Aktion ist ein Fehler aufgetreten: Could not open Hibernate Session for transaction; nested exception is org.hibernate.transactionexception: JDBC begin failed:] Starten Sie dann einfach den Filr im Browser ein zweites Mal. paedml Novell / Filr Backup / Stand Seite 9

10 Zu 2.: a. Wechseln in Ihr(!) Backup-Verzeichnis, also z.b. für Freitag: cd /root/filrbackup/fr b. MySQL stoppen: /etc/init.d/mysql stop c. Inhalt (!) der in der Skript-Variablen INCLUDEDIR angegebenen Unterverzeichnisse des /vastorage-verzeichnisses löschen, also i.d.r.: rm R /vastorage/conf/* rm R /vastorage/filr/filerepository/* rm R /vastorage/mysql/* rm R /vastorage/search/* (Achten Sie peinlich genau darauf, dass diese Verzeichnisse auch zuvor gesichert wurden, so, wie es in der Variablen INCLUDEDIR festgelegt ist!) d. tar-archiv kopieren: cp filrbk.tar.gz /vastorage e. tar-archiv auspacken: cd /vastorage tar xzvf filrbk.tar.gz f. MySQL starten: /etc/init.d/mysql start g. Das tar-archiv kann gelöscht werden: rm /vastorage/filrbk.tar.gz Hinweis: Der Hinweis unter zu 1 gilt auch hier. Zu 3.: 1. Wechseln in Ihr(!) Backup-Verzeichnis, also z.b. für Freitag: cd /root/filrbackup/fr 2. Restaurieren Sie mit den folgenden zwei Kommandos alle gesicherten Datenbanken: mysql -uroot -p12345 < all.sql mysql -uroot -p12345 < information_schema.sql Geben Sie bei p natürlich Ihr MySQL-Root-Passwort ein, das Sie bei der Erstinstallation des Filr eingegeben hatten. Hinweis: Der Hinweis unter zu 1 gilt auch hier. Wir empfehlen die Methode 1. Damit ist die Rücksicherung beendet und Filr ist mit den zurückgespielten Daten wieder einsatzfähig. 3.Schluss Viel Erfolg mit dem Filr wünscht Ihnen Ihre ZEN-Novell paedml Novell / Filr Backup / Stand Seite 10

11 Landesmedienzentrum Baden-Württemberg (LMZ) Support Netz Rotenbergstraße Stuttgart Landesmedienzentrum Baden-Württemberg, 2014