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/
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 essere necessario rimuovere manualmente dal proprio 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.

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

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 Debian più vecchie, 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 Zabbix e, per aggiornare tali componenti tramite pacchetti, si consiglia di aggiornare il sistema operativo. Per un elenco dei componenti inclusi, vedere Zabbix packages.

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 Ubuntu più vecchie, 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 Zabbix e, per aggiornare tali componenti tramite pacchetti, si consiglia di aggiornare il sistema operativo. Per un elenco dei componenti inclusi, vedere Zabbix packages.

Potrebbe comparire 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 del manutentore del pacchetto della configurazione del repository Zabbix.

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

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

Per i nuovi parametri opzionali, consulta 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 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.