1 Upgrade aus den Quellen

Übersicht

Dieser Abschnitt beschreibt die erforderlichen Schritte für ein erfolgreiches Upgrade von Zabbix 7.2.x auf Zabbix 7.4.x unter Verwendung offizieller Zabbix-Quellen.

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

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

Es kann hilfreich sein, während des Upgrades zwei parallele SSH-Sitzungen auszuführen: In einer Sitzung 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 Die vorhandene Zabbix-Datenbank sichern

Dies ist ein sehr wichtiger Schritt.
Stellen Sie sicher, dass Sie eine Sicherungskopie Ihrer Datenbank haben.
Sie hilft Ihnen, wenn das Upgrade-Verfahren fehlschlägt (fehlender Speicherplatz, Stromausfall oder ein anderes unerwartetes Problem).

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. Überprüfen Sie die Protokolldateien, um festzustellen, ob die Binärdateien erfolgreich gestartet wurden.

Der Zabbix-Server aktualisiert die Datenbank automatisch. Beim Start meldet der Zabbix-Server die aktuellen (obligatorischen und optionalen) sowie die erforderlichen Datenbankversionen. Wenn die aktuelle obligatorische Version älter als die erforderliche Version ist, führt der Zabbix-Server automatisch die erforderlichen Patches für die 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 PHP 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 Logdateien, um festzustellen, ob der Proxy erfolgreich gestartet wurde.

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

Agent-Upgradeprozess

Das Upgrade von Agents ist nicht zwingend erforderlich. 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 Konfigurationsparameter des Agent ü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.4.x (zum Beispiel von 7.4.1 auf 7.4.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.