Konfiguration des Host- Systems

Ein Host-System in Bezug auf Docker bezieht sich auf das Betriebssystem, auf dem Docker installiert und ausgeführt wird. Es ist der physische oder virtuelle Server, auf dem Docker-Container erstellt, ausgeführt und verwaltet werden.

Info

Für eine Anleitung zur Installation von Docker auf deinem System besuche die Seite https://support.lxlogger.de/docs/how-to/installation-von-docker.

Anlegen der Daten-Verzeichnisse

Für das Speichern der verschiedenen Daten von InfluxDB und Grafana müssen zunächst Verzeichnisse auf dem Host-System angelegt werden. Diese dienen später als sogenannte Volumes, die später von Docker für den Betrieb genutzt werden.

Lege dazu die folgenden Verzeichnisse an, der Speicherort ist dabei dir überlassen:

• ~/docker/lxlogger/lxlogger
• ~/docker/lxlogger/influxdb
• ~/docker/lxlogger/grafana

Wir gehen davon aus, dass du die Verzeichnisse in deinem Home-Verzeichnis, also wie folgt angelegt hast:

• /home/you/docker/ (linux)
• /Users/you/docker/ (macOS)
• C:\Users\you\docker\ (windows)

Kopieren der LxLogger Anwendung

Lade zunächst die Linux Version der LxLogger Anwendung aus unserem Shop herunter. Du findest dieses im Benutzerbereich unter Meine Downloads.

In der Regel kannst du dabei die Linux-Version der LxLogger Anwendung
lxlogger_|edition|_linux_amd64.zip benutzen. Außer bei der Verwendung von Docker auf einem arm-System (z.B. RaspberryPi, Apple M1, ...), solltest du die Datei lxlogger_|edition|_linux_arm.zip benutzen.

Kopiere nun die Datei lxlogger aus dem entpackten Ordner in das Verzeichnis ~/docker/lxlogger/lxlogger (siehe "Anlegen der Daten-Verzeichnisse").

Konfiguration der LxLogger Anwendung

Lade die dir die Vorlage für die LxLogger- Konfigurationsdatei (.lxlogger.toml) herunter und speichere sie unter dem Namen .lxlogger.toml im Verzeichnis ~/docker/lxlogger/lxlogger (siehe "Anlegen der Daten-Verzeichnisse").

Öffne nun die Konfigurationsdatei und ergänze die Angaben für den Host, Benutzer und das Passwort deines Loxone Miniserver's.

Starten der LxLogger Anwendung

Jetzt kann der Docker Container mit der LxLogger Anwendung gestartet werden. Je nach Präferenz bzw. verwendeter Docker Installation kannst du nun den LxLogger starten:

Docker Desktop

Öffne zunächst die Docker Desktop Anwendung und starte die Suche nach dem offiziellen Docker Image für LxLogger: 6fdigital/docker-lxlogger.

Klicke nun auf den Button Run, öffne den Reiter "Optional Settings" und ergänze die entsprechenden Angaben. Unter dem Punkt "Volumes" gibst du nun, auf der linken Seite die Pfade zu den erstellten Daten-Verzeichnissen an, auf der rechten Seite die Werte entsprechend der folgenden Angaben:

Anwendung	Lokaler Pfad	Docker Container Pfad
Lxlogger	zB. ~/docker/lxlogger/lxlogger	/usr/lib/lxlogger
InfluxDB	zB. ~/docker/lxlogger/influxdb	/var/lib/influxdb
Grafana	zB. ~/docker/lxlogger/grafana	/var/lib/grafana

Mit einem Klick auf den Button Run wird nun der LxLogger Docker Container gestartet:

Kommandozeile

Führe den folgenden Befehl auf einer Kommandozeile deines Betriebssystems aus. Bitte passe dabei unbedingt die Pfade zu den Datenverzeichnissen an! (siehe "Anlegen der Daten-Verzeichnisse").

docker run -d \
  --name lxlogger \
  -p 3003:3003 \
  -p 8086:8086 \
  -v |path-to-lxlogger-folder|/:/usr/lib/lxlogger \
  -v |path-to-influx-folder|/:/influxdb/:/var/lib/influxdb \
  -v |path-to-grafana-folder|/:/grafana/:/var/lib/grafana \
  6fdigital/docker-lxlogger:latest

Öffnen und Konfigurieren von Grafana

Du kannst nun Grafana im Browser deiner Wahl aufrufen. Verwende folgenden Link falls du Docker auf deinem aktuellen Gerät betreibst:

http://localhost:3003

Andernfalls passe den Link entsprechend deiner Konfiguration an.

Ermitteln des Namens der Datenbank

Für die Einrichtung der Datenquelle wird die Seriennummer deines Miniservers benötigt. Diese findest du entweder in der Loxone App, im Hauptmenü des Info- Icons des Loxone Miniservers, in der Loxone Config oder mittels folgendem Vorgehen:

Docker Desktop

Öffne Docker Desktop mit der Übersicht der Container. Der zuvor gestartete LxLogger Container sollte nun in der Liste der Container aufgeführt sein. Mit einem Klick gelangst du zu den Details des Conainers.

Klicke nun auf den Reiter "Terminal" und führe den folgenden Befehl aus:

cd /usr/lib/lxlogger && ./lxlogger info

Du findest nun die Seriennummer deines Miniservers in der Ausgabe des Befehls unter dem Punkt [MINISERVER].

Kommandozeile

Für die Ausführung des Befehls auf der Kommandozeile verwende die folgenden Befehle:

# öffnen einer shell im laufenden container
docker exec -w /usr/lib/lxlogger -it |container-name| /bin/bash
# ausführen des lxlogger info befehls
cd /usr/lib/lxlogger && ./lxlogger info

Zugangsdaten

Für den Login bei Grafana verwende folgende Zugangsdaten:

Benutzer	admin
Passwort	admin

Für den Zugriff auf die InlfuxDB beim Einrichten einer Datenquelle in Grafana, verwende folgende Daten:

URL	http://localhost:8086
Benutzer	root
Passwort	root
Datenbank	lxlogger_|miniserver-seriennummer|

Mehr zur Einrichtung der Datenquelle in Grafana findest du unter Konfiguration Grafana