Update - Versionsgeschichte

Soulman: /* Parameter */ noSSL ergänzt

2022-08-09T22:07:49Z

Parameter: noSSL ergänzt

← Nächstältere Version		Version vom 10. August 2022, 00:07 Uhr
Zeile 37:		Zeile 37:
	==== update <Dateiname> ====		==== update <Dateiname> ====
	Mit z.B. <code>update 02_HTTPSRV.pm</code> wird nur von der Datei ''02_HTTPSRV.pm'' eine neue Version installiert. Alle anderen FHEM-Dateien werden nicht angetastet.		Mit z.B. <code>update 02_HTTPSRV.pm</code> wird nur von der Datei ''02_HTTPSRV.pm'' eine neue Version installiert. Alle anderen FHEM-Dateien werden nicht angetastet.


			==== update -noSSL ====
			Mit -noSSL wird das http Protocol statt https verwendet, was bei bestimmten
			veralteten Distributionen notwendig sein kann. -noSSL steht erst seit 98_update.pm von Ende 2019 zur Verfügung.


	==== update all ====		==== update all ====

Soulman: /* Syntax */ update [-noSSL] ergänzt

2022-08-09T22:04:12Z

Syntax: update [-noSSL] ergänzt

← Nächstältere Version		Version vom 10. August 2022, 00:04 Uhr
Zeile 11:		Zeile 11:

	== Syntax ==		== Syntax ==
	:<code><nowiki>update [<fileName>\|all\|check\|force] [http://.../controlfile]</nowiki></code>		:<code><nowiki>update [-noSSL] [<fileName>\|all\|check\|force] [http://.../controlfile]</nowiki></code>
	oder		oder
	:<code><nowiki>update [add source\|delete source\|list\|reset]</nowiki></code>		:<code><nowiki>update [add source\|delete source\|list\|reset]</nowiki></code>

Ph1959de: ohne "lang=" auf

 umgestellt

2021-03-16T10:57:32Z

<syntaxhighlight> ohne "lang=" auf <pre> umgestellt

← Nächstältere Version		Version vom 16. März 2021, 12:57 Uhr
Zeile 6:		Zeile 6:
	\|ModForumArea=Sonstiges		\|ModForumArea=Sonstiges
	\|ModTechName=98_update.pm		\|ModTechName=98_update.pm
	\|ModOwner=rudolfkoenig (~~[http://forum.fhem.de/index.php?action=profile;u=~~8 Forum] / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])		\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])
	}}		}}
	[[update]] ist ein Befehl zur Aktualisierung der FHEM-Installation direkt über das FHEM [[FHEMWEB\|Webfrontend]]. Von den Entwicklern bis zu einem bestimmten Zeitpunkt freigegebene Änderungen sind jeweils morgens ab 8:00 Uhr über die Update Funktion verfügbar. Änderungen, die später freigegeben werden, werden dementsprechend erst am nächsten Tag verfügbar.		[[update]] ist ein Befehl zur Aktualisierung der FHEM-Installation direkt über das FHEM [[FHEMWEB\|Webfrontend]]. Von den Entwicklern bis zu einem bestimmten Zeitpunkt freigegebene Änderungen sind jeweils morgens ab 8:00 Uhr über die Update Funktion verfügbar. Änderungen, die später freigegeben werden, werden dementsprechend erst am nächsten Tag verfügbar.
Zeile 175:		Zeile 175:
	Sollte nach einem update etwas ganz oder teilweise nicht mehr funktionieren, kann man auf den Stand vor dem Update zurückgehen. Die Befehle sind für die FHEM Kommandozeile.		Sollte nach einem update etwas ganz oder teilweise nicht mehr funktionieren, kann man auf den Stand vor dem Update zurückgehen. Die Befehle sind für die FHEM Kommandozeile.

	Man kann sich einen Überblick über die Funktion des Befehls {{Link2CmdRef\|Anker=restore\|Label=restore}} verschaffen:<~~syntaxhighlight~~>		Man kann sich einen Überblick über die Funktion des Befehls {{Link2CmdRef\|Anker=restore\|Label=restore}} verschaffen:
			<pre>
	help restore		help restore
	</~~syntaxhighlight~~>Man kann die gesicherten Versionen listen<~~syntaxhighlight~~>		</pre>
			Man kann die gesicherten Versionen listen
			<pre>
	restore list update		restore list update

	Available for restore in update:		Available for restore in update:
	2020-11-01		2020-11-01
	</~~syntaxhighlight~~>Man kann in der Verzeichnis Ebene tiefer suchen<~~syntaxhighlight~~>		</pre>
			Man kann in der Verzeichnis Ebene tiefer suchen
			<pre>
	restore list update/2020-11-01		restore list update/2020-11-01

