Update: Unterschied zwischen den Versionen
Krikan (Diskussion | Beiträge) K (→Attribute: -> restoreDirs hinzugefügt) |
Krikan (Diskussion | Beiträge) K ("restore" umgegliedert) |
||
Zeile 41: | Zeile 41: | ||
=== update <Dateiname> === | === update <Dateiname> === | ||
Mit z.B. ''update 02_HTTPSRV.pm'' wird nur von der Datei ''02_HTTPSRV.pm'' eine neue Version installiert. Alle anderen FHEM-Dateien werden nicht angetastet. | Mit z.B. ''update 02_HTTPSRV.pm'' wird nur von der Datei ''02_HTTPSRV.pm'' eine neue Version installiert. Alle anderen FHEM-Dateien werden nicht angetastet. | ||
== Attribute == | == Attribute == | ||
Zeile 50: | Zeile 47: | ||
=== restoreDirs === | === restoreDirs === | ||
siehe [[# | siehe [[#Rücksichern beim Update überschriebener Dateien]] | ||
== Anwendungsbeispiel == | == Anwendungsbeispiel == | ||
=== Durchführung eines Updates === | |||
Zunächst kann mit dem Befehl | Zunächst kann mit dem Befehl | ||
:<code>update check</code> | :<code>update check</code> | ||
Zeile 63: | Zeile 61: | ||
:<code>List of new / modified files since last update:</code> | :<code>List of new / modified files since last update:</code> | ||
:<code>nothing to do...</code> | :<code>nothing to do...</code> | ||
=== Rücksichern beim Update überschriebener Dateien === | |||
Per default werden vor dem Überschreiben alle Dateien in einem neuen Verzeichnis (restoreDir/Datum) gesichert. Diese Dateien kann man einzeln oder komplett mit dem Befehl [http://fhem.de/commandref#restore restore] zuruecksichern (z.Bsp.: <code>update restore 2014-08-19</code> oder <code>update restore 2014-08-19/fhem.pl</code>). Mit dem restoreDirs Attribut kann man die Anzahl der aufgehobenen Sicherungen (== Datum-Verzeichnisse) bestimmen, die Voreinstellung ist 3. Mit 0 kann man das Feature komplett abschalten. |
Version vom 21. April 2015, 03:52 Uhr
update | |
---|---|
Zweck / Funktion | |
Befehl zur Aktualisierung der Fhem-Installation | |
Allgemein | |
Typ | Befehl |
Details | |
Dokumentation | EN / DE |
Support (Forum) | Sonstiges |
Modulname | 98_update.pm |
Ersteller | rudolfkoenig (Forum / Wiki) |
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! |
update ist ein Befehl zur Aktualisierung der Fhem-Installation direkt über das Fhem Webfrontend.
Syntax
update [development|stable] [<file>|check|fhem|full] [force]
Seit dem 19.08.2014 wird ein neues Update-Modul (hier im Forum vorgestellt) von Fhem verteilt. Die Syntax lautet nun:
update [<fileName>|all|check|force] [http://.../controlfile]
Hinweise:
- bis 18.08.2014: Fhem führt (sofern entsprechend voreingestellt) ein Backup der bisherigen Installations- und Konfigurationsdateien vor einem Update durch.
- ab 19.08.2014: Fhem sichert "nur" die Modul(Installations-)dateien standardmäßig. Backup muss separat eingeschaltet werden. Details dazu in diesem Forenthread
- Lesen Sie aufmerksam die nach dem Update auf dem Monitor erscheinenden Meldungen.
- Nach einem Update ist immer ein shutdown restart erforderlich.
- geänderte und neu eingecheckte Module werden grundsätzlich erst am Folgetag ab ca. 8.00 Uhr durch den Update-Befehl verteilt.
Parameter
Details zu Parametern des update Befehls:
update
Die ganze Fhem-Installation wird auf die neueste Version gebracht.
update check
Es werden alle Module aufgelistet, von denen eine neuere als die bereits installierte Version verfügbar ist. Es wird nicht installiert.
update development
Sie führen ein Update auf die in der Entwicklung befindliche FHEM-Version durch. Dies kann dazu führen, dass einiges nicht (mehr) so läuft, wie Sie es gewohnt sind. Für ein bisher stabiles und produktiv eingesetztes FHEM-System sollte daher besser nur der Befehl update stable genutzt werden. Dazu sollte man aber eins wissen: Es gibt faktisch keinen Unterschied zwischen stable und development, da nur eine Version gepflegt wird.
update force
Das Update wird erzwungen (falls es beim regulären update Probleme geben sollte).
update <Dateiname>
Mit z.B. update 02_HTTPSRV.pm wird nur von der Datei 02_HTTPSRV.pm eine neue Version installiert. Alle anderen FHEM-Dateien werden nicht angetastet.
Attribute
backup_before_update
siehe auch backup
restoreDirs
siehe #Rücksichern beim Update überschriebener Dateien
Anwendungsbeispiel
Durchführung eines Updates
Zunächst kann mit dem Befehl
update check
überprüft werden, ob es überhaupt ein neues Update gibt und welche Dateien hierbei ausgetauscht würden (die angezeigten Infos sollten in einer Textdatei gesichert werden. Mit diesen Infos kann gezielter nach Problemen, die vielleicht nach einem Update auftreten, gesucht werden). Anschließend kann mittels:
update
das Update eingespielt werden. Hierbei ist zu beachten, dass die Befehle auf der FHEM Webseite oben (Befehls-Eingabefeld) eingegeben werden und anschließend die "Enter" Taste auf der Tastatur gedrückt werden muss.
Gibt es kein Update für FHEM, sieht die Ausgabe z.B. nach "update check" wie folgt aus:
List of new / modified files since last update:
nothing to do...
Rücksichern beim Update überschriebener Dateien
Per default werden vor dem Überschreiben alle Dateien in einem neuen Verzeichnis (restoreDir/Datum) gesichert. Diese Dateien kann man einzeln oder komplett mit dem Befehl restore zuruecksichern (z.Bsp.: update restore 2014-08-19
oder update restore 2014-08-19/fhem.pl
). Mit dem restoreDirs Attribut kann man die Anzahl der aufgehobenen Sicherungen (== Datum-Verzeichnisse) bestimmen, die Voreinstellung ist 3. Mit 0 kann man das Feature komplett abschalten.