1 Red Hat Enterprise Linux

Übersicht

Dieser Abschnitt enthält Anweisungen zum Upgrade von Zabbix 6.4.x auf die neueste Version von Zabbix 7.0.x unter Verwendung offizieller Zabbix-Pakete für Red Hat Enterprise Linux oder dessen Derivate - AlmaLinux, CentOS Stream, Oracle Linux und Rocky Linux.

Vor Zabbix 7.0 wurden einzelne Installationspakete für RHEL und auf RHEL basierende Distributionen bereitgestellt. Ab 7.0 werden separate Pakete für RHEL und jedes der oben genannten Derivate verwendet, um potenzielle Probleme mit binärer Inkompatibilität zu vermeiden.

Prüfen Sie vor dem Upgrade die relevanten Upgrade-Hinweise und stellen Sie sicher, dass Ihr System die Anforderungen für Zabbix 7.0 erfüllt.

Erwägen Sie, während des Upgrades zwei parallele SSH-Sitzungen zu verwenden: eine für die Ausführung der Upgrade-Schritte und eine weitere zur Überwachung der Server/Proxy-Protokolle. Führen Sie beispielsweise in der zweiten 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 Produktionsinstanzen kritisch sein.

Anweisungen zum Upgrade zwischen Zabbix 7.0.x-Minor-Versionen (zum Beispiel von 7.0.1 auf 7.0.3) finden Sie unter Upgrade zwischen Minor-Versionen.

Upgrade-Verfahren

1 Zabbix-Prozesse stoppen

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

systemctl stop zabbix-server

Wenn Sie Zabbix Proxy, Agent oder Agent 2 aktualisieren, stoppen Sie auch diese Komponenten:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Zabbix-Datenbank sichern

Sichern Sie Ihre bestehende Zabbix-Datenbank, um sich gegen Fehler bei der Aktualisierung abzusichern (zum Beispiel Probleme mit dem Festplattenspeicher, Stromausfall oder unerwartete Probleme).

3 Sichern Sie Zabbix-Konfigurationsdateien, PHP-Dateien und Zabbix-Binärdateien

Sichern Sie vorhandene Zabbix-Konfigurationsdateien, PHP-Dateien und Zabbix-Binärdateien.

Führen Sie für Konfigurationsdateien Folgendes aus:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

Führen Sie für PHP-Dateien und Zabbix-Binärdateien Folgendes aus:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Repository-Konfigurationspaket aktualisieren

Bevor Sie mit dem Upgrade fortfahren, aktualisieren Sie Ihr aktuelles Repository-Paket auf die neueste Version, um die Kompatibilität mit den neuesten Paketen sicherzustellen und um aktuelle Sicherheits-Patches oder Fehlerbehebungen einzuschließen.

Unter RHEL 9 führen Sie aus:

rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm

Unter RHEL 8 führen Sie aus:

rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm

Für ältere RHEL-Versionen oder deren Derivate ersetzen Sie den obigen Link durch den korrekten Link aus dem Zabbix-Repository. Beachten Sie jedoch, dass Pakete für diese Versionen möglicherweise nicht alle Zabbix-Komponenten enthalten. Um diese Komponenten aus Paketen zu aktualisieren, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie unter Zabbix packages.

Bereinigen Sie anschließend den Cache des dnf-Paketmanagers (einschließlich Headern, Metadaten und Paketdateien, die bei früheren Installationen oder Aktualisierungen heruntergeladen wurden):

dnf clean all

Beim nächsten dnf-Vorgang lädt dnf neue Metadaten aus den Repositories herunter, da die alten Metadaten entfernt wurden.

Siehe auch: Known issues zum Aktualisieren des Repository-Konfigurationspakets unter RHEL.

5 Zabbix-Komponenten aktualisieren

Um Zabbix-Komponenten zu aktualisieren, führen Sie Folgendes aus:

dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent
  • Wenn Sie PostgreSQL verwenden, ersetzen Sie mysql im Befehl durch pgsql.
  • Wenn Sie den Proxy aktualisieren, ersetzen Sie server im Befehl durch proxy.
  • Wenn Sie Agent 2 aktualisieren, ersetzen Sie zabbix-agent im Befehl durch zabbix-agent2 zabbix-agent2-plugin-*.

Die Aktualisierung von Zabbix Agent 2 mit dem Befehl dnf install zabbix-agent2 kann zu einem Fehler führen. Weitere Informationen finden Sie unter Bekannte Probleme.

Führen Sie dann Folgendes aus, um das Zabbix Frontend mit Apache zu aktualisieren und Apache neu zu starten:

dnf install zabbix-apache-conf
systemctl restart httpd
6 Überprüfen der Konfigurationsparameter der Komponente

Prüfen Sie die relevanten Upgrade-Hinweise, um festzustellen, ob Änderungen an den Konfigurationsparametern erforderlich sind.

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

7 Zabbix-Prozesse starten

Starten Sie die aktualisierten Zabbix-Komponenten:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
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.

Upgrade zwischen Minor-Versionen

Es ist möglich, zwischen Zabbix 7.0.x Minor-Versionen zu aktualisieren (zum Beispiel von 7.0.1 auf 7.0.3).

Um alle Zabbix-Komponenten zu aktualisieren, führen Sie Folgendes aus:

dnf upgrade 'zabbix-*'
  • Um nur den Zabbix Server zu aktualisieren, ersetzen Sie 'zabbix-*' im Befehl durch 'zabbix-server-*'.
  • Um nur den Zabbix Proxy zu aktualisieren, ersetzen Sie 'zabbix-*' im Befehl durch 'zabbix-proxy-*'.
  • Um nur den Zabbix Agent zu aktualisieren, ersetzen Sie 'zabbix-*' im Befehl durch 'zabbix-agent-*'.
  • Um nur den Zabbix Agent 2 zu aktualisieren, ersetzen Sie 'zabbix-*' im Befehl durch 'zabbix-agent2-*'.