2 Debian/Ubuntu

Überblick

Dieser Abschnitt enthält Anweisungen zum Upgrade von Zabbix 7.2.x auf die neueste Version von Zabbix 7.4.x mithilfe der offiziellen Zabbix-Pakete für Debian/Ubuntu.

Lesen Sie vor dem Upgrade bitte die relevanten Upgrade-Hinweise und stellen Sie sicher, dass Ihr System die Anforderungen für Zabbix 7.4 erfüllt.

Erwägen Sie, während des Upgrades zwei parallele SSH-Sitzungen zu verwenden: eine zum Ausführen der Upgrade-Schritte und eine weitere zum Überwachen 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.4.x-Minor-Versionen (zum Beispiel von 7.4.1 auf 7.4.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 vorhandene Zabbix-Datenbank, um sich gegen Upgrade-Fehler abzusichern (zum Beispiel Probleme mit dem Speicherplatz, 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/apache2/conf-enabled/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, deinstallieren Sie Ihr aktuelles Zabbix-Repository-Paket:

rm -Rf /etc/apt/sources.list.d/zabbix.list

Möglicherweise müssen Sie auch alte Zabbix-Pakete manuell aus Ihrem Arbeitsverzeichnis entfernen (z. B. rm zabbix-release_latest+debian12_all.deb), bevor Sie das neue herunterladen, damit der Paketmanager während des Upgrade-Vorgangs keine veraltete Version erneut verwendet.

Installieren Sie dann das neueste Repository-Konfigurationspaket, um die Kompatibilität mit den neuesten Paketen sicherzustellen und aktuelle Sicherheits-Patches oder Fehlerbehebungen einzuschließen.

Führen Sie auf Debian 12 Folgendes aus:

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

Für ältere Debian-Versionen 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 per Paket zu aktualisieren, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie unter Zabbix packages.

Führen Sie auf Ubuntu 24.04 Folgendes aus:

wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Führen Sie auf Ubuntu 22.04 Folgendes aus:

wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Für ältere Ubuntu-Versionen 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 per Paket zu aktualisieren, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie unter Zabbix packages.

Möglicherweise wird eine Eingabeaufforderung zur Zabbix-Repository-Konfiguration angezeigt:

Configuration file '/etc/apt/sources.list.d/zabbix.list'
==> Deleted (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Geben Sie Y (oder I) ein, um die Version des Paketbetreuers der Zabbix-Repository-Konfiguration zu installieren.

Aktualisieren Sie dann die Repository-Informationen:

apt update
5 Zabbix-Komponenten aktualisieren

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

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php 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 Zabbix Agent 2 aktualisieren, ersetzen Sie zabbix-agent im Befehl durch zabbix-agent2 zabbix-agent2-plugin-*.

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

Möglicherweise wird eine Eingabeaufforderung zur Konfiguration des Zabbix Server (oder Proxy) angezeigt:

Configuration file '/etc/zabbix/zabbix_server.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Geben Sie die Option ein, die am besten zu Ihrer Situation passt. Geben Sie zum Beispiel D ein, um die aktuelle und die neue Konfiguration zu vergleichen, und entscheiden Sie dann, ob Sie die Version des Paketbetreuers installieren möchten (Y oder I).

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

apt install zabbix-apache-conf
systemctl restart apache2
6 Überprüfung 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

Ein Upgrade zwischen Zabbix 7.4.x Minor-Versionen ist möglich (zum Beispiel von 7.4.1 auf 7.4.3).

Aktualisieren Sie zuerst die Repository-Informationen:

apt update

Führen Sie dann zum Upgrade aller Zabbix-Komponenten Folgendes aus:

apt install --only-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*'.