2 Debian/Ubuntu

Übersicht

Dieser Abschnitt enthält Anweisungen zum Upgrade von Zabbix 6.4.x auf die neueste Version von Zabbix 7.0.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.0 erfüllt.

Es wird empfohlen, während des Upgrades zwei parallele SSH-Sitzungen zu verwenden: eine zum Ausführen 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 entscheidend 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 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 die vorhandenen Zabbix-Konfigurationsdateien, PHP-Dateien und Zabbix-Binärdateien.

Führen Sie für die Konfigurationsdateien 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ühren Sie für die 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 Paket 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.

Auf 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

Auf Debian 12 führen Sie aus:

wget https://repo.zabbix.com/zabbix/7.0/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 passenden Link aus dem Zabbix repository. Beachten Sie jedoch, dass Pakete für diese Versionen möglicherweise nicht alle Zabbix-Komponenten enthalten. Um diese Komponenten über Pakete zu aktualisieren, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie im Zabbix repository.

Auf 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

Auf Ubuntu 24.04 führen Sie aus:

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

Auf Ubuntu 22.04 führen Sie aus:

wget https://repo.zabbix.com/zabbix/7.0/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 passenden Link aus dem Zabbix repository. Beachten Sie jedoch, dass Pakete für diese Versionen möglicherweise nicht alle Zabbix-Komponenten enthalten. Um diese Komponenten über Pakete 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 dann 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 Known issues.

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 vom Paketbetreuer bereitgestellte Version 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 Ihre Zabbix-Frontend-Konfiguration an.

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.0.x Minor-Versionen ist möglich (zum Beispiel von 7.0.1 auf 7.0.3).

Aktualisieren Sie zuerst die Repository-Informationen:

apt update

Führen Sie dann aus, um alle Zabbix-Komponenten zu aktualisieren:

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