Hallo ioBroker-Community,

nachdem der Beta Test für die neue Version 7.1 ohne weitere Auffälligkeiten verlaufen ist, möchten wir euch heute den neuen Controller im Stable zur Verfügung stellen. Dieser wird im Laufe des Tages im offiziellen Stable Repository verfügbar sein.

❕ Node.js Versions-Anforderungen
Die unterstützten Node.js Versionen sind: 18.x, 20.x, 22.x und 24.x. Die empfohlene Node.js Version für ioBroker ist Stand heute 22.x. Node.js 18.x erreicht in absehbarer Zeit sein End-of-Life – wir empfehlen daher bereits jetzt den Wechsel auf eine aktuellere Version.
Bitte beachtet weiterhin bei Node.js Updates die Anleitung im Forum unter https://forum.iobroker.net/topic/64032/update-nodejs-best-practise-supported-14-16-und-18 !

❗ Informationen zur Version
Hier möchte ich euch als erstes einen Einblick in die für euch relevanten neuen Features geben.

🌟 Feature Spotlight

🆕 Objekt-Warnlimit (Objects Warn Limit)

Das zentrale Feature dieser Version ist das neue Objekt-Warnlimit. Adapter können ungewollt eine sehr große Anzahl an Objekten anlegen – sei es durch einen Fehler oder eine ungünstige Konfiguration. Das belastet die Datenbank und kann die Performance des gesamten Systems beeinträchtigen.

Der js-controller überwacht nun die Anzahl der von einer Instanz angelegten Objekte und warnt, sobald ein definiertes Limit überschritten wird. Das Limit lässt sich pro Instanz konfigurieren, und Adapter-Entwickler können über defaultObjectsWarnLimit einen passenden Standardwert hinterlegen, der bereits bei der Installation greift. So erkennt ihr „durchgegangene" Adapter frühzeitig, bevor sie eure Installation aufblähen.

🆕 Bessere Container-Erkennung (Podman & CRI-O)

Die Docker-/Container-Erkennung (isDocker) wurde erweitert und erkennt nun auch Umgebungen wie Podman und CRI-O über die .containerenv-Datei. Wer ioBroker außerhalb des klassischen Docker-Containers betreibt, profitiert hiervon direkt.

🛠 Weitere Verbesserungen

• adminUI-, adminTab- und adminColumns-Konfigurationen werden beim Adapter-Upload nun korrekt erhalten und nicht mehr fälschlich überschrieben.
• Der adapter-spezifische stopTimeout wird nun in allen Fällen respektiert (statt eines pauschalen Fallbacks von 4 Sekunden) – das sorgt für ein saubereres Herunterfahren langsamer Adapter.
• Für ts- und lc-Felder beim setState werden nun ausschließlich Zahlen akzeptiert.

👩‍💻 Für Entwickler

Ein großer Teil dieser Version betrifft Typing-Verbesserungen, u. a. für visIconSets, smartName in Enums, supportsLoadingMessage, findForeignObject, vis-/vis-2-Widgets, json in adminUI.tab, docker-api sowie externe Authentifizierung für UserCommon. Wer Adapter entwickelt, sollte auf die neueste @iobroker/types-Version aktualisieren.

ℹ Weitere Informationen
Detailliertere Informationen zu allen Änderungen und Features findet Ihr weiter unten und im Changelog. Ich hoffe auch diesmal auf Eure tatkräftige Unterstützung, sodass der Latest-Release dann genau so reibungslos verläuft wie bei den letzten Versionen.

Für die aktive Mitarbeit an dieser Version des js-controller bedanke ich mich diesmal wieder besonders bei Apollon77!

Darüber hinaus ist der js-controller 7.1 generell kompatibel mit allen bestehenden ioBroker-Systemen. Ein Update von der Version 7.0.x ist problemlos und ohne Zwischenschritte möglich.
Solltet ihr noch auf einer älteren Version unterwegs sein, empfehlen wir ein schrittweises Update (3.3.x → 4.0 → 5.0 → 6.0 → 7.0 → 7.1).

💾 Installation

