1 Aggiornamento dai sorgenti

Panoramica

Questa sezione descrive i passaggi necessari per eseguire correttamente l'upgrade da Zabbix 7.2.x a Zabbix 7.4.x utilizzando le fonti ufficiali di Zabbix.

Prima dell'upgrade, assicurarsi di leggere le note sull'upgrade!

È inoltre consigliabile consultare i requisiti per la versione 7.4.

Durante l'upgrade può essere utile eseguire due sessioni SSH parallele: in una eseguire i passaggi dell'upgrade e nell'altra monitorare i log del server/proxy. Ad esempio, nella seconda sessione SSH eseguire tail -f zabbix_server.log o tail -f zabbix_proxy.log per visualizzare in tempo reale le voci più recenti del file di log e gli eventuali errori. Questo può essere fondamentale per le istanze in produzione.

Processo di aggiornamento del server

1 Arrestare il server

Arrestare il server Zabbix per assicurarsi che non vengano inseriti nuovi dati nel database.

2 Eseguire il backup del database Zabbix esistente

Questo è un passaggio molto importante.
Assicurarsi di disporre di un backup del database.
Sarà utile se la procedura di aggiornamento non riesce (spazio su disco insufficiente, spegnimento, qualsiasi problema imprevisto).

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

Creare una copia di backup dei binari di Zabbix, dei file di configurazione e della directory dei file PHP.

4 Installare i nuovi binari del server

Utilizzare queste istruzioni per compilare il server Zabbix dai sorgenti.

5 Esaminare i parametri di configurazione del server

Assicurarsi di consultare le Note sull'aggiornamento per verificare se sono necessarie modifiche ai parametri di configurazione.

Per i nuovi parametri facoltativi, consultare la pagina Novità.

6 Avviare i nuovi binari di Zabbix

Avviare i nuovi binari. Controllare i file di log per verificare che i binari siano stati avviati correttamente.

Zabbix server aggiornerà automaticamente il database. All'avvio, Zabbix server segnala le versioni attuali (obbligatoria e facoltativa) e le versioni richieste del database. Se la versione obbligatoria attuale è precedente a quella richiesta, Zabbix server esegue automaticamente le patch di aggiornamento del database necessarie. L'avvio e lo stato di avanzamento (percentuale) dell'aggiornamento del database vengono scritti nel file di log di Zabbix server. Al termine dell'aggiornamento, nel file di log viene scritto il messaggio "database upgrade fully completed". Se una delle patch di aggiornamento non viene applicata correttamente, Zabbix server non si avvia. Zabbix server non si avvia neanche se la versione obbligatoria attuale del database è più recente di quella richiesta. Zabbix server si avvia solo se la versione obbligatoria attuale del database corrisponde alla versione obbligatoria richiesta.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Prima di avviare il server:

  • Assicurarsi che l'utente del database disponga di autorizzazioni sufficienti (create table, drop table, create index, drop index)
  • Assicurarsi di avere spazio libero sufficiente sul disco.
7 Installare la nuova interfaccia web di Zabbix

La versione minima richiesta di PHP è la 8.0.0.
Se necessario, eseguire l'aggiornamento e seguire le istruzioni per l'installazione.

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

Processo di aggiornamento del proxy

1 Arresta il proxy

Arresta il proxy Zabbix.

2 Eseguire il backup dei file di configurazione e dei file binari del proxy Zabbix

Crea una copia di backup del binario del proxy Zabbix e del file di configurazione.

3 Installare i nuovi binari del proxy

Utilizzare queste istruzioni per compilare il proxy Zabbix dai sorgenti.

4 Esaminare i parametri di configurazione del proxy

Assicurarsi di consultare le Note sull'aggiornamento per verificare se sono necessarie modifiche ai parametri di configurazione.

Per i nuovi parametri facoltativi, consultare la pagina Novità.

5 Avviare il nuovo proxy Zabbix

Avviare il nuovo proxy Zabbix.
Controllare i file di log per verificare che il proxy sia stato avviato correttamente.

Il proxy Zabbix aggiornerà automaticamente il database.
L'aggiornamento del database avviene in modo analogo all'avvio del server Zabbix.

Processo di aggiornamento dell'agent

L'aggiornamento degli agent non è obbligatorio. È necessario aggiornare gli agent solo se ciò è richiesto per accedere alle nuove funzionalità.

La procedura di aggiornamento descritta in questa sezione può essere utilizzata per aggiornare sia l'agent Zabbix sia l'agent 2 Zabbix.

1 Arrestare l'agent

Ferma Zabbix agent.

2 Eseguire il backup dei file di configurazione e dei file binari dell'agente Zabbix

Crea una copia di backup del binario dell'agente Zabbix e del file di configurazione.

3 Installare i nuovi binari dell'agent

Utilizzare queste istruzioni per compilare l'agent Zabbix dai sorgenti.

In alternativa, è possibile scaricare gli agent Zabbix precompilati dalla pagina di download di Zabbix.

4 Esaminare i parametri di configurazione dell'agent

Assicurarsi di consultare le Note sull'aggiornamento per verificare se sono necessarie modifiche ai parametri di configurazione.

Per i nuovi parametri facoltativi, consultare la pagina Novità.

5 Avviare il nuovo agent Zabbix

Avviare il nuovo agent Zabbix. Controllare i file di log per verificare che l'agent sia stato avviato correttamente.

Aggiornamento tra versioni secondarie

Quando si esegue l'aggiornamento tra versioni secondarie di 7.4.x (ad esempio, dalla 7.4.1 alla 7.4.3), è necessario eseguire le stesse operazioni per server/proxy/agent previste durante l'aggiornamento tra versioni principali. L'unica differenza è che durante l'aggiornamento tra versioni secondarie non vengono apportate modifiche al database.