isardomains / openhab-grafana-influxdb-chronograf

YAML Datei für Docker um openHAB in Verbindung mit Grafana (verwendet InfluxDB) und dem ZigBee USB-Gateway von Dresden-Elektronik (conBee2) auf einen Raspberry Pi 3 auszuführen. Alle Applikationen laufen jeweils einzeln in einem eigenen Container, alle Daten werden auf dem Host gespeichert.

openhab-grafana-influxdb-chronograf-deConz

docker-compose Datei welche die folgenden Applikationen jeweils in einem eigenen Container startet:

• openHAB (Home Automation Software)
• Grafana (Analyse & Monitoring von gespeicherten Werten aus openHAB2)
• InfluxDB (Datenbankapplikation auf die Grafana zugreift)
• Chronograf (Datenbankmonitoring für InfluxDB)
• deConz (ZigBee USB-Gateway conBee2 von Dresden-Elektronik)

Alle Daten aus den Applikationen werden ausserhalb der Container, direkt auf dem Raspberry Pi, gespeichert. Damit sind sie persistent.

Voraussetzungen

Folgende Voraussetzungen sollten gegeben sein um die Container zu starten:

• Raspberry Pi 3 (Model B) mit Raspbian Image (https://www.raspberrypi.org/downloads/raspbian/)
• Zugriff auf den RasPi via SSH und FTP mit einem User mit Root-Rechten
• docker muss installiert sein (https://www.docker.com/blog/happy-pi-day-docker-raspberry-pi/) und als Service bei Systemstart geladen werden (sudo systemctl enable docker.service && sudo systemctl start docker.service)
• docker-compose muss installiert sein
• Optional: Portainer zur einfachen Verwaltung und Kontrolle der Docker-Container installieren.

Installation

Zur Vereinfachung befinden sich sämtliche Dateien - sowohl die YAML Datei als auch alle Container Mappings (siehe unten) - in einem Verzeichnis auf dem RasPi: /opt/smarthome

1. Login auf den RasPi per SSH.
2. Verzeichnis anlegen: sudo mkdir /opt/smarthome/
3. Den Ordner docker-compose dieses Projektes in das Verzeichnis kopieren:
   • cd /tmp/
   • sudo git clone https://github.com/IsarDomains/openhab-grafana-influxdb-chronograf.git
   • sudo cp -r /tmp/openhab-grafana-influxdb-chronograf/docker-compose /opt/smarthome/

Mapping der Containerinhalte

Damit nach dem Abräumen der Container die darin angelegten Daten auch nach einem Neustart wieder verfügbar sind, werden die Datenverzeichnisse der einzelnen Container auf gleichnamige Verzeichnisse des RasPi unter /opt/smarthome gemappt. Diese müssen angelegt werden:

• openHAB2: sudo mkdir /opt/smarthome/openhab
• Grafana: sudo mkdir /opt/smarthome/grafana
• InfluxDB: sudo mkdir /opt/smarthome/influxdb
• Chronograf: sudo mkdir /opt/smarthome/chronograf
• deCONZ: sudo mkdir /opt/smarthome/deconz

So sollte das /opt/smarthome Verzeichnis am Ende aussehen, wenn alle Ordner vorhanden sind:

Starten der Container

Der folgende Befehl führt die Befehle in der YAML Datei aus und startet die Container:

docker-compose -f /opt/smarthome/docker-compose/docker-compose.yml up

Das dauert etwas, da die Images für openHAB2, Grafana, InfluxDB und Chronograf erst heruntergeladen werden müssen. Für alle Images wird der Tag :latest verwendet.

Sollte optional Portainer auf dem RasPi laufen, kann man hierüber einfach nachschauen, ob alle Images bereits gestartet sind. Ist dies der Fall, schaut es in der Portainer Oberfläche im Bereich Container ungefähr so hier aus:

Login

Die einzelnen Web-Logins erreicht ihr über die gemappten Standardports der jeweiligen Applikationen:

• openHAB2: http://<ip_des_raspi>:8080
• deConz: http://<ip_des_raspi>:8085
• Grafana: http://<ip_des_raspi>:3000
• Chronograf: http://<ip_des_raspi>:8888
• InfluxDB: http://<ip_des_raspi>:8086 Achtung: Diese IP wird nun beim Aufsetzten der Datenbank in Chronograf benötigt.

openhab-grafana-influxdb-chronograf's Issues

ERROR: Couldn't find env file: /opt/smarthome/docker-compose/chronograf.env

hi,
I get the following error:
ERROR: Couldn't find env file: /opt/smarthome/docker-compose/chronograf.env

can you please commit the missing file ?
Rgds,
Andreas

Bilder Dokumentation

Portainer Oberfläche:

Verzeichnisstruktur auf dem RasPi: