Backup: Unterschied zwischen den Versionen

backup
Zweck / Funktion
	Datensicherung der FHEM-Installation
Allgemein
Typ	Befehl
Details
Dokumentation	EN / DE
Support (Forum)	Sonstiges
Modulname	98_backup.pm
Ersteller	rudolfkoenig (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 16. April 2020, 20:02 Uhr

Die Datensicherung kann je nach verwendeter Server Hardware recht lange dauern. Wird mit global attribute backupdir das lokale Verzeichnis auf ein anderes Laufwerk umgelenkt kann es bei Schwierigkeiten mit diesem Laufwerk (Netzwerk) zu extremen Blockaden des gesamten Systems kommen.

Für Datensicherungszwecke ist in FHEM der Befehl backup integriert.

Im Auslieferungszustand von FHEM werden die erstellten Backups im Ordner ./fhem/backup abgelegt. Die Datensicherung umfasst das komplette FHEM-Verzeichnis. Damit sind alle angepassten und selbst erstellten Dateien und Icons enthalten. Das Backup wird als .tar.gz Datei abgelegt und trägt dabei im Namen das Datum und die Uhrzeit, an dem das Backup ausgeführt wurde.

Der backup Befehl blockiert seit Dezember 2017 nicht mehr und wird unabhängig vom Aufruf im Hintergrund ausgeführt.

Weitere Details zu dem Befehl backup können der commandref/backup entnommen werden.

Backup manuell ausführen (Eingabefeld)

Um ein Backup zu erstellen genügt es, in der FHEM Benutzeroberfläche im Befehls-Eingabefeld den Befehl backup zu schreiben und mit Enter auszuführen.

Danach findet sich eine Backupdatei in dem oben genannten Verzeichnis. In der FHEM Logdatei sollte ein Eintrag

backup done: FHEM-<Datum>_<Uhrzeit>.tar.gz (<Größe> Bytes)

zu finden sein.

Backup manuell ausführen (Weboberfläche)

Der Backup-Befehl kann auf verschiedene Arten in die Weboberfläche als manuell ausführbare Aktion eingebunden werden. Beispielsweise kann der Backup-Befehl in das linke Auswahlmenü von FHEM aufgenommen werden. Hierzu in das Attribut menuEntries der gewünschten FHEMWEB-Instanz folgendes aufnehmen:

attr WEB menuEntries Backup,/fhem?cmd=backup

Nachfolgend wird ein anderer Ansatz mit erweiterter Funktionalität verfolgt. Ein dummy-Device wird im Raum Server angelegt und mit dem webCmd "Ausführen" versehen. Ein Klick auf den Link "Ausführen" des dummy-Devices erzeugt einen Event, der per notify das Backup startet. Dazu sind folgende Definitionen in der Konfiguration einzurichten:

define SYS_Backup dummy
attr SYS_Backup alias FHEM Backup ausführen
attr SYS_Backup room Server
attr SYS_Backup webCmd Ausführen
define SYS_BackupRun notify SYS_Backup:* backup
attr SYS_BackupRun room Server

Alternativ kann man das notify noch so erweitern bzw. abändern, dass im state des dummy-Devices angezeigt wird, welche Backups bereits ausgeführt wurden. Zur Änderung des notify ruft man die Objektdetails des notify-Devices auf, klickt auf das DEF und kopiert den nachfolgenden Code als vollständigen Ersatz des alten Codes in das Editorfenster. Anschließend auf modify SYS_BackupRun klicken.

Code für den DEF-Bereich des notify SYS_BackupRun (im Code das Backup-Verzeichnis ./backup gegebenenfalls noch an eigene Wünsche anpassen):

SYS_Backup:* {
fhem("backup");
opendir DIR, "./backup" or die $!;
my @mybackups =();
while(my $file = readdir DIR){ 
  next if($file eq "." || $file eq "..");
  push(@mybackups,$file);
}
closedir DIR;
@mybackups = join("
", sort(@mybackups) );
fhem("set SYS_Backup @mybackups");
}

Eine ähnliche Lösung mit Auslagerung des Codes in 99_myUtils: Beitrag

Backup automatisch ausführen

Die regelmäßige automatische Erstellung einer Datensicherung unter Nutzung des oben gezeigten Codes (dummy, notiy) lässt sich mit folgendem at in der Konfiguration erreichen:

define NTFY_BackupRun at *23:59:00 set SYS_Backup Ausführen
attr NTFY_BackupRun room Server

Alternativ kann ohne Verwendung des oben gezeigten Codes zur automatischen Sicherung ein at definiert werden, das beispielsweise täglich lediglich backup startet:

define AT_Backup at *23:59:00 backup

Backup vor Update

Ist in der Konfiguration der Eintrag

attr global backup_before_update 1

enthalten, wird vor der Durchführung eines Update erst eine Datensicherung in das festgelegte Backup Verzeichnis durchgeführt.

@@ Zeile 1: / Zeile 1: @@
-Seit dem 01.06.2012 ist der Befehl ''backup''in FHEM integriert. Gerade wenn man die ersten Gehversuche mit FHEM macht, ist es manchmal von Vorteil, auf ein
+{{SEITENTITEL:backup}}
-Backup seiner Konfigurations-Dateien zurückgreifen zu können.
+{{Infobox Modul
+|ModPurpose=Datensicherung der FHEM-Installation
+|ModType=cmd
+|ModCmdRef=backup
+|ModForumArea=Sonstiges
+|ModTechName=98_backup.pm
+|ModOwner=rudolfkoenig ([http://forum.fhem.de/index.php?action=profile;u=8 Forum] / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
+}}
+{{Randnotiz|RNTyp=Warn|RNText=Die Datensicherung kann je nach verwendeter Server Hardware recht lange dauern. Wird mit global attribute backupdir das lokale Verzeichnis auf ein anderes Laufwerk umgelenkt kann es bei Schwierigkeiten mit diesem Laufwerk (Netzwerk) zu extremen Blockaden des gesamten Systems kommen.}}
+Für Datensicherungszwecke ist in FHEM der Befehl '''backup''' integriert.
-Im Auslieferungszustand von fhem werden die erstellten Backups im Ordner
+Im Auslieferungszustand von FHEM werden die erstellten Backups im Ordner <code>./fhem/backup</code> abgelegt. Die Datensicherung umfasst das komplette FHEM-Verzeichnis. Damit sind alle angepassten und selbst erstellten Dateien und Icons enthalten. Das Backup wird als .tar.gz Datei abgelegt und trägt dabei im Namen das Datum und die Uhrzeit, an dem das Backup ausgeführt wurde.
- <nowiki>/var/opt/fhem/Backup</nowiki>
+Der backup Befehl blockiert seit [https://forum.fhem.de/index.php/topic,80237.msg723427.html#msg723427 Dezember 2017] nicht mehr und wird unabhängig vom Aufruf im Hintergrund ausgeführt.
-abgelegt. Ob man das Backup nun an dieser Stelle liegen lässt oder die Datei auf einen anderen Datenträger auslagert ist jedem selbst überlassen.
-Das Backup umfasst das komplette fhem-Verzeichnis. Damit sind alle angepassten und selbst erstellten
+Weitere Details zu dem Befehl ''backup'' können der {{Link2CmdRef|Anker=backup}} entnommen werden.
-Dateien und Icons enthalten. Das Backup wird als .tar.gz Datei abgelegt und trägt dabei im Namen das Datum, an dem das Backup ausgeführt wurde.
-Weitere Details zu dem Befehl ''backup''können der [http://fhem.de/commandref.html#backup commandref] entnommen werden.
+== Backup manuell ausführen (Eingabefeld) ==
+Um ein Backup zu erstellen genügt es, in der FHEM [[PGM2|Benutzeroberfläche]] im [[Konfiguration#Befehl-Eingabefeld|Befehls-Eingabefeld]] den Befehl <code>backup</code> zu schreiben und mit {{Taste|Enter}} auszuführen.
-== Backup manuell ausführen (1) ==
+Danach findet sich eine Backupdatei in dem oben genannten Verzeichnis. In der FHEM Logdatei sollte ein Eintrag
-Um ein Backup zu erstellen genügt es, in der fhem Benutzeroberfläche im Eingabefeld den Befehl ''backup''zu schreiben und mit return auszuführen.
+:<code><nowiki>backup done: FHEM-<Datum>_<Uhrzeit>.tar.gz (<Größe> Bytes)</nowiki></code>
-Hinweis: Nicht den Save-Button betätigen, das würde nämlich kein Backup erstellen.
+zu finden sein.
-Danach findet sich eine Backupdatei in dem oben genannten Backupordner. Bei einem Blick in die fhem Logdatei
+== Backup manuell ausführen (Weboberfläche) ==
-sollte ein Eintrag
+Der Backup-Befehl kann auf verschiedene Arten in die Weboberfläche als manuell ausführbare Aktion eingebunden werden. Beispielsweise kann der Backup-Befehl in das linke Auswahlmenü von FHEM aufgenommen werden. Hierzu in das Attribut <code>menuEntries</code> der gewünschten [[FHEMWEB]]-Instanz folgendes aufnehmen:
+ attr WEB menuEntries Backup,/fhem?cmd=backup
- <nowiki>backup done: FHEM-&lt;Datum&gt;_&lt;Build&gt;.tar.gz (&lt;Größe&gt; Bytes)</nowiki>
-zu finden sein.
-== Backup manuell ausführen (2) ==
+Nachfolgend wird ein anderer Ansatz mit erweiterter Funktionalität verfolgt. Ein [[dummy]]-Device wird im Raum Server angelegt und mit dem [[WebCmd|webCmd]] "Ausführen" versehen. Ein Klick auf den Link "Ausführen" des dummy-Devices erzeugt einen Event, der per [[notify]] das Backup startet. Dazu sind folgende Definitionen in der [[Konfiguration]] einzurichten:
-Das Ausführen des Backups kann man nun noch in der Weboberfläche als manuell ausführbare Aktion einbinden. Dazu den folgenden Code in der fhem.cfg eintragen.
- <nowiki>#########################################################################
- ## Funktion......: FHEM Backup
- ## Besonderheiten: Manuelles Backup
- #########################################################################
   define SYS_Backup dummy
   attr SYS_Backup alias FHEM Backup ausführen
@@ Zeile 35: / Zeile 36: @@
   define SYS_BackupRun notify SYS_Backup:* backup
   attr SYS_BackupRun room Server
-  #########################################################################</nowiki>
+Alternativ kann man das notify noch so erweitern bzw. abändern, dass im state des dummy-Devices angezeigt wird, welche Backups bereits ausgeführt wurden. Zur Änderung des notify ruft man die [[Konfiguration#Objektdetails|Objektdetails]] des notify-Devices auf, klickt auf das {{Taste|DEF}} und kopiert den nachfolgenden Code als vollständigen Ersatz des alten Codes in das Editorfenster. Anschließend auf {{Taste|modify SYS_BackupRun}} klicken.
+Code für den {{Taste|DEF}}-Bereich des notify SYS_BackupRun (im Code das Backup-Verzeichnis ./backup gegebenenfalls noch an eigene Wünsche anpassen):
+ SYS_Backup:* {
+ fhem("backup");
+  opendir DIR, "./backup" or die $!;
+ my @mybackups =();
+ while(my $file = readdir DIR){
+   next if($file eq "." || $file eq "..");
+   push(@mybackups,$file);
+ }
+ closedir DIR;
+ @mybackups = join("<br>", sort(@mybackups) );
+ fhem("set SYS_Backup @mybackups");
+ }
+Eine ähnliche Lösung mit Auslagerung des Codes in [[99_myUtils_anlegen|99_myUtils]]: {{Link2Forum|Topic=42231|Message=388352}}
 == Backup automatisch ausführen ==
-Wem es lieber ist, dass ein Backup regelmäßig erstellt wird, der kann den folgenden Code in die fhem.cfg einfügen:
+Die regelmäßige automatische Erstellung einer Datensicherung unter Nutzung des oben gezeigten Codes (dummy, notiy) lässt sich mit folgendem [[at]] in der Konfiguration erreichen:
- <nowiki>#########################################################################
- ## Funktion......: FHEM Backup
- ## Besonderheiten: Autom. Backup
- #########################################################################
   define NTFY_BackupRun at *23:59:00 set SYS_Backup Ausführen
   attr NTFY_BackupRun room Server
-  #########################################################################</nowiki>
-Damit wird täglich um 23:59 ein Backup erstellt.
+Alternativ kann ohne Verwendung des oben gezeigten Codes zur automatischen Sicherung ein at definiert werden, das beispielsweise täglich lediglich backup startet:
+  define AT_Backup at *23:59:00 backup
+== Backup vor Update ==
+Ist in der Konfiguration der Eintrag
+:<code>attr global backup_before_update 1</code>
+enthalten, wird vor der Durchführung eines Update erst eine Datensicherung in das festgelegte Backup Verzeichnis durchgeführt.
+[[Kategorie:HOWTOS]]
+[[Kategorie:Glossary]]