Fronthem Installation: Unterschied zwischen den Versionen

Aus FHEMWiki
(Komplette Überarbeitung im Rahmen des gesamten Themengebiets fronthem/smartVISU)
 
(28 dazwischenliegende Versionen von 11 Benutzern werden nicht angezeigt)
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 ====
----
Die Konfiguration für nginx kann man unter
sudo nano /etc/nginx/sites-enabled/default
vornehmen.


Folgende Konfiguration sollte direkt funktionieren:
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 ==
__TOC__
Die Installation stammt von https://www.domotiga.nl/projects/domotiga/wiki/SmartVISU


'''Download:'''
$ mkdir ~/install
$ cd ~/install
$ wget http://smartvisu.de/download/smartVISU_2.7.zip
$ unzip smartVISU_2.7.zip


'''Installation:'''
== Vorraussetzungen schaffen ==
$ sudo cp -rp smartVISU /var/www/smartvisu
$ cd /var/www/smartvisu
$ sudo chown -R www-data:www-data /var/www/smartvisu


'''Installation überprüfen:'''
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


Beim Aufruf der Seite http://<IP-Adresse>/smartvisu sollte folgende Seite angezeigt werden:
=== cpanmin ===
curl -L https://cpanmin.us | perl - --sudo App::cpanminus


[[Datei:Installation_SmartVISU.png]]
oder
 
sudo apt-get install cpanminus
 
=== WebSocket ===


== Installation Fronthem ==
Folgende Pakete werden benötigt:
curl -L https://cpanmin.us | perl - --sudo App::cpanminus
  sudo cpanm Net::WebSocket::Server
  sudo cpanm Net::WebSocket::Server
oder {{Link2Forum|Topic=47120|Message=388577|LinkText=(Forum)}}
sudo cpan install Net::WebSocket::Server
=== JSON ===
  sudo cpanm 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
  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.
  define <name> fronthem
 
  define <name> fronthemDevice <ip>
== Ersteinrichtung innerhalb von FHEM ==
"Save" nicht vergessen!
 
Näheres dazu findet man auch unter http://www.fhemwiki.de/wiki/Fronthem#Basic_Syntax
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 [[fronthem|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 {{Link2Forum|Topic=52694|Message=445277|LinkText=(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 {{Link2Forum|Topic=38639|Message=313193|LinkText=(Forum)}}.
 
[[Kategorie:fronthem/smartVISU]]

Aktuelle Version vom 26. Juni 2016, 15: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).