Fortgeschritten

Wie komme ich an eine Beta-Version?

Manchmal wird man gebeten, eine Version zu testen, die im Repository noch nicht auftaucht. Meist ist damit die Beta-Version eines Adapters gemeint.

!> Für ein System, das zuverlässig laufen soll, ist das Beta-Repository nichts. Die Versionen dort sind noch nicht fertig getestet, und ein Zurück ist Handarbeit.

Der bessere Weg: nur einen einzelnen Adapter

Seit Admin 5 muss dafür nicht mehr das ganze Repository umgestellt werden:

• Den Expertenmodus einschalten. Das Zeichen unten links in der Menüleiste.
• Im Reiter Adapter auf Installieren aus eigener Quelle gehen (das Symbol mit dem Octocat).
• Im Reiter Von npm den gewünschten Adapter auswählen und installieren.

Alle übrigen Adapter kommen weiterhin aus stable.

Das ganze Repository umstellen

Falls es doch einmal nötig ist: In den Systemeinstellungen im Reiter Repositories in der Spalte Aktiv auf beta umschalten.

Danach im Reiter Adapter die Liste neu einlesen. Ist beta aktiv, erscheint dort eine Warnung. Die ist Absicht und erinnert daran, wieder zurückzustellen.

Ausführlich: Was ist ein Repository?

Wie schalte ich eine Instanz auf Debug?

Im Reiter Instanzen die Detailzeile der Instanz aufklappen und auf die Log-Stufe klicken. Im Dialog auf Debug stellen:

Die Einstellung wird dauerhaft gespeichert. Ohne das Häkchen bei Ohne Neustart startet die Instanz neu. Das ist meistens gewollt, denn erst danach protokolliert sie den vollständigen Ablauf von Anfang an.

Anschließend die Aktion auslösen, die den Fehler erzeugt, und in den Protokollen nachsehen.

!> Nach der Fehlersuche wieder auf Info zurückstellen.

?> Für eine Fehlermeldung im Forum oder auf GitHub gehört der Auszug aus der heruntergeladenen Protokolldatei dazu, nicht ein Bildschirmfoto der Liste. In der Anzeige werden lange Zeilen abgeschnitten.

Wie installiere ich einen Adapter von GitHub?

!> Nur, wenn ein Entwickler ausdrücklich darum bittet. Was auf GitHub liegt, ist Arbeitsstand und kann zwischenzeitlich unbrauchbar sein. Abhängigkeiten werden bei dieser Installationsart nicht geprüft.

• Den Expertenmodus einschalten.
• Im Reiter Adapter auf Installieren aus eigener Quelle gehen.
• In den Reiter Von GitHub wechseln und den Adapter auswählen.

Der Reiter Benutzerdefiniert nimmt eine beliebige Adresse entgegen, etwa einen bestimmten Zweig oder das Repository eines fremden Entwicklers. Aus Datei installiert ein lokal vorliegendes Paket.

Wieder zurück

Ein Adapter, der von GitHub kam, wird durch das nächste Update aus dem Repository nicht automatisch ersetzt. Seine Versionsnummer ist meist höher als die offizielle. Zurück geht es über Eine bestimmte Version installieren auf der Rückseite der Adapterkachel.

Sollte ich ein Backup machen? Wovon?

Ja, und zwar bevor etwas passiert, nicht danach.

ioBroker bringt dafür den Adapter BackItUp mit, im Admin unter dem Menüpunkt Backup. Er sichert die beiden Datenbanken (Objekte und Zustände), die Konfiguration und auf Wunsch auch die Daten angebundener Systeme, eine HomeMatic-CCU, Grafana, InfluxDB, die Skripte des javascript-Adapters.

Sinnvoll ist:

• ein täglicher automatischer Lauf,
• die Ablage außerhalb des ioBroker-Rechners (NAS, Netzlaufwerk, Cloud),
• und mindestens einmal ein Rückspieltest. Ein Backup, das noch nie zurückgespielt wurde, ist eine Vermutung.

Ein Backup gehört außerdem vor jedes größere Update, besonders vor einem Update des js-controllers oder einem Wechsel der Node.js-Hauptversion.

Ausführlich: Backup

Wie richte ich ein eigenes SSL-Zertifikat ein?

Die Zertifikate liegen zentral in den Systemeinstellungen im Reiter Zertifikate und werden von admin, web, simple-api und socketio benutzt.

Ab Werk sind defaultPrivate und defaultPublic eingetragen. Die sind in jeder ioBroker-Installation gleich und damit nicht sicher. Sie verschlüsseln zwar, aber prüfen lässt sich damit nichts.

Drei Wege zu einem eigenen Zertifikat:

• Selbst erzeugt: reicht im eigenen Netz, der Browser warnt aber jedes Mal.
• Let's Encrypt: kostenlos und automatisch erneuert, braucht aber eine von außen erreichbare Adresse und Port 80. Einzurichten im gleichnamigen Reiter.
• Gekauft: als Datei hinterlegen oder den Pfad angeben.

!> Ein neues Zertifikat zuerst mit dem web-Adapter ausprobieren, nicht mit dem Admin. Sonst sperrt man sich unter Umständen selbst aus.

?> Wer nur von unterwegs auf ioBroker zugreifen möchte, braucht das alles nicht: Der iot-Adapter kommt ohne offene Ports und ohne eigenes Zertifikat aus.

Was ist Redis, und ab wann lohnt sich das?

ioBroker führt zwei Datenbanken: eine für die Objekte (die Struktur) und eine für die Zustände (die Werte). Voreingestellt ist für beide jsonl, eine Datei, die im Betrieb im Arbeitsspeicher gehalten wird.

Redis ist eine Alternative für die Zustände. Sie lohnt sich, wenn viele Werte sehr häufig wechseln, als grobe Marke ab einigen tausend Zuständen mit reger Änderung, oder wenn memRss des js-controllers auffällig wächst.

Zu beachten:

• Redis muss persistiert werden, sonst sind die Zustände nach einem Neustart weg.
• Das Backup muss Redis mit einschließen. BackItUp kann das.
• Für Objekte bleibt in aller Regel jsonl die bessere Wahl.

Für eine normale Hausinstallation ist die Voreinstellung völlig ausreichend. Wer umstellt, ohne ein Problem zu haben, holt sich meist nur eine zusätzliche Fehlerquelle.

Ausführlich: Redis

Was ist ein Multihost-System?

Mehrere Rechner, die zusammen eine ioBroker-Installation bilden. Einer ist der Master: bei ihm liegen die beiden Datenbanken. Die übrigen Hosts holen sich die Daten von dort und führen nur ihre eigenen Instanzen aus.

Sinnvoll ist das vor allem aus zwei Gründen:

• Räumlich: ein zweiter Rechner steht dort, wo der Funkstick hingehört.
• Lastverteilung: rechenintensive Adapter laufen auf eigener Hardware.

Verwaltet wird alles über den Admin des Masters; im Reiter Instanzen lässt sich nach Host filtern, im Reiter Hosts steht jeder Rechner mit seinen Werten.

!> Der Master ist der einzelne Punkt, an dem alles hängt. Fällt er aus, steht das ganze System. Ein Multihost-Aufbau macht die Installation nicht ausfallsicherer, sondern zunächst nur größer.

Ausführlich: Multihost