Save: Unterschied zwischen den Versionen

Aus FHEMWiki
Zur Navigation springen Zur Suche springen
K (Statefile hinzugefügt)
Keine Bearbeitungszusammenfassung
Zeile 11: Zeile 11:
Auch das Anklicken der Schaltfläche '''''Save config''''' (siehe [[Konfiguration#Bearbeitung der Konfiguration|Beispielabbildung]]) resultiert in der Ausführung dieses Befehls.
Auch das Anklicken der Schaltfläche '''''Save config''''' (siehe [[Konfiguration#Bearbeitung der Konfiguration|Beispielabbildung]]) resultiert in der Ausführung dieses Befehls.


== Protokollierung von Konfigurationsänderungen ==
=== Config-file (Speichern der Konfiguration) ===
Im config-file wird die Konfiguration der Objekte gespeichert. Hierfür sollte folgendes Attribut angelegt sein:
 
:<code>attr global configfile fhem.cfg</code>
 
 
==== Protokollierung von Konfigurationsänderungen ====
Um Konfigurationsänderungen, die über das [[FHEMWEB|Webinterface]] gemacht wurden, zu protokollieren, kann mit (z.B.) dem folgenden Befehl eine spezielle [[FileLog|Logdatei]] angelegt werden:
Um Konfigurationsänderungen, die über das [[FHEMWEB|Webinterface]] gemacht wurden, zu protokollieren, kann mit (z.B.) dem folgenden Befehl eine spezielle [[FileLog|Logdatei]] angelegt werden:
:<code>define myConfigLog FileLog ./log/configChangeHistory.log global:(MODIFIED|DEFINED|ATTR|RENAMED|DELETED).*</code>
:<code>define myConfigLog FileLog ./log/configChangeHistory.log global:(MODIFIED|DEFINED|ATTR|RENAMED|DELETED).*</code>
Zeile 18: Zeile 24:
Um einen Block von Änderungen in der Logdatei zu kommentieren, kann beispielsweise das [[Attribut]] "comment" des betreffenden Geräts angelegt bzw. geändert werden.
Um einen Block von Änderungen in der Logdatei zu kommentieren, kann beispielsweise das [[Attribut]] "comment" des betreffenden Geräts angelegt bzw. geändert werden.


== Statefile (Speichern der Zustände) ==
=== State-file (Speichern der Zustände) ===
https://fhem.de/commandref_DE.html#statefile  
https://fhem.de/commandref_DE.html#statefile  


Zeile 24: Zeile 30:
:<code>attr global statefile ./fhem.save</code>
:<code>attr global statefile ./fhem.save</code>


== Periodisches Speichern des Statefiles ==
==== Periodisches Speichern des Statefiles ====
Beispiel: Statefile alle 15 Minuten speichern. (nicht die Konfiguration)
Beispiel:  
Statefile alle 15 Minuten speichern. (nicht die Konfiguration). Somit bleiben interne Zustände erhalten, wenn fhem nicht sauber beendet wird, z.B. beim Ausschalten des Systems (Raspberry Pi).
 
:<code>defmod saveStateFile at +*00:15:00 {WriteStatefile()}</code>
:<code>defmod saveStateFile at +*00:15:00 {WriteStatefile()}</code>


== Links ==
== Links ==
* Forenthema zur {{Link2Forum|Topic=112517|LinkText=Protokollierung von Konfigurationsänderungen}}
* Forenthema zur {{Link2Forum|Topic=112517|LinkText=Protokollierung von Konfigurationsänderungen}}

Version vom 19. März 2023, 16:18 Uhr

save
Zweck / Funktion
Speichert Konfigurationsänderungen
Allgemein
Typ Befehl
Details
Dokumentation EN / DE
Modulname fhem.pl
Ersteller rudolfkoenig/Rudolfkoenig (Forum /Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Der Befehl save gehört zu den FHEM-eigenen Befehlen. Mit ihm werden Änderungen der Konfiguration dauerhaft gespeichert.

Auch das Anklicken der Schaltfläche Save config (siehe Beispielabbildung) resultiert in der Ausführung dieses Befehls.

Config-file (Speichern der Konfiguration)

Im config-file wird die Konfiguration der Objekte gespeichert. Hierfür sollte folgendes Attribut angelegt sein:

attr global configfile fhem.cfg


Protokollierung von Konfigurationsänderungen

Um Konfigurationsänderungen, die über das Webinterface gemacht wurden, zu protokollieren, kann mit (z.B.) dem folgenden Befehl eine spezielle Logdatei angelegt werden:

define myConfigLog FileLog ./log/configChangeHistory.log global:(MODIFIED|DEFINED|ATTR|RENAMED|DELETED).*

Wie bei Log Dateien üblich bestimmt der angegebene Reguläre Ausdruck den Umfang der Protokollierung, im gegebenen Beispiel würden also Neudefinitionen, Löschungen, Umbenennungen und Attributänderungen protokolliert.

Um einen Block von Änderungen in der Logdatei zu kommentieren, kann beispielsweise das Attribut "comment" des betreffenden Geräts angelegt bzw. geändert werden.

State-file (Speichern der Zustände)

https://fhem.de/commandref_DE.html#statefile

Die internen Zustände (Readings) werden im statefile gespeichert. Voraussetzung ist die Definition des Attributes

attr global statefile ./fhem.save

Periodisches Speichern des Statefiles

Beispiel: Statefile alle 15 Minuten speichern. (nicht die Konfiguration). Somit bleiben interne Zustände erhalten, wenn fhem nicht sauber beendet wird, z.B. beim Ausschalten des Systems (Raspberry Pi).

defmod saveStateFile at +*00:15:00 {WriteStatefile()}

Links