Zeile 194:		Zeile 199:
	lib		lib
	log		log
	</~~syntaxhighlight~~>Man kann gezielt wiederherstellen, entweder den kompletten Pfad oder einzelne Dateien.<~~syntaxhighlight~~>		</pre>
			Man kann gezielt wiederherstellen, entweder den kompletten Pfad oder einzelne Dateien.
			<pre>
	restore update/2020-11-01/FHEM		restore update/2020-11-01/FHEM
	restore update/2020-11-01/FHEM/10_CUL_HM.pm		restore update/2020-11-01/FHEM/10_CUL_HM.pm
	</~~syntaxhighlight~~>Weitere Informationen:		</pre>
			Weitere Informationen:
	* Per default werden vor dem Überschreiben durch update alle Dateien in einem neuen Verzeichnis (restoreDir/update/YYYY-MM-DD) gesichert.		* Per default werden vor dem Überschreiben durch update alle Dateien in einem neuen Verzeichnis (restoreDir/update/YYYY-MM-DD) gesichert.
	* 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.		* 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.
Zeile 204:		Zeile 212:

	=== Update ging schief - restore letzte funktionierende Version ===		=== Update ging schief - restore letzte funktionierende Version ===
	Sollte der Fall eintreten, dass FHEM nach dem Update nicht mehr startet, kann das restore des letzten Standes auch auf Systemebene durchgeführt werden. Anzeigen der vorhandenen Sicherungen:<syntaxhighlight lang="bash">		Sollte der Fall eintreten, dass FHEM nach dem Update nicht mehr startet, kann das restore des letzten Standes auch auf Systemebene durchgeführt werden. Anzeigen der vorhandenen Sicherungen:
			<syntaxhighlight lang="bash">
	ls /opt/fhem/restoreDir/update		ls /opt/fhem/restoreDir/update
	</syntaxhighlight>Die Pfad-Angabe YYYY-MM-DD durch das gewünschte Datum ersetzen:<syntaxhighlight lang="bash">		</syntaxhighlight>
			Die Pfad-Angabe YYYY-MM-DD durch das gewünschte Datum ersetzen:<syntaxhighlight lang="bash">
	sudo -su fhem cp -R /opt/fhem/restoreDir/update/YYYY-MM-DD/* /opt/fhem/		sudo -su fhem cp -R /opt/fhem/restoreDir/update/YYYY-MM-DD/* /opt/fhem/
	</syntaxhighlight>Die Berechtigungen bleiben durch die Verwendung des Users fhem erhalten. Danach sollte sich FHEM normal starten lassen. Im Zweifelsfall ist ein reboot des Systems die einfachste Lösung.		</syntaxhighlight>
			Die Berechtigungen bleiben durch die Verwendung des Users fhem erhalten. Danach sollte sich FHEM normal starten lassen. Im Zweifelsfall ist ein reboot des Systems die einfachste Lösung.

	=== Einzelne Dateien aus dem SVN holen ===		=== Einzelne Dateien aus dem SVN holen ===
	Manchmal wird im Forum die Empfehlung gegeben: Die Fehler-bereinigte Datei bitte direkt aus dem SVN holen. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen, hier ein paar Beispiele:<syntaxhighlight lang="perl">		Manchmal wird im Forum die Empfehlung gegeben ''Die Fehler-bereinigte Datei bitte direkt aus dem SVN holen''. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen, hier ein paar Beispiele:
			<syntaxhighlight lang="perl">
	{ Svn_GetFile('FHEM/DevIo.pm', 'FHEM/DevIo.pm') }		{ Svn_GetFile('FHEM/DevIo.pm', 'FHEM/DevIo.pm') }
	{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }		{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }
	{ Svn_GetFile('fhem.cfg', 'minimal.cfg') }		{ Svn_GetFile('fhem.cfg', 'minimal.cfg') }
	</syntaxhighlight>Wie man sieht, kann man sich damit auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!		</syntaxhighlight>
			Wie man sieht, kann man sich damit auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!

Otto123: /* Rücksichern beim Update überschriebener Dateien */ Beschreibung erweitert