1⃣ VOR der Installation
Wie bei jedem Test dieser Art: Bitte macht ein Backup! iobroker backup bzw. das Kopieren des iobroker-data Verzeichnisses reichen an sich aus. Bitte nicht das node_modules Verzeichnis einfach kopieren, da sonst symbolische Links kaputt gehen können, was zu größeren Problemen danach führt.
Eine alte 7.0.x-Version des js-controller kann im Notfall einfach wieder per npm install iobroker.js-controller@version --omit=dev („version" durch die gewünschte Versionsnummer ersetzen) installiert werden und sollte alles wieder herstellen (Letzter Stable Stand der 7.0er Reihe ist die 7.0.7).

2⃣ Nötige Adapter-Aktualisierungen
Am besten VOR dem js-controller Update alle verfügbaren Adapter-Updates prüfen und alle Updates installieren, die im Changelog auf Optimierungen oder Anpassungen für den js-controller 7.x oder höher hinweisen.
Mit den stable Versionen der jeweiligen Adapter sollten keine Probleme auftreten, falls doch bitte hier melden.

3⃣ Achtung: MASTER/SLAVE-Systeme Reihenfolgen beachten!
Bei einem Multi-Host-System, welches auf js-controller 7.0.x läuft, ist es beim Update auf Version 7.1 empfohlen, zuerst das Master-System zu aktualisieren. Der Master muss dann wieder gestartet werden. Die Slaves werden danach aktualisiert!

Bei Updates von Master/Slave-Systemen mit js-controller 4.x oder früher bitte die jeweiligen Update-Threads der empfohlenen Zwischenversionen prüfen.

4⃣ Windows
Wir empfehlen euch, den Weg über den offiziellen Installer zu nutzen.

Im Zweifel kann das Update manuell via npm installiert werden. Hierzu im ioBroker-Verzeichnis nach dem Stoppen des ioBroker den Befehl npm i iobroker.js-controller@stable ausführen.

4⃣ Linux
Die erste Wahl für Linux-Systeme ist die Aktualisierung über den Admin im Hosts-Tab.
Sollte diese nicht verfügbar sein, bitte folgenden Weg wählen:

• ioBroker stoppen (iobroker stop)
• Prüfen, dass keine Prozesse (Adapter, Backups) mehr laufen (ps auxww|grep io und auch ps auxww|grep backup). Es passiert manchmal, dass trotz dem Stoppen noch Zombies zurückbleiben
• Das Update erfolgt via iob upgrade self
• ioBroker starten (iobroker start)

5⃣ Bei Fehlern:
Wenn bei der Installation Fehler wegen fehlender Zugriffsrechte auftreten, am besten den Installation-Fixer (iob fix) nutzen und die Installation erneut versuchen.

Solche Fehler bitte hier im Thread melden.

6⃣ NACH der Installation
Wenn alles klappt, merkt Ihr außer der höheren Versionsnummer in der Host-Ansicht im Admin keinen Unterschied. Alles funktioniert weiterhin wie vorher. Alle Adapterinstanzen starten und funktionieren. Wenn das so ist, hat alles geklappt.

Falls im Log Warn-Meldungen auftauchen mit dem Hinweis, diese an den Entwickler zu senden, dann bitte schauen, welcher Adapter es ist, und entsprechend dort bitte Issues anlegen!

Was hat sich geändert, was besonders ansehen/beachten?

Speziell die Entwickler sollten sich die neuen Typings sowie das defaultObjectsWarnLimit anschauen. Anwender achten am besten auf eventuelle Warnungen zum Objekt-Limit – das ist ein guter Indikator für einen Adapter, der mehr Objekte anlegt als erwartet.

Hier für Interessierte als Spoiler eine Zusammenfassung des Changelogs 📰:

7.1.2

• Korrigierte Typings
• Standard-Warnlimit für Objekte für Adapter (defaultObjectsWarnLimit)

7.1.1

• Korrigierte Typings
• isDocker unterstützt nun .containerenv (Podman/CRI-O)
• Chai-Tests durch Node-Assert-Tests ersetzt (für Endanwender nicht relevant)

7.1.0

• Objekt-Warnlimit pro Instanz
• Fix: adminUI/adminTab/adminColumns bleiben beim Upload korrekt erhalten
• ts/lc beim setState akzeptieren nur noch Zahlen
• adapter-spezifischer stopTimeout wird konsequent respektiert
• Erzeugung eines JavaScript-Passworts zur Verschlüsselung von Vendor-Skripten
• Zahlreiche neue/erweiterte Typings (visIconSets, smartName, supportsLoadingMessage, findForeignObject, vis/vis-2-Widgets, docker-api u. v. m.)
• Aktualisierte Plugin- und Sentry-Pakete

Wie Fehler melden?

Wer sich unsicher ist, ob ein Fehler vorliegt, sollte am besten hier im Thread das Problem beschreiben. So können wir alle versuchen, das Problem nachzuvollziehen und ggf. einzugrenzen.

Bitte checkt auch die „Known issues Liste" (zweiter Post) mit den Dingen, die aktuell während der Beta bekannt sind und bis zum Stable Release noch angepasst werden.

Sobald ein Fehler auftritt, der in einer Fehlermeldung oder einem Crash mit Fehlerdetails im Log oder auf der Kommandozeile endet, dann dazu am besten direkt ein GitHub-Issue im js-controller Projekt öffnen und zusätzlich hier im Thread posten. Je detaillierter die Angaben im Issue sind (genaue Fehlermeldungen/Logs, Infos zur OS- und Node.js-Umgebung sowie genaue Schritte zur Reproduktion des Problems), umso schneller können wir Fehler einkreisen und beheben.

Bitte postet auch die Ausgabe von iob diag mit rein.

Wir wünschen allen viel Spaß beim Testen und vielen Dank für Eure Unterstützung!

Bluefox