1 Upgrade aus den Quellen

Übersicht

Dieser Abschnitt beschreibt die erforderlichen Schritte für ein erfolgreiches Upgrade von Zabbix 6.4.x auf Zabbix 7.0.x mithilfe offizieller Zabbix-Quellen.

Lesen Sie vor dem Upgrade unbedingt die relevanten Upgrade-Hinweise!

Möglicherweise möchten Sie auch die Anforderungen für 7.0 prüfen.

Es kann hilfreich sein, während des Upgrades zwei parallele SSH-Sitzungen auszuführen: In einer führen Sie die Upgrade-Schritte aus, während Sie in der anderen die Protokolle des Servers/Proxys überwachen. Führen Sie beispielsweise in der zweiten SSH-Sitzung tail -f zabbix_server.log oder tail -f zabbix_proxy.log aus, um die neuesten Protokolleinträge und mögliche Fehler in Echtzeit anzuzeigen. Dies kann für Produktivinstanzen entscheidend sein.

Server-Aktualisierungsprozess

1 Server stoppen

Stoppen Sie den Zabbix Server, um sicherzustellen, dass keine neuen Daten in die Datenbank eingefügt werden.

2 Sichern Sie die vorhandene Zabbix-Datenbank

Dies ist ein sehr wichtiger Schritt.
Stellen Sie sicher, dass Sie über eine Sicherungskopie Ihrer Datenbank verfügen.
Sie hilft Ihnen, wenn das Upgrade-Verfahren fehlschlägt (z. B. aufgrund von unzureichendem Speicherplatz, eines Stromausfalls oder eines unerwarteten Problems).

3 Konfigurationsdateien, PHP-Dateien und Zabbix-Binärdateien sichern

Erstellen Sie eine Sicherungskopie der Zabbix-Binärdateien, Konfigurationsdateien und des Verzeichnisses mit den PHP-Dateien.

4 Neue Server-Binärdateien installieren

Verwenden Sie diese Anweisungen, um den Zabbix-Server aus den Quellen zu kompilieren.

5 Konfigurationsparameter des Servers überprüfen

Lesen Sie unbedingt die Hinweise zum Upgrade, um zu prüfen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Informationen zu neuen optionalen Parametern finden Sie auf der Seite Was ist neu?.

6 Neue Zabbix-Binärdateien starten

Starten Sie die neuen Binärdateien. Prüfen Sie die Protokolldateien, um sicherzustellen, dass die Binärdateien erfolgreich gestartet wurden.

Der Zabbix Server aktualisiert die Datenbank automatisch. Beim Start meldet der Zabbix Server die aktuelle (obligatorische und optionale) sowie die erforderliche Datenbankversion. Wenn die aktuelle obligatorische Version älter als die erforderliche Version ist, führt der Zabbix Server automatisch die erforderlichen Patches zur Datenbankaktualisierung aus. Der Start und der Fortschritt (in Prozent) der Datenbankaktualisierung werden in die Protokolldatei des Zabbix Servers geschrieben. Nach Abschluss der Aktualisierung wird die Meldung „database upgrade fully completed“ in die Protokolldatei geschrieben. Wenn einer der Aktualisierungspatches fehlschlägt, wird der Zabbix Server nicht gestartet. Der Zabbix Server wird ebenfalls nicht gestartet, wenn die aktuelle obligatorische Datenbankversion neuer als die erforderliche Version ist. Der Zabbix Server wird nur gestartet, wenn die aktuelle obligatorische Datenbankversion der erforderlichen obligatorischen Version entspricht.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Bevor Sie den Server starten:

  • Stellen Sie sicher, dass der Datenbankbenutzer über ausreichende Berechtigungen verfügt (Tabelle erstellen, Tabelle löschen, Index erstellen, Index löschen).
  • Stellen Sie sicher, dass ausreichend freier Speicherplatz vorhanden ist.
7 Neue Zabbix-Frontend installieren

Die mindestens erforderliche PHP-Version ist 8.0.0. Aktualisieren Sie sie bei Bedarf und befolgen Sie die Installationsanweisungen.

8 Cookies und Cache des Webbrowsers löschen

Nach dem Upgrade müssen Sie möglicherweise die Cookies und den Cache des Webbrowsers löschen, damit das Zabbix-Webinterface ordnungsgemäß funktioniert.

Proxy-Aktualisierungsprozess

1 Proxy stoppen

Zabbix Proxy stoppen.

2 Konfigurationsdateien und Zabbix-Proxy-Binärdateien sichern

Erstellen Sie eine Sicherungskopie der Zabbix-Proxy-Binärdatei und der Konfigurationsdatei.

3 Neue Proxy-Binärdateien installieren

Verwenden Sie diese Anweisungen, um den Zabbix Proxy aus den Quellen zu kompilieren.

4 Proxy-Konfigurationsparameter überprüfen

Lesen Sie unbedingt die Hinweise zum Upgrade, um zu prüfen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Informationen zu neuen optionalen Parametern finden Sie auf der Seite Was ist neu?.

5 Neuen Zabbix Proxy starten

Starten Sie den neuen Zabbix Proxy. Prüfen Sie die Protokolldateien, um festzustellen, ob der Proxy erfolgreich gestartet wurde.

Der Zabbix Proxy aktualisiert die Datenbank automatisch. Die Datenbankaktualisierung erfolgt ähnlich wie beim Starten des Zabbix Servers.

Agent-Upgradeprozess

Das Upgrade von Agents ist nicht obligatorisch. Sie müssen Agents nur dann upgraden, wenn dies für den Zugriff auf die neue Funktionalität erforderlich ist.

Das in diesem Abschnitt beschriebene Upgrade-Verfahren kann sowohl für das Upgrade des Zabbix Agent als auch des Zabbix Agent 2 verwendet werden.

1 Agent stoppen

Zabbix Agent stoppen.

2 Sichern Sie Konfigurationsdateien und Zabbix-Agent-Binärdateien

Erstellen Sie eine Sicherungskopie der Zabbix-Agent-Binärdatei und der Konfigurationsdatei.

3 Neue Agent-Binärdateien installieren

Verwenden Sie diese Anweisungen, um den Zabbix Agent aus den Quellen zu kompilieren.

Alternativ können Sie vorkompilierte Zabbix Agents von der Zabbix-Downloadseite herunterladen.

4 Agent-Konfigurationsparameter überprüfen

Lesen Sie unbedingt die Hinweise zum Upgrade, um zu prüfen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Informationen zu neuen optionalen Parametern finden Sie auf der Seite Was ist neu?.

5 Neuen Zabbix Agent starten

Starten Sie den neuen Zabbix Agent. Prüfen Sie die Protokolldateien, um festzustellen, ob der Agent erfolgreich gestartet wurde.

Upgrade zwischen Minor-Versionen

Beim Upgrade zwischen Minor-Versionen von 7.0.x (z. B. von 7.0.1 auf 7.0.3) müssen für Server/Proxy/Agent dieselben Aktionen ausgeführt werden wie beim Upgrade zwischen Major-Versionen.
Der einzige Unterschied besteht darin, dass beim Upgrade zwischen Minor-Versionen keine Änderungen an der Datenbank vorgenommen werden.