[comment]: # ({a25b2d94-91aab3e5}) # Debian/Ubuntu [comment]: # ({/a25b2d94-91aab3e5}) [comment]: # ({545ec22f-d02acea9}) #### Ü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. ::: notewarning Bitte lesen Sie vor dem Upgrade die entsprechenden [Hinweise zum Upgrade](/manual/installation/upgrade) und stellen Sie sicher, dass Ihr System die [Anforderungen](/manual/installation/requirements) für Zabbix 8.0 erfüllt. ::: ::: noteclassic 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-between-minor-versions). [comment]: # ({/545ec22f-d02acea9}) [comment]: # ({93ff8b03-93ff8b03}) #### Upgrade-Verfahren [comment]: # ({/93ff8b03-93ff8b03}) [comment]: # ({b7813e36-f8102233}) ##### 1 Zabbix-Prozesse stoppen Stoppen Sie den Zabbix-Server, um sicherzustellen, dass keine neuen Daten in die Datenbank eingefügt werden: ```bash systemctl stop zabbix-server ``` Wenn Sie Zabbix Proxy, Agent oder Agent 2 aktualisieren, stoppen Sie auch diese Komponenten: ```bash systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ``` [comment]: # ({/b7813e36-f8102233}) [comment]: # ({906e7b99-ab13a6a4}) ##### 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). [comment]: # ({/906e7b99-ab13a6a4}) [comment]: # ({9978590c-6c141723}) ##### 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: ```bash 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: ```bash cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ``` [comment]: # ({/9978590c-6c141723}) [comment]: # ({73d08cd4-31c75b55}) ##### 4 Repository-Konfigurationspaket aktualisieren Bevor Sie mit dem Upgrade fortfahren, deinstallieren Sie Ihr aktuelles Zabbix-Repository-Paket: ```bash rm -Rf /etc/apt/sources.list.d/zabbix.list ``` Möglicherweise müssen Sie außerdem 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: ```bash 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 ``` ::: noteclassic Für ältere Debian-Versionen ersetzen Sie den obigen Link durch den passenden aus dem [Zabbix-Repository](https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/). 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-Pakete](https://www.zabbix.com/download?zabbix=8.0&os_distribution=debian&os_version=11&components=agent&db=&ws=). ::: Unter **Ubuntu 24.04** führen Sie Folgendes aus: ```bash 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: ```bash 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 ``` ::: noteclassic Für ältere Ubuntu-Versionen ersetzen Sie den obigen Link durch den passenden aus dem [Zabbix-Repository](https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/). 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-Pakete](https://www.zabbix.com/download?zabbix=8.0&os_distribution=ubuntu&os_version=20.04&components=agent&db=&ws=). ::: Möglicherweise wird eine Eingabeaufforderung zur Konfiguration des Zabbix-Repositorys angezeigt: ```bash 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 anschließend die Repository-Informationen: ```bash apt update ``` [comment]: # ({/73d08cd4-31c75b55}) [comment]: # ({a78e76d3-08c7383c}) ##### 5 Zabbix-Komponenten aktualisieren Um Zabbix-Komponenten zu aktualisieren, führen Sie Folgendes aus: ```bash 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-*`. ::: noteimportant 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*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Möglicherweise wird eine Eingabeaufforderung zur Konfiguration des Zabbix Server (oder Proxy) angezeigt: ```bash 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: ```bash apt install zabbix-apache-conf systemctl restart apache2 ``` [comment]: # ({/a78e76d3-08c7383c}) [comment]: # ({06ed5d87-455f4e97}) ##### 6 Konfigurationsparameter der Komponente überprüfen Prüfen Sie die relevanten [Upgrade-Hinweise](/manual/installation/upgrade_notes), um festzustellen, ob Änderungen an den Konfigurationsparametern erforderlich sind. Neue optionale Parameter finden Sie auf der Seite [Was ist neu](/manual/whatsnew). [comment]: # ({/06ed5d87-455f4e97}) [comment]: # ({e83479d6-624a8fc7}) ##### 7 Zabbix-Prozesse starten Starten Sie die aktualisierten Zabbix-Komponenten: ```bash systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ``` [comment]: # ({/e83479d6-624a8fc7}) [comment]: # ({0d20ecac-49e4f43e}) ##### 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. [comment]: # ({/0d20ecac-49e4f43e}) [comment]: # ({d6c45268-9bab02f2}) #### 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: ```bash apt update ``` Führen Sie dann zum Upgrade aller Zabbix-Komponenten Folgendes aus: ```bash 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*'`. [comment]: # ({/d6c45268-9bab02f2})