4 Upgrade
Vor dem Upgrade wird dringend empfohlen, alle relevanten Hinweise zum Upgrade zu lesen.
Es ist außerdem hilfreich zu wissen, welche Komponenten Sie aktualisieren müssen.
Übersicht
Schritt-für-Schritt-Anleitungen für das Upgrade sind verfügbar für::
- Red Hat Enterprise Linux (mit Paketen)
- Debian/Ubuntu (mit Paketen)
- Upgrade mit Containern
- Upgrade aus Quellen
Verwandte Anleitungen:
- Für Server in einem Hochverfügbarkeits-Cluster (HA) siehe Upgrade eines HA-Clusters
- Für die TimescaleDB-Datenbank siehe Upgrade des TimescaleDB-Schemas
Zu aktualisierende Komponenten
Die Aktualisierung von Zabbix-Agents wird empfohlen, ist aber nicht zwingend erforderlich.
Die Aktualisierung von Zabbix-Proxys wird dringend empfohlen. Der Zabbix-Server unterstützt Proxys derselben Hauptversion wie der Server vollständig. Der Zabbix-Server unterstützt auch Proxys, die nicht älter sind als die vorherige LTS-Version des Zabbix-Servers, jedoch mit eingeschränkter Funktionalität (Datenerfassung, Ausführung von Remote-Befehlen, sofortigen Datenpunkt-Wertprüfungen). Die Konfigurationsaktualisierung ist ebenfalls deaktiviert, und veraltete Proxys funktionieren nur mit alter Konfiguration.
Proxys, die älter sind als die vorherige LTS-Release-Version des Zabbix-Servers oder neuer als die Major-Version des Zabbix-Servers, werden nicht unterstützt. Der Zabbix-Server ignoriert Daten von nicht unterstützten Proxys, und jede Kommunikation mit dem Zabbix-Server schlägt mit einer Warnung fehl. Weitere Informationen finden Sie unter Versionskompatibilität.
Um Ausfallzeiten und Datenverlust während des Upgrades zu minimieren, wird empfohlen, zuerst den Zabbix-Server zu stoppen, zu aktualisieren und wieder zu starten und anschließend die Zabbix-Proxys nacheinander zu stoppen, zu aktualisieren und wieder zu starten. Während der Ausfallzeit des Servers setzen laufende Proxys die Datenerfassung fort. Sobald der Server wieder läuft, senden veraltete Proxys die Daten an den neueren Server (die Proxy-Konfiguration wird jedoch nicht aktualisiert) und bleiben teilweise funktionsfähig. Benachrichtigungen über Probleme während der Ausfallzeit des Zabbix-Servers werden erst nach dem Start des aktualisierten Servers erzeugt.
Wenn der Zabbix Proxy zum ersten Mal gestartet wird und die SQLite-Datenbankdatei fehlt, erstellt der Proxy sie automatisch.
Beachten Sie, dass der Zabbix Proxy, wenn er SQLite3 verwendet und beim Start erkennt, dass die Version der vorhandenen Datenbankdatei älter ist als erforderlich, die Datenbankdatei automatisch löscht und eine neue erstellt. Daher gehen die in der SQLite-Datenbankdatei gespeicherten Verlaufsdaten verloren. Wenn die Version des Zabbix Proxy älter ist als die Version der Datenbankdatei, protokolliert Zabbix einen Fehler und wird beendet.
Abhängig von der Größe der Datenbank kann das Upgrade der Datenbank auf Version 8.0 lange dauern.
Hinweise zum Upgrade
Ein direktes Upgrade auf Zabbix 8.0.x wird ab Version 2.0.x unterstützt. Informationen zum Upgrade von früheren Versionen finden Sie in der Zabbix-Dokumentation für 2.0 und frühere Versionen.
Bitte beachten Sie, dass nach dem Upgrade einige Integrationen von Drittanbieter-Software in Zabbix beeinträchtigt sein könnten, wenn die externe Software nicht mit der aktualisierten Zabbix-Version kompatibel ist.
Die folgenden Upgrade-Hinweise sind verfügbar:
| Upgrade von | Vollständige Upgrade-Hinweise lesen | Wichtigste Änderungen zwischen den Versionen |
|---|---|---|
| 7.4.x | Für: Zabbix 8.0 |
Erforderliche Mindestversionen der Datenbank wurden angehoben. Erforderliche Mindestversion von PHP wurde von 8.0.0 auf 8.2.0 angehoben. Das Zeichen % wurde zur Liste UnsafeUserParameters für Zabbix Agent und Zabbix Agent 2 hinzugefügt. |
| 7.2.x | Für: Zabbix 7.4 Zabbix 8.0 |
Unterstützung der PCRE-Bibliothek eingestellt. |
| 7.0.x | Für: Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Unterstützung für Oracle DB eingestellt. |
| 6.4.x | Für: Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von PHP wurde von 7.4.0 auf 8.0.0 angehoben. Asynchrone Poller für Agent-, HTTP-Agent-, SNMP walk[OID]- und SNMP get[OID]-Prüfungen. Separate Datenbanktabelle für Proxys. Standardpfad für die Konfigurationsdatei des Windows-Agent geändert. Oracle DB als veraltet markiert. Alter numerischer Werttyp (float) entfernt. |
| 6.2.x | Für: Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von MySQL wurde von 8.0.0 auf 8.0.30 angehoben. Die Bibliothek 'libevent_pthreads' ist für Zabbix Server/Proxy erforderlich. Beim ersten Start nach einem Upgrade verwirft Zabbix Proxy mit SQLite3 automatisch die alte Version der Datenbank (mit dem gesamten Verlauf) und erstellt eine neue. |
| 6.0.x LTS | Für: Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von PHP wurde von 7.2.5 auf 7.4.0 angehoben. Service-Monitoring grundlegend überarbeitet. Deterministische Auslöser müssen während des Upgrades erstellt werden. Wenn binäres Logging für MySQL/MariaDB aktiviert ist, sind dafür Superuser-Rechte oder das Setzen der Variablen/des Konfigurationsparameters log_bin_trust_function_creators = 1 erforderlich. Anweisungen zum Setzen der Variablen finden Sie unter Database creation scripts. |
| 5.4.x | Für: Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversionen der Datenbank wurden angehoben. Server/Proxy startet nicht bei veralteter Datenbank. Audit-Log-Einträge gehen aufgrund einer Änderung der Datenbankstruktur verloren. |
| 5.2.x | Für: Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversionen der Datenbank wurden angehoben. Aggregierte Datenpunkte als separater Typ entfernt. |
| 5.0.x LTS | Für: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von PHP wurde von 7.2.0 auf 7.2.5 angehoben. Der Passwort-Hashing-Algorithmus wurde von MD5 auf bcrypt geändert. |
| 4.4.x | Für: Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Unterstützung für IBM DB2 eingestellt. Erforderliche Mindestversion von PHP wurde von 5.4.0 auf 7.2.0 angehoben. Erforderliche Mindestversionen der Datenbank wurden angehoben. Zabbix-PHP-Dateiverzeichnis geändert. |
| 4.2.x | Für: Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Medientypen Jabber und Ez Texting entfernt. |
| 4.0.x LTS | Für: Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Ältere Proxys können keine Daten mehr an einen aktualisierten Server melden. Neuere Agents können nicht mehr mit einem älteren Zabbix Server arbeiten. |
| 3.4.x | Für: Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Die Bibliotheken 'libpthread' und 'zlib' sind jetzt obligatorisch. Die Unterstützung für das Klartextprotokoll wurde eingestellt, und ein Header ist obligatorisch. Zabbix Agents der Versionen vor 1.4 werden nicht mehr unterstützt. Der Parameter Server in der passiven Proxy-Konfiguration ist jetzt obligatorisch. |
| 3.2.x | Für: Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Unterstützung für SQLite als Backend-Datenbank für Zabbix Server/Frontend eingestellt. Perl Compatible Regular Expressions (PCRE) werden anstelle von erweitertem POSIX unterstützt. Die Bibliotheken 'libpcre' und 'libevent' sind für Zabbix Server obligatorisch. Prüfungen des Exit-Codes wurden für Benutzerparameter, Remote-Befehle und system.run[]-Datenpunkte ohne das Flag 'nowait' sowie für vom Zabbix Server ausgeführte Skripte hinzugefügt. Zabbix Java gateway muss aktualisiert werden, um die neue Funktionalität zu unterstützen. |
| 3.0.x LTS | Für: Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Das Datenbank-Upgrade kann je nach Größe der Verlaufstabelle langsam sein. |
| 2.4.x | Für: Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von PHP wurde von 5.3.0 auf 5.4.0 angehoben. Der Agent-Parameter LogFile muss angegeben werden. |
| 2.2.x LTS | Für: Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Knotenbasiertes verteiltes Monitoring entfernt. |
| 2.0.x | Für: Zabbix 2.2 Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Erforderliche Mindestversion von PHP wurde von 5.1.6 auf 5.3.0 angehoben. Für den ordnungsgemäßen Betrieb des Servers ist eine MySQL-Datenbank mit Groß-/Kleinschreibungssensitivität erforderlich; der Zeichensatz utf8 und die Sortierung utf8_bin sind erforderlich, damit Zabbix Server ordnungsgemäß mit einer MySQL-Datenbank funktioniert. Siehe database creation scripts. Die PHP-Erweiterung 'mysqli' ist anstelle von 'mysql' erforderlich. |