2 Debian/Ubuntu

Panoramica

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

Prima di eseguire l'aggiornamento, consultare le pertinenti note di aggiornamento e verificare che il sistema soddisfi i requisiti per Zabbix 7.4.

Si consiglia di eseguire due sessioni SSH parallele durante l'aggiornamento: una per eseguire i passaggi di aggiornamento e un'altra per monitorare i log di server/proxy. Ad esempio, eseguire tail -f zabbix_server.log oppure tail -f zabbix_proxy.log nella seconda sessione per visualizzare in tempo reale le ultime voci di log ed eventuali errori. Questo può essere fondamentale per gli ambienti di produzione.

Per le istruzioni sull'aggiornamento tra le versioni minori di Zabbix 7.4.x (ad esempio, da 7.4.1 a 7.4.3), vedere Aggiornamento tra versioni minori.

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/
# Per Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Per Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.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 Aggiornamento del pacchetto di configurazione del repository

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

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

Potrebbe inoltre essere necessario rimuovere manualmente dalla directory di lavoro eventuali vecchi pacchetti Zabbix (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.

Installare quindi il pacchetto più recente 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 13, eseguire:

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

Su Debian 12, eseguire:

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

Per le versioni precedenti di Debian, sostituire il link precedente con quello corretto disponibile nel repository Zabbix. Tuttavia, i pacchetti per queste versioni potrebbero non includere tutti i componenti Zabbix; per aggiornare tali componenti dai pacchetti, valutare l'aggiornamento del sistema operativo. Per un elenco dei componenti inclusi, vedere Pacchetti Zabbix.

Su Ubuntu 26.04, eseguire:

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

Su Ubuntu 24.04, eseguire:

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

Su Ubuntu 22.04, eseguire:

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

Per le versioni precedenti di Ubuntu, sostituire il link precedente con quello corretto disponibile nel repository Zabbix. Tuttavia, i pacchetti per queste versioni potrebbero non includere tutti i componenti Zabbix; per aggiornare tali componenti dai pacchetti, valutare l'aggiornamento del sistema operativo. Per un elenco dei componenti inclusi, vedere Pacchetti Zabbix.

Potrebbe essere visualizzato un prompt relativo 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] ?

Inserire 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 Aggiornamento dei 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 aggiorna il proxy, sostituire server con proxy nel comando.
  • Se si aggiorna 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 visualizzata una richiesta relativa alla configurazione del server Zabbix (o del 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] ?

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

Quindi, aggiornare il frontend Zabbix e riavviare il web server.

Per Apache, eseguire:

apt install zabbix-apache-conf
systemctl restart apache2

Per Nginx, eseguire:

apt install zabbix-nginx-conf
systemctl restart nginx

Per Nginx, potrebbe essere visualizzata una richiesta relativa al file di configurazione nginx.conf. Inserire l'opzione più adatta alla propria situazione:

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 Rivedere i parametri di configurazione del componente

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

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

Se si utilizza Nginx come web server e il file di configurazione /etc/zabbix/nginx.conf è stato reinstallato durante l'aggiornamento, esaminare il file e aggiornare le direttive listen e server_name in modo che corrispondano alla configurazione del frontend di Zabbix.

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 di Zabbix 7.4.x (ad esempio, da 7.4.1 a 7.4.3).

Per prima cosa, aggiorna le informazioni del repository:

apt update

Quindi, per aggiornare tutti i componenti Zabbix, esegui:

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