Zwar gibt es massig Installationsanleitungen, allerdings hab ich jetzt schon mehrere Anfragen zu meinem Beitrag „Amazon Echo zieht ein“ bekommen, wie die HA-Bridge denn nun auf einem Raspberry installiert wird. Daher habe ich eine kleine Installationsroutine gebastelt und eine Kurzsanleitung. Dabei ist zu beachten, dass ich aktuell nicht auf Sonderlocken eingehe, wie ein vorhandener Apache. Es wird einfach nur die HA-Bridge installiert.

Port 81 habe ich verwendet, da ich den Port 80 gerne frei halte. Ihr könnt das Script natürlich auf Eure Anforderungen anpassen.

Die Anleitung basiert auf der originalen Anleitung von HA-Bridge. Programm und Anleitung findet Ihr hier: https://github.com/bwssytems/ha-bridge

Verbindet Euch auf die Shell mit dem User Pi (z.B. mit der Software Putty). Ab da an bitte folgende Befehle ausführen…

Vorbereitung: Java Installation prüfen

Zum ausführen der HA-Bridge ist Java notwendig. Daher prüft erstmal ob Ihr Java installiert habt:

java -Version

Sollte hier ein Fehler erscheinen, dann bitte folgende Befehle ausführen:

sudo apt-get update && sudo apt-get install oracle-java8-jdk

HA-Bridge automatisch installieren

Wie oben erwähnt, habe ich eine kleine Installationsroutine geschrieben. Dabei wird die HA-Bridge ins Verzeichnis /home/pi/habridge in der Version 4.1.4 installiert. Der Service wird automatisch erstellt und auch für den Start beim booten aktiviert. Der Webserver läuft auf Port 81. Alle diese Angaben sind simpel in der Datei editierbar.

Bei mir funktioniert es, aber ich gebe keine Garantien 😉 Die Version ist aktuell auf 4.1.4 ausgelegt, wollt Ihr eine neue Version, müsst Ihr das Script dementsprechend anpassen. Hier könnt Ihr die Datei downloaden: Download automatisches Installationscript

Bitte beachten: Die Installation ist zwingend mit sudo auszuführen, ansonsten reichen die Berechtigungen nicht!

Ihr könnt natürlich besser den Download direkt unter dem Raspberry ausführen. Hier eine kleine Anleitung:

cd /tmp/
wget https://splittscheid.de/wp-content/uploads/2017/02/habridge_install.sh.gz
gunzip habridge_install.sh.gz
sudo bash habridge_install.sh

HA-Bridge manuell installieren

Führt folgende Schritte aus um die HA-Bridge zu installieren und ladet bitte die aktuelle Version:

mkdir ~/habridge
cd ~/habridge
wget https://github.com/bwssytems/ha-bridge/releases/download/v4.1.4/ha-bridge-4.1.4.jar
ln -s ha-bridge-4.1.4.jar ha-bridge.jar

Um diese als Systemdienst zu aktivieren sind folgende Schritte notwendig:

sudo vi /etc/systemd/system/habridge.service

Tragt in die Datei folgenden Code ein, wobei Ihr hier selber einen Port definieren könnt (hier Port 81) und flexibel seid, da ein Update über den Link oben ganz einfach möglich ist:

[Unit]
Description=HA Bridge
Wants=network.target
After=network.target

[Service]
Type=simple

ExecStart=/usr/bin/java -jar -Dserver.port=81 -Dconfig.file=/home/pi/habridge/data/habridge.config /home/pi/habridge/ha-bridge.jar

[Install]
WantedBy=multi-user.target

Jetzt seid Ihr schon fast fertig. Ladet mit dem folgenden Befehl die System Control neu

sudo systemctl daemon-reload

und startet (mit dem Wort stop könnt Ihr den Dienst stopen, bzw. mit restart neu starten) mit folgendem Befehl

sudo systemctl start habridge.service

HA-Bridge automatisch starten

Damit die HA-Bridge direkt beim booten gestartet werden kann, ist folgender Befehl auszuführen:

sudo systemctl enable habridge.service

Das Ganze kann mit disable auch wieder rückgängig gemacht werden. Ich hatte zwar eine Fehlermeldung bekommen, aber es funktioniert alles einwandfrei.

Sonstige Hilfen

Das Logfile findet Ihr hier:

/var/log/syslog

Um zu prüfen, ob der Prozess gestartet ist führt folgenden Befehl aus:

ps -ef | grep habridge.jar | grep -v grep