Fronthem Installation: Unterschied zwischen den Versionen

Aktuelle Version vom 26. Juni 2016, 16:22 Uhr

Dieser Artikel befasst sich mit der Installation von "fronthem". Es stellt ein Interface zur Verfügung, um ein Webfrontends wie z.B. smartVISU an FHEM anzubinden. Die Konfiguration und das Interface selbst sind im Hauptartikel von fronthem beschrieben.

Alle Artikel zur Thematik fronthem/smartVISU sind hier kategorisiert.

Vorraussetzungen schaffen

In Abhängigkeit der verwendeten Distribution gibt es mehrere Möglichkeiten, die einzelnen Pakete zu installieren (Forum). Für einige Installationsschritte ist das Paket build-essential, dass über diesen Befehlt installiert werden kann. Sonst können die make's während der folgenden Schritte nicht ausgeführt werden (Forum).

sudo apt-get install build-essential

cpanmin

curl -L https://cpanmin.us | perl - --sudo App::cpanminus

oder

sudo apt-get install cpanminus

WebSocket

sudo cpanm Net::WebSocket::Server

oder (Forum)

sudo cpan install Net::WebSocket::Server

JSON

sudo cpanm JSON

oder

sudo cpan install JSON

oder falls es Probleme mit CPAN und Debian z.B. auf dem RPi gibt, kann man JSON auch über die normale Paketverwaltung installieren (Forum):

sudo apt-get install libjson-perl

Module herunterladen

Mit folgendem Befehl kann man fronthem installieren / updaten (in Eingabezeile von FHEM eingeben):

update force https://raw.githubusercontent.com/herrmannj/fronthem/master/controls_fronthem.txt

Durch die Option force werden bei erneutem Aufruf auch erneut alle Dateien heruntergeladen und das Update so erzwungen.

Ersteinrichtung innerhalb von FHEM

Die Konfiguration von fronthem in FHEM (Eingabe in der Fhem Web Kommandozeile):

define <Name Webservice> fronthem

define <Name Endgerät> fronthemDevice <IP Endgerät>

Beispiel:

define meinfronthem fronthem

define meiniphone fronthemDevice 192.168.178.25

Näheres zur Einrichtung und Konfiguration innerhalb von FHEM findet sich im Hauptartikel von fronthem.

Troubleshooting

Fehler bei Installation von WebSocket

Zum einen ist für die Installation das Paket build-essential notwendig, dass z.B. über folgenden Befehl installiert werden kann:

sudo apt-get install build-essential

Darüber hinaus muss die Konfiguration des Netzwerk-Interfaces korrekt und vollständig sein (Forum).

Port 2121 belegt

Ist der Port 2121 bereits durch einen anderen Dienst belegt, z.B. ein OWS Server, gibt es beim Versuch den Websocketserver zu starten eine Fehlermeldung (Forum).