2020-11-02T08:18:55Z

Rücksichern beim Update überschriebener Dateien: Beschreibung erweitert

@@ Zeile 173: / Zeile 173: @@
 === Rücksichern beim Update überschriebener Dateien ===
-Per default werden vor dem Überschreiben durch update alle Dateien in einem neuen Verzeichnis (restoreDir/update/YYYY-MM-DD) gesichert. Diese Dateien kann man einzeln oder komplett mit dem Befehl {{Link2CmdRef|Anker=restore|Label=restore}} zurücksichern (z.Bsp.: <code>restore update/2014-08-19</code> oder <code>restore update/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.
+Sollte nach einem update etwas ganz oder teilweise nicht mehr funktionieren, kann man auf den Stand vor dem Update zurückgehen. Die Befehle sind für die FHEM Kommandozeile.
-Ab Updatestand 29.10.2016 können bei Standardinstallationen ({{Link2Forum|Topic=59669|Message=511367}}) die fhem.cfg und fhem.save mit der Option -a des restore-Befehl wiederhergestellt werden.
+Man kann sich einen Überblick über die Funktion des Befehls {{Link2CmdRef|Anker=restore|Label=restore}} verschaffen:<syntaxhighlight>
-Zu Neuerungen ab Updatestand 18.03.2018 siehe {{Link2Forum|Topic=85801|Message=782640}}.
+Available for restore in update:
 === Update ging schief - restore letzte funktionierende Version ===

AndreasMohr: Typos/Spelling

2020-05-02T08:28:40Z

Typos/Spelling

Otto123: /* Einzelne Dateien aus dem SVN holen */ Beispiele erweitert

2020-04-14T09:49:50Z

Einzelne Dateien aus dem SVN holen: Beispiele erweitert

← Nächstältere Version		Version vom 14. April 2020, 11:49 Uhr
Zeile 187:		Zeile 187:

	=== Einzelne Dateien aus dem SVN holen ===		=== Einzelne Dateien aus dem SVN holen ===
	Manchmal wird im Forum die Empfehlung gegeben: Die Fehler bereinigte Datei bitte direkt aus dem SVN holen. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen:<syntaxhighlight lang="perl">		Manchmal wird im Forum die Empfehlung gegeben: Die Fehler bereinigte Datei bitte direkt aus dem SVN holen. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen, hier ein paar Beispiele:<syntaxhighlight lang="perl">
			{ Svn_GetFile('FHEM/DevIo.pm', 'FHEM/DevIo.pm') }
	{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }		{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }
	</syntaxhighlight>~~Damit~~ kann man sich auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!		{ Svn_GetFile('fhem.cfg', 'minimal.cfg') }
			</syntaxhighlight>Wie man sieht, kann man sich damit auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!

Otto123: /* Rücksichern beim Update überschriebener Dateien */ 2 Abschnitte zur Problembehandlung ergänzt

2020-04-14T08:54:59Z

Rücksichern beim Update überschriebener Dateien: 2 Abschnitte zur Problembehandlung ergänzt

@@ Zeile 159: / Zeile 159: @@
 aus. Wird ''commandref'' in das <code>exclude_from_update</code> Attribut eingetragen, entfällt dieser Schritt, die lokale ''commandref'' wird allerdings dann auch nicht mehr aktualisiert. Die modulspezifische Hilfe, die z.B. über <code>help modulname</code> aufgerufen werden kann, ist davon nicht betroffen.
-== Anwendungsbeispiel ==
+== Anwendungsbeispiel / Problembehebung ==
 === Durchführung eines Updates ===
 Zunächst kann mit dem Befehl
@@ Zeile 178: / Zeile 178: @@
 Zu Neuerungen ab Updatestand 18.03.2018 siehe {{Link2Forum|Topic=85801|Message=782640}}.

OdfFhem: Neuer controlfile-Befehl CRE

2019-12-07T02:29:40Z

Neuer controlfile-Befehl CRE

← Nächstältere Version		Version vom 7. Dezember 2019, 04:29 Uhr
Zeile 68:		Zeile 68:
	Das Controlfile für thirdparty Module unterliegt einer festen Syntax. In jeder Zeile steht ein Dateiname und ein Befehl, was damit passieren soll. Ein Zeilenumbruch wird durch ein \n dargestellt.		Das Controlfile für thirdparty Module unterliegt einer festen Syntax. In jeder Zeile steht ein Dateiname und ein Befehl, was damit passieren soll. Ein Zeilenumbruch wird durch ein \n dargestellt.

	Es können ~~zwei~~ Befehle verwendet werden: MOV und UPD.		Es können drei Befehle verwendet werden: CRE, MOV und UPD.

			===== CRE - Anlegen einer Datei =====

			Hiermit können vom Entwickler Dateinamen festgelegt und entsprechende Initial-Dateien verteilt werden; der Inhalt der Datei liegt nach dem ''ersten'' Verteilen in Anwenderhänden (z.B. nützlich bei *-user.css-Dateien).

			<code>CRE <Datum> <Dateigröße> <Datei inkl. Pfad> </code>

			Das Anlegen wird nur ausgeführt, wenn
			* die Datei noch nicht vorhanden ist.

	===== MOV - Verschieben oder Umbenennen einer Datei =====		===== MOV - Verschieben oder Umbenennen einer Datei =====
Zeile 74:		Zeile 83:
	<code>MOV <Quelldatei inkl. Pfad> <Zieldatei inkl. Pfad> </code>		<code>MOV <Quelldatei inkl. Pfad> <Zieldatei inkl. Pfad> </code>

	Dateien ~~lassen sich~~ mit dem MOV Befehl ~~auch~~ in einen speziellen Ordner "unused" ~~verschieben. Ein vollständiges Löschen der Datei ist nicht möglich~~:		Da Dateien nicht vollständig gelöscht werden können, kann eine Datei mit dem MOV Befehl in einen speziellen Ordner namens "unused" verschoben werden:

	<code>MOV <~~quelldatei~~ inkl. Pfad> unused </code>		<code>MOV <Quelldatei inkl. Pfad> unused </code>

	===== UPD - Aktualisieren einer Datei =====		===== UPD - Aktualisieren einer Datei =====

Pizmus: /* Syntax controlfile */

2018-10-11T10:48:26Z

Syntax controlfile

← Nächstältere Version		Version vom 11. Oktober 2018, 12:48 Uhr
Zeile 66:		Zeile 66:

	==== Syntax controlfile ====		==== Syntax controlfile ====
	Das Controlfile~~, welches durch~~ thirdparty Module ~~angelegt wird~~ unterliegt einer Syntax.		Das Controlfile für thirdparty Module unterliegt einer festen Syntax. In jeder Zeile steht ein Dateiname und ein Befehl, was damit passieren soll. Ein Zeilenumbruch wird durch ein \n dargestellt.
	~~Im Controlfile steht in~~ jeder Zeile ein Dateiname und ein Befehl, was damit passieren soll. Ein Zeilenumbruch wird durch ein \n dargestellt

	Es können zwei Befehle verwendet werden		Es können zwei Befehle verwendet werden: MOV und UPD.
	UPD ~~zum Aktualisieren einer Datei, MOV zum Verschieben einer Datei~~.

	~~Aufbau der Befehle:~~		===== MOV - Verschieben oder Umbenennen einer Datei =====

	~~Zum Aktualisieren einer Datei~~. ~~Die Aktualisierung wird nur ausgeführt, wenn das Datum von~~ der ~~lokalen~~ Datei ~~unterschiedlich~~ ist ~~und die Dateigröße der heruntergeladenen~~ Datei ~~übereinstimmt:~~		<code>MOV <Quelldatei inkl. Pfad> <Zieldatei inkl. Pfad> </code>

			Dateien lassen sich mit dem MOV Befehl auch in einen speziellen Ordner "unused" verschieben. Ein vollständiges Löschen der Datei ist nicht möglich:

			<code>MOV <quelldatei inkl. Pfad> unused </code>

			===== UPD - Aktualisieren einer Datei =====

	<code>UPD <Datum> <Dateigröße> <Datei inkl. Pfad> </code>		<code>UPD <Datum> <Dateigröße> <Datei inkl. Pfad> </code>

			Die Aktualisierung wird nur ausgeführt, wenn
			* das Datum der lokalen Datei sich vom Datum der Update-Datei unterscheidet.
			* die Dateigröße der Update-Datei mit der Dateigröße im UPD Eintrag übereinstimmt.

	~~Zum Verschieben oder umbenennen einer Datei.~~		Beispiel:

	~~<code>MOV <quelldatei inkl. Pfad> <Zieldatei inkl. Pfad> </code>~~

	~~Dateien lassen sich mit dem MOV Befehl auch in einen speziellen Ordner "unused" verschieben~~. ~~Ein vollständiges Löschen der Datei ist nicht möglich:~~		<code>
			UPD 2018-10-04_20:17:35 55143 FHEM/55_MyFirstFile.pm

	~~<code>MOV <quelldatei inkl~~. ~~Pfad> unused~~ </code>		UPD 2018-09-27_23:26:21 17121 FHEM/55_MySecondFile.pm
			</code>

	~~Bei Verwendung des Befehls~~ UPD ~~ist wichtig, dass das Datum inklusive Uhrzeit übergeben wird.~~		Beispiel für die Erzeugung der UPD Einträge:

	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	~~my $date = POSIX~~::~~strftime("%Y-%m-%d", localtime( $fi->{mtime} ))~~;		#!/usr/bin/perl
	~~my $time =~~ POSIX::strftime~~("%H:%M:%S", localtime( $fi->{mtime} )~~);
	~~</syntaxhighlight>~~		use File::Basename;
			use POSIX qw(strftime);
			use strict;

	~~Erzeugt ''2018-10-09_23:50:13''~~.		my @filenames = ( "55_MyFirstFile.pm",
			"55_MySecondFile.pm");

	~~Die Dateigröße ist exakt zu bestimmen~~:		my $prefix = "FHEM";
			my $filename = "";
			foreach $filename (@filenames)
			{
			my @statOutput = stat($prefix."/".$filename);

			if (scalar @statOutput != 13)
			{
			printf("error: stat has unexpected return value for ".$prefix."/".$filename."\n");
			next;
			}

	~~<syntaxhighlight lang~~=~~"perl">~~		my $mtime = $statOutput[9];
	~~@line_parts~~[2] = ~~fileparse~~(~~$file,~~"");		my $date = POSIX::strftime("%Y-%m-%d", localtime($mtime));
	~~@line_parts[3] = $fi->{size};~~		my $time = POSIX::strftime("%H:%M:%S", localtime($mtime));
	$~~modifiy_line~~ = ~~join~~(" ",~~@line_parts~~)."\n";		my $filetime = $date."_".$time;
	~~</syntaxhighlight>~~

	~~Komplettes Beispiel:~~		my $filesize = $statOutput[7];

	~~<code>~~UPD ~~2018-10-09_23:50:13 40341 FHEM~~/~~98_Dooya~~.pm</~~code~~>		printf("UPD ".$filetime." ".$filesize." ".$prefix."/".$filename."\n");
			}
			</syntaxhighlight>

	== Attribute ==		== Attribute ==

Krikan: /* Syntax controlfile */ -> Fehlerkorrektur

2018-10-09T06:21:27Z

Syntax controlfile: -> Fehlerkorrektur

← Nächstältere Version		Version vom 9. Oktober 2018, 08:21 Uhr
Zeile 90:		Zeile 90:

	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	my $date = POSIX::strftime("%Y-%d-%m", localtime( $fi->{mtime} ));		my $date = POSIX::strftime("%Y-%m-%d", localtime( $fi->{mtime} ));
	my $time = POSIX::strftime("%H:%M:%S", localtime( $fi->{mtime} ));		my $time = POSIX::strftime("%H:%M:%S", localtime( $fi->{mtime} ));
	</syntaxhighlight>		</syntaxhighlight>

	Erzeugt ''~~2016_14_10_23~~:50:13''.		Erzeugt ''2018-10-09_23:50:13''.

	Die Dateigröße ist exakt zu bestimmen:		Die Dateigröße ist exakt zu bestimmen:
Zeile 106:		Zeile 106:
	Komplettes Beispiel:		Komplettes Beispiel:

	<code>UPD ~~2016_14_10_23~~:50:13 40341 FHEM/98_Dooya.pm</code>		<code>UPD 2018-10-09_23:50:13 40341 FHEM/98_Dooya.pm</code>

	== Attribute ==		== Attribute ==

← Nächstältere Version		Version vom 2. Mai 2020, 10:28 Uhr
Zeile 47:		Zeile 47:

	=== Repository-Verwaltung ===		=== Repository-Verwaltung ===
	In den Standardeinstellungen von FHEM ist für jedes einzelne Repository ein separater Aufruf der [[#Standardaufrufe\|Standardaufrufe]] zur Aktualiserung/Installation notwendig. Zur Vereinfachung des Update-Prozesses hat der update-Befehl eine eingebaute Repository-Verwaltung. Mittels der Repository-Verwaltung lassen sich die Standardaufrufe so ~~beeinflußen~~, dass mit einem einzigen Aufruf sowohl die Module aus dem FHEM-Repository als auch aus verschiedenen Thirdparty-Repositorys beim Update berücksichtigt werden.		In den Standardeinstellungen von FHEM ist für jedes einzelne Repository ein separater Aufruf der [[#Standardaufrufe\|Standardaufrufe]] zur Aktualiserung/Installation notwendig. Zur Vereinfachung des Update-Prozesses hat der update-Befehl eine eingebaute Repository-Verwaltung. Mittels der Repository-Verwaltung lassen sich die Standardaufrufe so beeinflussen, dass mit einem einzigen Aufruf sowohl die Module aus dem FHEM-Repository als auch aus verschiedenen Thirdparty-Repositorys beim Update berücksichtigt werden.

	==== update add ====		==== update add ====
Zeile 153:		Zeile 153:
	kann eine Liste von Dateien spezifiziert werden, die bei der Ausführung des update Befehls '''nicht''' aktualisiert werden sollen. Dateien können auch über reguläre Ausdrücke definiert werden, die einzelnen Einträge werden durch Leerzeichen voneinander getrennt.		kann eine Liste von Dateien spezifiziert werden, die bei der Ausführung des update Befehls '''nicht''' aktualisiert werden sollen. Dateien können auch über reguläre Ausdrücke definiert werden, die einzelnen Einträge werden durch Leerzeichen voneinander getrennt.

	Einen Spezialfall stellt die ''commandref'' dar, die seit einer Modifikation des Update Prozesses (März 2015, beschrieben in dieser {{Link2Forum\|Topic=34450\|LinkText=~~Forendiskusion~~}}) nicht mehr heruntergeladen wird, sondern auf dem Benutzersystem durch Extraktion der Dokumentation aus den einzelnen Modulen generiert wird, angezeigt durch die Meldung im fhem.log:		Einen Spezialfall stellt die ''commandref'' dar, die seit einer Modifikation des Update Prozesses (März 2015, beschrieben in dieser {{Link2Forum\|Topic=34450\|LinkText=Forendiskussion}}) nicht mehr heruntergeladen wird, sondern auf dem Benutzersystem durch Extraktion der Dokumentation aus den einzelnen Modulen generiert wird, angezeigt durch die Meldung im fhem.log:
	:''Calling /usr/bin/perl ./contrib/commandref_join.pl, this may take a while''.		:''Calling /usr/bin/perl ./contrib/commandref_join.pl, this may take a while''.
	Sollte dieser Prozess (z.B. auf einem langsamen Rechner) zu lange dauern, bleibt die Meldung		Sollte dieser Prozess (z.B. auf einem langsamen Rechner) zu lange dauern, bleibt die Meldung
Zeile 173:		Zeile 173:

	=== Rücksichern beim Update überschriebener Dateien ===		=== Rücksichern beim Update überschriebener Dateien ===
	Per default werden vor dem Überschreiben durch update alle Dateien in einem neuen Verzeichnis (restoreDir/update/YYYY-MM-DD) gesichert. Diese Dateien kann man einzeln oder komplett mit dem Befehl {{Link2CmdRef\|Anker=restore\|Label=restore}} ~~zuruecksichern~~ (z.Bsp.: <code>restore update/2014-08-19</code> oder <code>restore update/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.		Per default werden vor dem Überschreiben durch update alle Dateien in einem neuen Verzeichnis (restoreDir/update/YYYY-MM-DD) gesichert. Diese Dateien kann man einzeln oder komplett mit dem Befehl {{Link2CmdRef\|Anker=restore\|Label=restore}} zurücksichern (z.Bsp.: <code>restore update/2014-08-19</code> oder <code>restore update/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.

	Ab Updatestand 29.10.2016 können bei Standardinstallationen ({{Link2Forum\|Topic=59669\|Message=511367}}) die fhem.cfg und fhem.save mit der Option -a des restore-Befehl wiederhergestellt werden.		Ab Updatestand 29.10.2016 können bei Standardinstallationen ({{Link2Forum\|Topic=59669\|Message=511367}}) die fhem.cfg und fhem.save mit der Option -a des restore-Befehl wiederhergestellt werden.
Zeile 180:		Zeile 180:

	=== Update ging schief - restore letzte funktionierende Version ===		=== Update ging schief - restore letzte funktionierende Version ===
	Sollte der Fall eintreten, ~~das~~ FHEM nach dem Update nicht mehr startet, kann das restore des letzten Standes auch auf Systemebene durchgeführt werden. Anzeigen der vorhandenen Sicherungen:<syntaxhighlight lang="bash">		Sollte der Fall eintreten, dass FHEM nach dem Update nicht mehr startet, kann das restore des letzten Standes auch auf Systemebene durchgeführt werden. Anzeigen der vorhandenen Sicherungen:<syntaxhighlight lang="bash">
	ls /opt/fhem/restoreDir/update		ls /opt/fhem/restoreDir/update
	</syntaxhighlight>Die Pfad Angabe YYYY-MM-DD durch das gewünschte Datum ersetzen:<syntaxhighlight lang="bash">		</syntaxhighlight>Die Pfad-Angabe YYYY-MM-DD durch das gewünschte Datum ersetzen:<syntaxhighlight lang="bash">
	sudo -su fhem cp -R /opt/fhem/restoreDir/update/YYYY-MM-DD/* /opt/fhem/		sudo -su fhem cp -R /opt/fhem/restoreDir/update/YYYY-MM-DD/* /opt/fhem/
	</syntaxhighlight>Die Berechtigungen bleiben durch die Verwendung des Users fhem erhalten. Danach sollte sich FHEM normal starten lassen. Im Zweifelsfall ist ein reboot des ~~System~~ die einfachste Lösung.		</syntaxhighlight>Die Berechtigungen bleiben durch die Verwendung des Users fhem erhalten. Danach sollte sich FHEM normal starten lassen. Im Zweifelsfall ist ein reboot des Systems die einfachste Lösung.

	=== Einzelne Dateien aus dem SVN holen ===		=== Einzelne Dateien aus dem SVN holen ===
	Manchmal wird im Forum die Empfehlung gegeben: Die Fehler bereinigte Datei bitte direkt aus dem SVN holen. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen, hier ein paar Beispiele:<syntaxhighlight lang="perl">		Manchmal wird im Forum die Empfehlung gegeben: Die Fehler-bereinigte Datei bitte direkt aus dem SVN holen. Dies kann mit der Perlfunktion { Svn_GetFile('from SVN Path', 'to local Path') } direkt in der FHEM Kommandozeile erfolgen, hier ein paar Beispiele:<syntaxhighlight lang="perl">
	{ Svn_GetFile('FHEM/DevIo.pm', 'FHEM/DevIo.pm') }		{ Svn_GetFile('FHEM/DevIo.pm', 'FHEM/DevIo.pm') }
	{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }		{ Svn_GetFile('contrib/86_FS10.pm', 'FHEM/86_FS10.pm') }
	{ Svn_GetFile('fhem.cfg', 'minimal.cfg') }		{ Svn_GetFile('fhem.cfg', 'minimal.cfg') }
	</syntaxhighlight>Wie man sieht, kann man sich damit auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!		</syntaxhighlight>Wie man sieht, kann man sich damit auch aktuelle Dateien aus dem SVN contrib Pfad in den lokalen FHEM Pfad holen. Der lokale contrib Pfad wird beim update NICHT aktualisiert und befindet sich damit immer auf dem Stand der Erstinstallation!