Aktualisierung auf Zigbee2MQTT 2.0.0: Tipps und Warnungen

Wenn Sie mich regelmäßig lesen, kennen Sie meinen Standpunkt dazu Aktualisierungen. Ich kann es nicht genug sagen, aber ein Computersystem aktualisieren in der Produktion stellt immer ein Risiko dar. Umso mehr, wenn es um a geht Versionshöheaber eben Kleinere Aktualisierungen sind zu berücksichtigen als Ganzes, um Probleme zu vermeiden.

Seit vielen Wochen steht die Community im Rückstand Zigbee2MQTT Ich spreche gerade über dieses Update. Die Entwickler hatten bereits in früheren Versionen Vorbereitungen für dieses große Versions-Upgrade getroffen, um so gut wie möglich den Boden vorzubereiten und die Risiken zu reduzieren.

Jetzt vor zwei Wochen erschienen, Zigbee2MQTT geht mit einigen Änderungen am Programm auf Version 2 über. Ein größeres Update wird dadurch realisiert, dass die erste Versionsnummer erhöht wird. Hier, Z2M geht von Version 1.42.xx auf Version 2.0.0es handelt sich also um eine Hauptversion.

Im Allgemeinen führt ein größeres Update eines Computerprogramms dazu viele Veränderungen und sehr oft recht tiefgreifende Änderungen im Code. Dies ist bei dieser neuen Version von Zigbee2MQTT der Fall, die eine beeindruckende Anzahl an Änderungen, Korrekturen und Verbesserungen aufweist. Ich lade Sie ein, die Changelog-Seite zu konsultieren, um alles einzusehen.

Dies ist in der Tat ein großes Update, das eine umfassende Codebereinigung, die Entfernung mehrerer aus früheren Versionen übernommener Bibliotheken, eine erhebliche Änderung des OTA-Updatesystems für untergeordnete Geräte und einige andere wichtige Änderungen mit sich bringt. was Auswirkungen haben kann.

Zu nennen sind beispielsweise Veränderungen bei der Interaktion mit dem Hausautomationssystem Home Assistant. Diese Änderungen sollen das Benutzererlebnis und die Z2M-Unterstützung für das Hausautomationssystem verbessern, können jedoch auch zu Problemen während des Updates führen.

Beispielsweise sehen wir in der Konfigurationsdatei neue Parameterzeilen, die sich auf die Legacy-Version beziehen und dem Endbenutzer dabei helfen sollen, einen mehr oder weniger reibungslosen Übergang zu dieser neuen Version zu steuern.

advanced:   homeassistant_legacy_entity_attributes: false   homeassistant_legacy_triggers: false   legacy_api: false   legacy_availability_payload: false device_options:   legacy: false

Führen Sie derzeit keine Aktualisierung in der Produktion durch

Wie Sie sicher verstanden haben, können diese bedeutenden Änderungen Auswirkungen auf das Verhalten Ihrer Hausautomation und insbesondere Ihres Zigbee-Netzwerks haben. Viele haben das Update ausprobiert und festgestellt, dass ihre Zigbee-Geräte nicht richtig funktionieren oder dass Zigbee2MQTT selbst einfach nicht neu startet.

Das ist nicht ungewöhnlich, jedes größere Update birgt Risiken. Sogar auf Systemen lauert noch dieser Mechaniker. Nennen Sie zum Beispiel Microsoft, dem es derzeit schwerfällt, eine 24/7-Veröffentlichung von Windows 11 anzubieten, die nicht zu Mehrfachfehlern in Unternehmen führt …

Aus diesem Grund empfehle ich Ihnen, mit dem Upgrade auf Zigbee2MQTT 2.0.x geduldig zu bleiben. Natürlich ist es möglich, es auszuprobieren, aber unter Beachtung aller notwendigen Vorsichtsmaßnahmen.

Best Practices, die als Reaktion auf dieses Update übernommen werden sollen

Erster offensichtlicher Rat: Erstellen Sie vor jedem Versions-Upgrade Ihre Backups. Auf diese Weise verfügen Sie über eine stabile und funktionsfähige Version, auf die Sie im Falle eines größeren Problems zurückgreifen können. Führen Sie im Fall von Zigbee2MQTT hauptsächlich ein Backup der Konfigurationsdateien sowie der Datenbank durch. Je nach Art der Installation unterscheidet sich die Sicherungsmethode.

Speichern Sie Z2M unter Home Assistant