@@ Zeile 1: / Zeile 1: @@
+{{SEITENTITEL:fronthem Installation}}
-Einen Überblick über Fronthem findet man auf der Seite zu [[Fronthem|Fronthem]]
+Dieser Artikel befasst sich mit der Installation von "fronthem". Es stellt ein Interface zur Verfügung, um ein Webfrontends wie z.B. [[smartVISU]] an FHEM anzubinden. Die Konfiguration und das Interface selbst sind im [[fronthem|Hauptartikel von fronthem]] beschrieben.
-== Allgemein ==
+Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU|hier]] kategorisiert.
-=== Fhem ===
-Ein lauffähiges Fhem mit einem aktuellen Update sollte installiert sein.
-=== Webserver ===
-Für smartVISU muss ein Webserver (z.B. Apache oder nginx) installiert sein.
-==== nginx ====
+----
-Folgende Pakete werden benötigt:
- $ apt-get install nginx php5-fpm
-Die Konfiguration für nginx kann man unter
- sudo nano /etc/nginx/sites-enabled/default
-vornehmen.
-Folgende Konfiguration sollte direkt funktionieren:
+__TOC__
- server {
- listen 80;
- root /var/www;
- index index.html index.php;
- server_name localhost;
- location / {
- try_files $uri $uri/ /index.php?$args;
- }
- location ~ \.php$ {
- try_files $uri =404;
- fastcgi_pass unix:/var/run/php5-fpm.sock;
- fastcgi_index index.php;
- fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
- include fastcgi_params;
- }
- }
-== Installation smartVISU ==
-Die Installation stammt aus Jörg Herrmanns git-Repo: https://github.com/herrmannj/smartvisu-cleaninstall
-Folgende Pakete werden benötigt:
+== Vorraussetzungen schaffen ==
- $ apt-get install git
-Hierbei handelt es sich um das original smartVISU inkl. diverser Anpassungen (fhem-Treiber, ...).
+In Abhängigkeit der verwendeten Distribution gibt es mehrere Möglichkeiten, die einzelnen Pakete zu installieren {{Link2Forum|Topic=38639|Message=309479|LinkText=(Forum)}}. Für einige Installationsschritte ist das Paket build-essential, dass über diesen Befehlt installiert werden kann. Sonst können die make's während der folgenden Schritte nicht ausgeführt werden {{Link2Forum|Topic=30909|Message=235986|LinkText=(Forum)}}.
+ sudo apt-get install build-essential
-'''Download:'''
+=== cpanmin ===
-  $ mkdir ~/install
+  curl -L https://cpanmin.us | perl - --sudo App::cpanminus
- $ cd ~/install
- $ git clone https://github.com/herrmannj/smartvisu-cleaninstall.git
-'''Installation:'''
- $ sudo cp -rp smartVISU /var/www/smartvisu
- $ cd /var/www
- $ sudo chown -R www-data:www-data smartvisu
-'''Installation überprüfen:'''
+oder
-Beim Aufruf der Seite http://<IP-Adresse>/smartvisu sollte folgende Seite angezeigt werden:
+ sudo apt-get install cpanminus
-[[Datei:Installation_SmartVISU.png]]
+=== WebSocket ===
-== Installation Fronthem ==
-Folgende Pakete werden benötigt:
- curl -L https://cpanmin.us | perl - --sudo App::cpanminus
   sudo cpanm Net::WebSocket::Server
+oder {{Link2Forum|Topic=47120|Message=388577|LinkText=(Forum)}}
+ sudo cpan install Net::WebSocket::Server
+=== JSON ===
   sudo cpanm JSON
+oder
+ sudo cpan install JSON
+oder falls es Probleme mit CPAN und Debian z.B. auf dem RPi gibt, kann man JSON auch über die normale Paketverwaltung installieren {{Link2Forum|Topic=30909|Message=237576|LinkText=(Forum)}}:
+ sudo apt-get install libjson-perl
-Mit folgendem Befehl kann man Fronthem installieren / updaten:
+== Module herunterladen ==
+Mit folgendem Befehl kann man fronthem installieren / updaten (in Eingabezeile von FHEM eingeben):
   update force https://raw.githubusercontent.com/herrmannj/fronthem/master/controls_fronthem.txt
-Konfiguration von Fronthem in Fhem  (Eingabe in der Fhem Web Kommandozeile):
+Durch die Option <code>force</code> werden bei erneutem Aufruf auch erneut alle Dateien heruntergeladen und das Update so erzwungen.
+== Ersteinrichtung innerhalb von FHEM ==
+Die Konfiguration von fronthem in FHEM (Eingabe in der Fhem Web Kommandozeile):
   define <Name Webservice> fronthem
-  define <Name Endgerät> fronthemDevice <ip>
+  define <Name Endgerät> fronthemDevice <IP Endgerät>
 Beispiel:
   define meinfronthem fronthem
   define meiniphone fronthemDevice 192.168.178.25
-"Save" nicht vergessen!
+Näheres zur Einrichtung und Konfiguration innerhalb von FHEM findet sich im [[fronthem|Hauptartikel]] von fronthem.
-Näheres dazu findet man auch unter http://www.fhemwiki.de/wiki/Fronthem#Basic_Syntax
+==Troubleshooting==
+=== Fehler bei Installation von WebSocket ===
+Zum einen ist für die Installation das Paket build-essential notwendig, dass z.B. über folgenden Befehl installiert werden kann:
+ sudo apt-get install build-essential
+Darüber hinaus muss die Konfiguration des Netzwerk-Interfaces korrekt und vollständig sein {{Link2Forum|Topic=52694|Message=445277|LinkText=(Forum)}}.
+=== Port 2121 belegt ===
-== Verbindung smartVISU mit Fhem ==
+Ist der Port 2121 bereits durch einen anderen Dienst belegt, z.B. ein OWS Server, gibt es beim Versuch den Websocketserver zu starten eine Fehlermeldung {{Link2Forum|Topic=38639|Message=313193|LinkText=(Forum)}}.
-TODO
-== Bekannte Probleme ==
+[[Kategorie:fronthem/smartVISU]]
-TODO