Debian/Ubuntu

Übersicht

Dieser Abschnitt enthält Anweisungen für das Upgrade von Zabbix 7.4.x auf die neueste Version von Zabbix 8.0.x unter Verwendung offizieller Zabbix-Pakete für Debian/Ubuntu.

Bitte lesen Sie vor dem Upgrade die entsprechenden Hinweise zum Upgrade und stellen Sie sicher, dass Ihr System die Anforderungen für Zabbix 8.0 erfüllt.

Ziehen Sie in Betracht, 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 Produktivumgebungen entscheidend sein.

Anweisungen für das Upgrade zwischen Nebenversionen von Zabbix 8.0.x (zum Beispiel von 8.0.1 auf 8.0.3) finden Sie unter Upgrade zwischen Nebenversionen.

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 nicht versehentlich eine veraltete Version wiederverwendet.

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

Unter Debian 12 führen Sie Folgendes aus:

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

Ersetzen Sie bei älteren Debian-Versionen den obigen Link durch den passenden aus dem Zabbix repository. Beachten Sie jedoch, dass Pakete für diese Versionen möglicherweise nicht alle Zabbix-Komponenten enthalten. Wenn Sie diese Komponenten aus Paketen aktualisieren möchten, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie unter Zabbix packages.

Unter Ubuntu 24.04 führen Sie Folgendes aus:

wget https://repo.zabbix.com/zabbix/8.0/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 Folgendes aus:

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

Ersetzen Sie bei älteren Ubuntu-Versionen den obigen Link durch den passenden aus dem Zabbix repository. Beachten Sie jedoch, dass Pakete für diese Versionen möglicherweise nicht alle Zabbix-Komponenten enthalten. Wenn Sie diese Komponenten aus Paketen aktualisieren möchten, sollten Sie ein Upgrade Ihres Betriebssystems in Betracht ziehen. Eine Liste der enthaltenen Komponenten finden Sie unter Zabbix packages.

Möglicherweise wird Ihnen eine Eingabeaufforderung zur Konfiguration des Zabbix-Repositorys 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 der Zabbix-Repository-Konfiguration des Paketbetreuers 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 Konfigurationsparameter der Komponente überprüfen

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

Neue optionale Parameter 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 den Zabbix-8.0.x-Minor-Versionen zu aktualisieren (zum Beispiel von 8.0.1 auf 8.0.3).

Aktualisieren Sie zunächst 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*'.