Upgrade aus den Quellen

Überblick

Dieser Abschnitt beschreibt die Schritte, die für ein erfolgreiches Upgrade von Zabbix 7.4.x auf Zabbix 8.0.x unter Verwendung der offiziellen Zabbix-Quellen erforderlich sind.

Lesen Sie vor dem Upgrade unbedingt die entsprechenden Hinweise zum Upgrade!

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

Es kann hilfreich sein, während des Upgrades zwei parallele SSH-Sitzungen zu verwenden: Führen Sie in einer die Upgrade-Schritte aus und überwachen Sie in der anderen die Server-/Proxy-Protokolle. Führen Sie beispielsweise tail -f zabbix_server.log oder tail -f zabbix_proxy.log in der zweiten SSH-Sitzung aus, damit Ihnen die neuesten Protokolleinträge und mögliche Fehler in Echtzeit angezeigt werden. Dies kann für Produktivumgebungen 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 bestehende Zabbix-Datenbank

Dies ist ein sehr wichtiger Schritt. Stellen Sie sicher, dass Sie eine Sicherungskopie Ihrer Datenbank haben. Sie hilft, falls das Upgrade fehlschlägt (zu wenig Speicherplatz, Stromausfall, ein anderes unerwartetes Problem).

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

Erstellen Sie eine Sicherungskopie der Zabbix-Binärdateien, der Konfigurationsdateien und des PHP-Dateiverzeichnisses.

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

Stellen Sie sicher, dass Sie die Upgrade-Hinweise prüfen, um festzustellen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Neue optionale Parameter finden Sie auf der Seite Was ist neu.

6 Neue Zabbix-Binärdateien starten

Starten Sie die neuen Binärdateien. Prüfen Sie die Logdateien, um festzustellen, ob 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 ist als die erforderliche Version, führt der Zabbix Server automatisch die erforderlichen Datenbank-Upgrade-Patches aus. Der Beginn und der Fortschrittsstand (Prozentsatz) des Datenbank-Upgrades werden in die Logdatei des Zabbix Server geschrieben. Wenn das Upgrade abgeschlossen ist, wird eine Meldung „database upgrade fully completed“ in die Logdatei geschrieben. Falls einer der Upgrade-Patches fehlschlägt, startet der Zabbix Server nicht. Der Zabbix Server startet auch dann nicht, wenn die aktuelle obligatorische Datenbankversion neuer ist als die erforderliche. Der Zabbix Server startet nur, wenn die aktuelle obligatorische Datenbankversion der erforderlichen obligatorischen Version entspricht.

8673:20161117:104750.259 aktuelle Datenbankversion (obligatorisch/optional): 03040000/03040000
8673:20161117:104750.259 erforderliche obligatorische 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 genügend freier Speicherplatz vorhanden ist.
7 Neue Zabbix-Weboberfläche installieren

Die mindestens erforderliche PHP-Version ist 8.2.0. Aktualisieren Sie sie bei Bedarf und folgen Sie den Installationsanweisungen.

8 Cookies und Cache des Webbrowsers löschen

Nach dem Upgrade müssen Sie möglicherweise Cookies und den Cache des Webbrowsers löschen, damit die Zabbix-Weboberfläche 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

Stellen Sie sicher, dass Sie die Upgrade-Hinweise prüfen, um festzustellen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Neue optionale Parameter 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 wird die Datenbank automatisch aktualisieren. Die Datenbankaktualisierung erfolgt ähnlich wie beim Starten des Zabbix Server.

Agent-Aktualisierungsprozess

Die Aktualisierung von Agenten ist nicht zwingend erforderlich. Sie müssen Agenten nur aktualisieren, wenn dies erforderlich ist, um auf die neuen Funktionen zuzugreifen.

Das in diesem Abschnitt beschriebene Aktualisierungsverfahren kann sowohl für die Aktualisierung des Zabbix-Agenten als auch des Zabbix-Agenten 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 Agenten von der Zabbix-Download-Seite herunterladen.

4 Konfigurationsparameter des Agent überprüfen

Stellen Sie sicher, dass Sie die Upgrade-Hinweise prüfen, um festzustellen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

Neue optionale Parameter 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 Nebenversionen

Beim Upgrade zwischen Nebenversionen von 8.0.x (zum Beispiel von 8.0.1 auf 8.0.3) müssen für Server/Proxy/Agent dieselben Aktionen ausgeführt werden wie beim Upgrade zwischen Hauptversionen. Der einzige Unterschied besteht darin, dass beim Upgrade zwischen Nebenversionen keine Änderungen an der Datenbank vorgenommen werden.