• Drucken

masterinstaller - automatic openhab installation

Openhab automatic setup via textual configuration

Dieses Script bzw. dieser Ansatz soll eine einfache und automatisierte Installation für openhab ermöglichen. Das dann ohne immer wieder das Betriebssystem auf einer PI neu installieren zu müssen. Idee dahinter war ursprünglich eine schnelle und effektive Installation einer Testumgebung. Um eine Testumgebung bereit zu stellen, müssen natürlich die Daten der „produktiven“ Installation übernommen werden (backup).  

Vorbereitung der Umgebung

Damit ein Einlesen und späte die automatische Installation möglich ist, müssen einige Regeln beachtet werden.

a) Jedes .item und jedes .things file hat den Namen z.b. des Binding (der Name ist aber beliebig).

b) Je Binding gibt es einen Ordner mit den Namen „binding-<name>“

c) In den Ordner der jeweiligen Bindings gibt es eine install.bash und eine backup.bash Datei. Dort müssen die Namen der zugehörigen Dateien angegeben werden. Um Ordnung zu schaffen, sollten alle Dateien mit den Namen des Bindings Anfangen. Das bringt dann auch eine gewisse Übersicht über die ggf. vielen Bindings die man nutzt. 

d) Aus dem Verzeichnis /var/lib/openhab/config/org/openhab/addons.config sollte die Datei addons.cfg gesichert bzw. in das Verzeichnis "config" abgelegt werden. Die Datei sieht z.B. so aus:

binding=astro,squeezebox,tr064,avmfritz,modbus,lcn,comfoair,mail,mqtt,network
misc=package=standard
persistence=jdbc-mariadb,rrd4j
service.pid=org.openhab.addons
transformation=xslt,xpath,scale,regex,map,jsonpath,exec,javascript
ui=basic,habpanel,habmin

In meinem Fall nutze ich für die Langzeitspeicherung die Maria DB als persistence. rrd4 ist nur für Daten die ich nicht "ewig" speichern möchte.
e) Analog zur addons.cfg, kann auch die runtime.cfg als Default verteilt werden. Dazu diese auch in das config Verzeichnis ablegen.

f) Auch die Einstellungen für Pages etc. in openhab 3 können "übertragen" werden. Das ist jedoch explizite nicht von openhab supported! Ich habe es getestet und bislang geht es.
Dazu nehmen wir aus dem Ordner /var/lib/openhab/jsondb die Datei uicomponents_ui_page.json mit und packen diese in den Ordner config.

e) Auch die Einstellungen für "habmin" in openhab 3 können "übertragen" werden. Auch das ist nicht von openhab supported! Ich habe es getestet und bislang geht es.
Dazu nehmen wir aus dem Ordner /var/lib/openhab/jsondb die Datei uicomponents_habpanel_panelconfig.json mit und packen diese in den Ordner config.

g) In der Installation wird als persistenz mit MariaDB bzw RRD4 gearbeitet. Dazu wird ein Datenbank mit dem Namen "openhab3" verwendet. Diese kann mit inst-db installiert werden. 

masterinstaller (1-setup.bash)

Diese Datei ist das primäre Script, welches gestartet wird. Ohne Angabe von Parametern, wird nur die Hilfe ausgegeben.

Am besten setzt man über die /etc/profile die beiden folgenden Variablen:

export OPENHAB_SETUP_CONF=/etc/openhab
export OPENHAB_SETUP_SOURCE=/data/install/openhab

Das Verzeichnis "OPENHAB_SETUP_SOURCE" ist das Verzeichnis, wo das Script selbst und die andern Daten "binding-..." usw. liegen

Hier mal ein Stand (März 2023) http://www.berhorst.net/files/openhab-text-install.tgz den Ihr als Grundlage nutzen könnt.