2 Debian/Ubuntu

Overview

This section provides the steps required for a successful upgrade from Zabbix 5.4.x to Zabbix 6.0.x using official Zabbix packages for Debian/Ubuntu.

While upgrading Zabbix agents is not mandatory (but recommended), Zabbix server and proxies must be of the same major version. Therefore, in a server-proxy setup, Zabbix server and all proxies have to be stopped and upgraded. Keeping proxies running during server upgrade no longer will bring any benefit as during proxy upgrade their old data will be discarded and no new data will be gathered until proxy configuration is synced with server.

Note that with SQLite database on proxies, history data from proxies before the upgrade will be lost, because SQLite database upgrade is not supported and the SQLite database file has to be manually removed. When proxy is started for the first time and the SQLite database file is missing, proxy creates it automatically.

Depending on database size the database upgrade to version 6.0 may take a long time.

The following upgrade notes are available:

You may also want to check the requirements for 6.0.

Procedura di aggiornamento

1 Arresta i processi di Zabbix

Arresta il server Zabbix per assicurarti che non vengano inseriti nuovi dati nel database.

# arresto del servizio zabbix-server

Se aggiorni il proxy Zabbix, ferma anche il proxy.

# arresto del servizio zabbix-proxy

2 Eseguire il backup del database Zabbix esistente

Questo è un passo molto importante. Assicurati di avere un backup del tuo database. Aiuterà se la procedura di aggiornamento fallisce (mancanza di spazio disco, spegnimento, qualsiasi problema imprevisto).

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

Crea una copia di backup dei binari di Zabbix, dei file di configurazione e della cartella dei file PHP.

File di configurazione:

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

File PHP e binari Zabbix:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/zabbix-* /opt/zabbix-backup/

4 Update repository configuration package

To proceed with the update your current repository package has to be uninstalled.

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

Then install the new repository configuration package.

On Debian 10 run:

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
       # dpkg -i zabbix-release_5.4-1+debian10_all.deb

On Debian 9 run:

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
       # dpkg -i zabbix-release_5.4-1+debian9_all.deb

On Debian 8 run:

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian8_all.deb
       # dpkg -i zabbix-release_5.4-1+debian8_all.deb

On Ubuntu 20.04 run:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
       # dpkg -i zabbix-release_5.4-1+ubuntu20.04_all.deb

On Ubuntu 18.04 run:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb

On Ubuntu 16.04 run:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
       # dpkg -i zabbix-release_5.4-1+ubuntu16.04_all.deb

On Ubuntu 14.04 run:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb

Update the repository information.

# apt-get update

5 Aggiorna i componenti di Zabbix

Per aggiornare i componenti Zabbix puoi eseguire qualcosa come:

# apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

Se usi PostgreSQL, sostituisci mysql con pgsql nel comando. Se aggiornare il proxy, sostituire "server" con "proxy" nel comando. Se aggiornare l'agente Zabbix 2, sostituire zabbix-agentcon zabbix-agent2 nel comando.

Quindi, per aggiornare correttamente il frontend web con Apache, eseguire anche:

# apt-get installa zabbix-apache-conf

Distribuzioni precedenti a Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) non fornisce PHP 7.2 o versioni successive, ovvero richiesto per il frontend Zabbix 5.0. Vedere informazioni su installazione del frontend Zabbix su distribuzioni precedenti.

6 Review component configuration parameters

See the upgrade notes for details on mandatory changes (if any).

For new optional parameters, see the What's new section.

7 Avvia i processi Zabbix

Avvia i componenti Zabbix aggiornati.

# avvio del servizio zabbix-server
       # avvio del servizio zabbix-proxy
       # avvio del servizio zabbix-agent
       # avvio del servizio zabbix-agent2

8 Cancella i cookie e la cache del browser web

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

Upgrade between minor versions

It is possible to upgrade minor versions of 6.0.x (for example, from 6.0.1 to 6.0.3). It is easy.

To upgrade Zabbix minor version please run:

$ sudo apt install --only-upgrade 'zabbix.*'

To upgrade Zabbix server minor version please run:

$ sudo apt install --only-upgrade 'zabbix-server.*'

To upgrade Zabbix agent minor version please run:

$ sudo apt install --only-upgrade 'zabbix-agent.*'

or, for Zabbix agent 2:

$ sudo apt install --only-upgrade 'zabbix-agent2.*'