Unabhängig davon, ob Sie noch eine 2024-Version verwenden oder mit dem neuen Backup-Modus auf die neueste Version von Home Assistant 2025 aktualisiert haben, ist das Prinzip dasselbe. Über das Menü „Einstellungen/System/Backups“ können Sie eine Teilsicherung starten, bei der nur das zusätzliche Zigbee2MQTT-Modul gespeichert wird.

Wenn Sie eine Remote-Version von Zigbee2MQTT verwenden, müssen Sie die Konfiguration manuell speichern, wie in der folgenden Anleitung beschrieben.

So sichern und wiederherstellen Sie ZigBee2MQTT

In dieser Anleitung erklären wir, wie Sie die ZigBee2MQTT-Konfiguration für ein Update oder eine Migration speichern. Tatsächlich kann jedes Update Probleme verursachen und die Konfiguration und die zugehörigen Geräte beeinträchtigen.

Wenn Sie schließlich die Proxmox-Virtualisierung zur Verwaltung von Zigbee2MQTT verwenden, ist es noch einfacher, Sie müssen nur die VM oder den LXC-Container sichern und/oder einen Snapshot erstellen. Auch hier erkläre ich in einer Schritt-für-Schritt-Anleitung, wie es geht.

Bleiben Sie unter Version 1.42.0-2, wenn im Moment alles gut funktioniert

Das Update auf die neue Version 2.0.x von Zigbee2MQTT sollte zunächst in einem Testbereich durchgeführt werden, um die wenigen Auswirkungen zu sehen, die dies für Sie haben könnte, bevor ein Upgrade auf die Produktion in Betracht gezogen wird. Zur Erinnerung: Die letzte stabile Version vor dieser Version 2 ist v1.42.0-2. Ich lade Sie ein, bei dieser Version zu bleiben, wenn bei Ihnen alles gut funktioniert und Ihr Zigbee-Netzwerk stabil ist. Warum ein Upgrade versuchen und in Schwierigkeiten geraten, wenn alles perfekt funktioniert?

Geduld und Serientests

Für mich besteht keine Dringlichkeit, sich auf diese Version zu stürzen, viele Leute haben es versucht und mussten mit mehr oder weniger Problemen einen Rückzieher machen. Andere wagten den Schritt und stießen auf keine oder nur sehr wenige Probleme … Aber auch hier sind alle Installationen unterschiedlich: Der Kontext, das Ökosystem und alle Interaktionen und Konfigurationen, die Sie in Ihrem Hausautomationssystem haben, sind alles Elemente, die unter den Folgen einer solchen Situation leiden können aktualisieren.

Dies hängt auch von der Anzahl der Zigbee-Geräte in Ihrer Installation und der Komplexität Ihrer Installation ab. Ein Zigbee-Netzwerk mit weniger als 10 Geräten kann sich problemlos von Grund auf neu aufbauen, wenn etwas schief geht. Allerdings kann die Neuinstallation einer Installation mit hundert Zigbee-Geräten zu einem Albtraum werden, auch das ist zu bedenken. Und dann muss man auch ein wenig Zeit einplanen, damit man genug Zeit hat, die Dinge wieder in Ordnung zu bringen, falls etwas schief geht.

Daher ist Vorsicht geboten. Es ist besser, ein wenig zu warten und diese neue Version von Experten testen zu lassen, um einige Korrekturen und Verbesserungen zu sehen, bevor man den Schritt wagt. Es ist bereits eine neue Version verfügbar, v2.0.0-2, die ein Problem mit der seriellen Schnittstelle des Raspberry Pi 4 behebt.

Persönlich habe ich mehrere Zigbee2MQTT zu Hause, meine Instanzen in der Produktion bleiben unter Versionen niedriger als 2.0.0, weil es auf diese Weise im Moment sehr gut und mit großer Stabilität funktioniert. Warum also kommen und kaputt machen, was funktioniert? Ich habe in meinem Labor eine Instanz, auf der Zigbee2MQTT 2.0.0 läuft, auf der ich ein wenig herumgespielt habe, aber ehrlich gesagt habe ich nicht genug Zeit, um die Tests voranzutreiben.

Viele von Ihnen haben mich nach dem Update und dem Zusammenbruch Ihres Zigbee2MQTT kontaktiert, daher erschien es mir nützlich und wichtig, diesen kleinen Artikel zu schreiben, um Ihnen einige Ratschläge und Tipps zu diesem Update zu geben. Zögern Sie nicht, uns in den Kommentaren mitzuteilen, ob Sie das Update durchgeführt haben und ob dabei Probleme aufgetreten sind oder ob im Gegenteil alles gut gelaufen ist.