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 Zabbix-Konfigurationsdateien, PHP-Dateien und Zabbix-Binärdateien sichern

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

Für Konfigurationsdateien führen Sie Folgendes aus:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Für Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Für Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.conf /opt/zabbix-backup/

Für PHP-Dateien und Zabbix-Binärdateien führen Sie 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 Paket herunterladen, damit der Paketmanager während des Upgrade-Vorgangs keine veraltete Version erneut verwendet.

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

Unter Debian 13 führen Sie aus:

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

Unter Debian 12 führen Sie 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.

Unter Ubuntu 26.04 führen Sie aus:

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

Unter Ubuntu 24.04 führen Sie 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

Unter Ubuntu 22.04 führen Sie 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 vom Paketbetreuer bereitgestellte Version der Zabbix-Repository-Konfiguration zu installieren.

Aktualisieren Sie anschließend die Repository-Informationen:

apt update
5 Upgrade von Zabbix-Komponenten

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-*.

Das Aktualisieren 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-Servers (oder Proxys) 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 beispielsweise 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).

Aktualisieren Sie anschließend das Zabbix-Frontend und starten Sie den Webserver neu.

Für Apache führen Sie Folgendes aus:

apt install zabbix-apache-conf
systemctl restart apache2

Für Nginx führen Sie Folgendes aus:

apt install zabbix-nginx-conf
systemctl restart nginx

Bei Nginx wird möglicherweise eine Eingabeaufforderung zur Konfigurationsdatei nginx.conf angezeigt. Geben Sie die Option ein, die am besten zu Ihrer Situation passt:

Configuration file '/etc/zabbix/nginx.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.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?
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.

Wenn Nginx als Webserver verwendet wird und die Konfigurationsdatei /etc/zabbix/nginx.conf während des Upgrades neu installiert wurde, überprüfen Sie die Datei und passen Sie die Direktiven listen und server_name an, damit sie mit Ihrer Zabbix-Frontend-Konfiguration übereinstimmen.

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*'.