Debian/Ubuntu

Panoramica

Questa sezione fornisce istruzioni su come eseguire l'aggiornamento da Zabbix 7.4.x all'ultima versione di Zabbix 8.0.x utilizzando i pacchetti ufficiali di Zabbix per Debian/Ubuntu.

Prima di eseguire l'aggiornamento, consulta le note di aggiornamento pertinenti e assicurati che il tuo sistema soddisfi i requisiti per Zabbix 8.0.

Valuta l'esecuzione di due sessioni SSH parallele durante l'aggiornamento: una per eseguire i passaggi dell'aggiornamento e un'altra per monitorare i log di server/proxy. Ad esempio, esegui tail -f zabbix_server.log oppure tail -f zabbix_proxy.log nella seconda sessione per visualizzare in tempo reale le voci di log più recenti e i possibili errori. Questo può essere fondamentale per le istanze di produzione.

Per istruzioni su come eseguire l'aggiornamento tra versioni secondarie di Zabbix 8.0.x (ad esempio, dalla 8.0.1 alla 8.0.3), consulta Aggiornamento tra versioni secondarie.

Procedura di aggiornamento

1 Arrestare i processi di Zabbix

Arrestare il server Zabbix per assicurarsi che nessun nuovo dato venga inserito nel database:

systemctl stop zabbix-server

Se si sta aggiornando Zabbix proxy, agent o agent 2, arrestare anche questi componenti:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Eseguire il backup del database Zabbix

Eseguire il backup del database Zabbix esistente per proteggersi da eventuali errori durante l'aggiornamento (ad esempio, problemi di spazio su disco, interruzioni di corrente o problemi imprevisti).

3 Eseguire il backup dei file di configurazione di Zabbix, dei file PHP e dei binari di Zabbix

Eseguire il backup dei file di configurazione di Zabbix, dei file PHP e dei binari di Zabbix esistenti.

Per i file di configurazione, eseguire:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

Per i file PHP e i binari di Zabbix, eseguire:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Aggiornare il pacchetto di configurazione del repository

Prima di procedere con l'aggiornamento, disinstallare il pacchetto del repository Zabbix attualmente in uso:

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

Potrebbe anche essere necessario rimuovere manualmente eventuali vecchi pacchetti Zabbix dalla directory di lavoro (ad esempio, rm zabbix-release_latest+debian12_all.deb) prima di scaricare quello nuovo, per evitare che il gestore dei pacchetti riutilizzi una versione obsoleta durante il processo di aggiornamento.

Quindi, installare l'ultimo pacchetto di configurazione del repository per garantire la compatibilità con i pacchetti più recenti e includere eventuali patch di sicurezza o correzioni di bug recenti.

Su Debian 12, eseguire:

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

Per le versioni precedenti di Debian, sostituire il link sopra con quello corretto dal repository Zabbix. Si noti tuttavia che i pacchetti per queste versioni potrebbero non includere tutti i componenti di Zabbix e, per aggiornare tali componenti dai pacchetti, valutare l'aggiornamento del sistema operativo. Per un elenco dei componenti inclusi, vedere Pacchetti Zabbix.

Su Ubuntu 24.04, eseguire:

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

Su Ubuntu 22.04, eseguire:

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

Per le versioni precedenti di Ubuntu, sostituire il link sopra con quello corretto dal repository Zabbix. Si noti tuttavia che i pacchetti per queste versioni potrebbero non includere tutti i componenti di Zabbix e, per aggiornare tali componenti dai pacchetti, valutare l'aggiornamento del sistema operativo. Per un elenco dei componenti inclusi, vedere Pacchetti Zabbix.

Potrebbe essere visualizzata una richiesta relativa alla configurazione del repository Zabbix:

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] ?

Immettere Y (o I) per installare la versione della configurazione del repository Zabbix fornita dal manutentore del pacchetto.

Quindi, aggiornare le informazioni del repository:

apt update
5 Aggiornare i componenti Zabbix

Per aggiornare i componenti Zabbix, eseguire:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • Se si utilizza PostgreSQL, sostituire mysql con pgsql nel comando.
  • Se si sta aggiornando il proxy, sostituire server con proxy nel comando.
  • Se si sta aggiornando Zabbix agent 2, sostituire zabbix-agent con zabbix-agent2 zabbix-agent2-plugin-* nel comando.

L'aggiornamento di Zabbix agent 2 con il comando apt install zabbix-agent2 potrebbe causare un errore. Per ulteriori informazioni, vedere Problemi noti.

Potrebbe essere visualizzato un prompt relativo alla configurazione di Zabbix server (o proxy):

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] ?

Immettere l'opzione più adatta alla propria situazione. Ad esempio, immettere D per confrontare la configurazione corrente con quella nuova, quindi decidere se si desidera installare la versione del manutentore del pacchetto (Y o I).

Quindi, per aggiornare Zabbix frontend con Apache e riavviare Apache, eseguire:

apt install zabbix-apache-conf
systemctl restart apache2
6 Rivedere i parametri di configurazione dei componenti

Rivedere le note di aggiornamento pertinenti per verificare se sono necessarie modifiche ai parametri di configurazione.

Per i nuovi parametri opzionali, vedere la pagina Novità.

7 Avviare i processi di Zabbix

Avviare i componenti Zabbix aggiornati:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2

Dopo l'aggiornamento, potrebbe essere necessario cancellare i cookie e la cache del browser web affinché l'interfaccia web di Zabbix funzioni correttamente.

Aggiornamento tra versioni minori

È possibile eseguire l'aggiornamento tra versioni minori 8.0.x di Zabbix (ad esempio, dalla 8.0.1 alla 8.0.3).

Per prima cosa, aggiornare le informazioni del repository:

apt update

Quindi, per aggiornare tutti i componenti di Zabbix, eseguire:

apt install --only-upgrade 'zabbix*'
  • Per aggiornare solo Zabbix server, sostituire 'zabbix*' con 'zabbix-server*' nel comando.
  • Per aggiornare solo Zabbix proxy, sostituire 'zabbix*' con 'zabbix-proxy*' nel comando.
  • Per aggiornare solo Zabbix agent, sostituire 'zabbix*' con 'zabbix-agent*' nel comando.
  • Per aggiornare solo Zabbix agent 2, sostituire 'zabbix*' con 'zabbix-agent2*' nel comando.