FHEM Installation Windows: Unterschied zwischen den Versionen

Aus FHEMWiki
(Rohfassung)
K (FHEM 6.0)
 
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Baustelle}}
'''{{PAGENAME}}''' beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst möglich.
Hierhin soll der aktualisierte Inhalt von https://fhem.de/HOWTO_Windows.html in Deutsch


'''{{PAGENAME}}''' beschreibt die Windows-Installation von FHEM auf einem Wechseldatenträger (beispielsweise USB-Stick) ohne Eingriffe in die Registrierungsdatenbank. Die Anleitung kann auch für die Installation auf einem internen Windows-Laufwerk genutzt werden. Hierfür wird abschließend zusätzlich die Einrichtung von FHEM als Dienst erklärt.
==Grundinstallation==
===Installation FHEM===
Das aktuelle [https://fhem.de/#Download fhem-X.Y.zip Paket] (momentan fhem-6.0.zip) herunterladen.


Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner <code>f:\my-fhem</code> angelegt.


==Installation FHEM==
Den gesamten Inhalt des Ordners <code>fhem-6.0\fhem-6.0</code> aus dem .zip-Paket nach <code>f:\my-fhem</code> entpacken.  
Das aktuelle [https://fhem.de/#Download fhem-X.Y.tar.gz Paket] (momentan fhem-5.8.tar.gz) herunterladen und entpacken.


Da Windows selbst keine tar.gz-Pakete unterstützt, wird ein separater Entpacker benötigt. Hierzu eignet sich unter anderem das Open Source-Programm [http://7-zip.org/download.html 7-zip].
''Zur Kontrolle:'' In <code>f:\my-fhem</code> befindet sich anschließend unter anderem die Datei <code>fhem.pl</code>.


Für diesen Artikel wurde der im .tar.gz-Paket enthaltene Ordner fhem-5.8 nach <code>f:\fhem-5.8</code> entpackt. Zur Orientierung: In <code>f:\fhem-5.8</code> befindet sich unter anderem die Datei <code>fhem.pl</code>.
===Installation Perl===
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Ordner von FHEM entpacken.  


==Installation Perl==
Hier wurde der Inhalt des Pakets "strawberry-perl-5.24.1.1-32bit-portable.zip" nach <code>f:\my-fhem</code> entpackt.  
Eine aktuelle [http://strawberryperl.com/releases.html Strawberry Perl Portable Edition] herunterladen und im Verzeichnis von FHEM entpacken.  


Hier wurde die Datei "strawberry-perl-5.24.1.1-32bit-portable.zip" nach <code>f:\fhem-5.8</code> entpackt. Zur Orientierung: In <code>f:\fhem-5.8</code> gibt es nun unter anderem ein zusätzliches Verzeichnis <code>perl</code>.
''Zur Kontrolle:'' In <code>f:\my-fhem</code> existiert anschließend unter anderem ein zusätzlicher Ordner <code>perl</code>.


==Start von FHEM==
===Start von FHEM===
Eine Eingabeaufforderung in Windows öffnen, in das zuvor angelegte Verzeichnis wechseln und FHEM starten:
Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln und FHEM starten:
*<code>cd f:\fhem-5.8</code>
*<code>perl\bin\perl fhem.pl fhem.cfg</code>


Nun erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button "Zugriff zulassen" zu beenden.
<syntaxhighlight lang="doscon">
C:\> cd f:\my-fhem
F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg
</syntaxhighlight>


Hinweis: In der Eingabeauffordeung erscheint keine Rückmeldung und das Programm beendet sich nicht, solange FHEM läuft.
Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button {{Taste|Zugriff zulassen}} zu beenden.


==Aufruf des FHEM-Webinterfaces (FHEMWEB)==
''Hinweis:'' In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.
Nun einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und das FHEM unter folgender Adresse aufrufen:
 
===Aufruf des FHEM-Webinterfaces (FHEMWEB)===
Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:


<code>http://localhost:8083/fhem</code>
<code>http://localhost:8083/fhem</code>


Es öffnet sich nun die FHEM-Hauptseite.
Es öffnet sich die FHEM-Hauptseite:
 
[[Datei:ErsteSchritteInFhem01.png]]
 
===Update von FHEM===
FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.  


==Update von FHEM==
Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl
FHEM wird kontinuierlich weiterentwickelt. Daher sollte nun direkt ein Update auf die aktuellen Entwicklungsstand durchgeführt werden. Dazu in der Kommandozeile von FHEM, das ist das rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl


<code>update</code>
<code>update</code>
Zeile 40: Zeile 48:
eingeben und mit {{Taste|Enter}} abschließen.
eingeben und mit {{Taste|Enter}} abschließen.


Nun beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und in die Kommandozeile nur  
Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur  


<code>shutdown</code>
<code>shutdown</code>
Zeile 46: Zeile 54:
gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.
gefolgt von {{Taste|Enter}} zum Beenden von FHEM eingeben.


Nun wieder zur Eingabeaufforderung wechseln. Dort erkennt man, dass FHEM beendet wurde. Nun das aktualsierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von  
Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch {{Taste|Pfeil hoch}} gefolgt von {{Taste|Enter}} oder erneute Eingabe von  
 
<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg</syntaxhighlight>
 
Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und [[Erste Schritte in FHEM]] lädt zum Ausprobieren ein.
 
==Installations-Optionen==
===Installation Win32::SerialPort===
{{Hinweis|Bei den seit 12/2018 veröffentlichten Strawberry Perl Portable Versionen gehört Win32::SerialPort zu den standardmäßig installierten Modulen (siehe jeweils in Release Notes zu Strawberry Perl - List of distributions installed on top of Perl). Dieser Abschnitt ist bei diesen Versionen überflüssig.}}
Für die meisten USB-Gateways (CUL, Z-Wave, EnOcean,..) wird das Modul Win32::SerialPort benötigt. Das Modul sollte erst nach erfolgreicher Windows-Treiberinstallation für das Gateway installiert werden. Zur Modulinstallation sind folgende Befehle in der Eingabeaufforderung von Windows abzusetzen:
 
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> perl\bin\cpan -i Win32::SerialPort
</syntaxhighlight>
 
===Installation von FHEM als Dienst===
''Hinweis:'' Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.
 
FHEM durch Eingabe von <code>shutdown</code> im Befehls-Eingabefeld beenden.
 
Eine Eingabeaufforderung öffnen und fehlende Perl-Module durch folgende Befehle installieren:


<code>perl\bin\perl fhem.pl fhem.cfg</code>
<syntaxhighlight lang="doscon">
F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> perl\bin\cpan -i Win32::Daemon
F:\my-fhem> perl\bin\cpan -i Win32::Console
</syntaxhighlight>


==Installation von FHEM als Dienst==
Eine Eingabeaufforderung als Administrator öffnen und FHEM als Dienst einrichten:
todo


==Wie mache ich als FHEM-Einsteiger weiter?==
<syntaxhighlight lang="doscon">F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg -i</syntaxhighlight>
 
Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.
 
Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem <code>update</code> der Befehl <code>shutdown restart</code> erfolgreich ausgeführt werden.
 
==Wie geht es weiter?==
[[Erste Schritte in FHEM]]
[[Erste Schritte in FHEM]]
[[Kategorie:HOWTOS]]

Aktuelle Version vom 26. Januar 2020, 14:38 Uhr

FHEM Installation Windows beschreibt die Installation von FHEM als portable Software für Windows (keine Eingriffe in die Registrierungsdatenbank). Die Anleitung ist sowohl für die Installation auf einem Wechseldatenträger, zum Beispiel einem USB-Stick, als auch auf einem internen Laufwerk anwendbar. Bei Installation auf einem internen Laufwerk ist die abschließend dargestellte Einrichtung von FHEM als Dienst möglich.

Grundinstallation

Installation FHEM

Das aktuelle fhem-X.Y.zip Paket (momentan fhem-6.0.zip) herunterladen.

Einen neuen Ordner für FHEM anlegen. Für diesen Artikel wurde der Ordner f:\my-fhem angelegt.

Den gesamten Inhalt des Ordners fhem-6.0\fhem-6.0 aus dem .zip-Paket nach f:\my-fhem entpacken.

Zur Kontrolle: In f:\my-fhem befindet sich anschließend unter anderem die Datei fhem.pl.

Installation Perl

Eine aktuelle Strawberry Perl Portable Edition herunterladen und im Ordner von FHEM entpacken.

Hier wurde der Inhalt des Pakets "strawberry-perl-5.24.1.1-32bit-portable.zip" nach f:\my-fhem entpackt.

Zur Kontrolle: In f:\my-fhem existiert anschließend unter anderem ein zusätzlicher Ordner perl.

Start von FHEM

Eine Eingabeaufforderung (cmd) in Windows öffnen, in den zuvor angelegten Ordner wechseln und FHEM starten:

C:\> cd f:\my-fhem
F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg

Jetzt erscheint ein Windows-Sicherheitshinweis, dass die Windows-Firewall den Perl Interpreter blockiert. Für den Zugriff auf FHEM muss eine Firewall-Ausnahme eingerichtet werden. Hierzu ist der Sicherheitshinweis mit dem Button Zugriff zulassen zu beenden.

Hinweis: In der Eingabeaufforderung erscheint keine Rückmeldung und das Programm beendet sich nicht. Die Eingabeaufforderung darf nicht geschlossen werden, so lange FHEM läuft.

Aufruf des FHEM-Webinterfaces (FHEMWEB)

Einen Browser öffnen (Firefox, Chrome und Safari werden empfohlen) und FHEM unter folgender Adresse aufrufen:

http://localhost:8083/fhem

Es öffnet sich die FHEM-Hauptseite:

ErsteSchritteInFhem01.png

Update von FHEM

FHEM wird kontinuierlich weiterentwickelt. Daher sollte direkt ein Update auf den aktuellen Entwicklungsstand durchgeführt werden.

Im Befehls-Eingabefeld von FHEM, das ist das weiße, rechteckige Texteingabefeld rechts neben dem FHEM-Logo, den Befehl

update

eingeben und mit Enter abschließen.

Es beginnt der Update-Prozeß, der eine Weile dauern kann. Den Fortschritt zeigt FHEM an. Am Ende des Update-Prozesses fordert FHEM zu einem "shutdown restart" auf. Dies bitte ignorieren und im Befehls-Eingabefeld nur

shutdown

gefolgt von Enter zum Beenden von FHEM eingeben.

Nun wieder zum Fenster der Eingabeaufforderung wechseln. Das aktualisierte FHEM erneut starten; beispielsweise durch Pfeil hoch gefolgt von Enter oder erneute Eingabe von

F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg

Hiermit ist die Installation von FHEM bereits grundlegend abgeschlossen und Erste Schritte in FHEM lädt zum Ausprobieren ein.

Installations-Optionen

Installation Win32::SerialPort

Info blue.png
Bei den seit 12/2018 veröffentlichten Strawberry Perl Portable Versionen gehört Win32::SerialPort zu den standardmäßig installierten Modulen (siehe jeweils in Release Notes zu Strawberry Perl - List of distributions installed on top of Perl). Dieser Abschnitt ist bei diesen Versionen überflüssig.


Für die meisten USB-Gateways (CUL, Z-Wave, EnOcean,..) wird das Modul Win32::SerialPort benötigt. Das Modul sollte erst nach erfolgreicher Windows-Treiberinstallation für das Gateway installiert werden. Zur Modulinstallation sind folgende Befehle in der Eingabeaufforderung von Windows abzusetzen:

F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> perl\bin\cpan -i Win32::SerialPort

Installation von FHEM als Dienst

Hinweis: Die Einrichtung von FHEM als Dienst erfordert einen automatisch im folgenden Installationsprozeß erstellten Eintrag in der Registrierungsdatenbank.

FHEM durch Eingabe von shutdown im Befehls-Eingabefeld beenden.

Eine Eingabeaufforderung öffnen und fehlende Perl-Module durch folgende Befehle installieren:

F:\my-fhem> PATH=F:\my-fhem\c\bin;F:\my-fhem\perl\bin;%PATH%
F:\my-fhem> perl\bin\cpan -i Win32::Daemon
F:\my-fhem> perl\bin\cpan -i Win32::Console

Eine Eingabeaufforderung als Administrator öffnen und FHEM als Dienst einrichten:

F:\my-fhem> perl\bin\perl fhem.pl fhem.cfg -i

Im Windows-Verwaltungswerkzeug "Dienste" wird der FHEM-Dienst nach erfolgreicher Einrichtung mit dem Namen "fhem server" aufgeführt. FHEM startet nach Installation als Dienst beim Windows-Start unsichtbar (ohne offene Eingabeaufforderung) im Hintergrund.

Anders als beim Start von FHEM über die Eingabeaufforderung kann bei FHEM als Dienst nach einem update der Befehl shutdown restart erfolgreich ausgeführt werden.

Wie geht es weiter?

Erste Schritte in FHEM