2 Debian/Ubuntu

Vista general

Aquesta secció proporciona les passes necessàries per a una actualització amb èxit de Zabbix 6.2.x a la darrera versió de Zabbix 6.4.x emprant els paquets oficials de Zabbix per a Debian/Ubuntu.

Abans de l'actualització, assegureu-vos de llegir les notes d'actualització pertinents!

També podeu comprovar els requisits per a 6.4.

Pot ser útil executar dues sessions SSH paral·leles durant l'actualització, executant les passes d'actualització en una i monitorant els registres del servidor/proxy en una altra. Per exemple, executeu tail -f zabbix_server.log o tail -f zabbix_proxy.log a la segona sessió SSH mostrant-vos les darreres entrades del fitxer de registre i possibles errors en temps real. Això pot ser crític per a les instàncies de producció.

Per veure instruccions sobre actualitzar entre versions menors de Zabbix 6.4.x (com ara de 6.4.1 a 6.4.3), veieu actualitzacions entre versions menors.

Procés d'actualització

1 Aturar els processos Zabbix

Atureu el servidor Zabbix per assegurar-vos que no s'insereixin dades noves a la base de dades.

 # systemctl stop zabbix-server

Si actualitzeu el proxy Zabbix, l'agent o l'agent 2, atureu també aquests components:

 # systemctl stop zabbix-proxy
 # systemctl stop zabbix-agent
 # systemctl stop zabbix-agent2
2 Feu una còpia de seguretat de la base de dades Zabbix existent

Aquesta és una passa molt important. Assegureu-vos que teniu una còpia de seguretat de la vostra base de dades. Això ajudarà si el procediment d'actualització falla (manca d'espai al disc, apagat, problemes inesperats).

3 Feu una còpia de seguretat de fitxers de configuració, fitxers PHP i binaris Zabbix

Feu una còpia de seguretat dels fitxers binaris Zabbix, fitxers de configuració i directori de fitxers PHP.

Fitxers de configuració:

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

Arxius PHP i binaris Zabbix :

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
# cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Actualitzeu el paquet de configuració del repositori

Per continuar amb l'actualització, abans cal desinstal·lar el vostre paquet de repositori actual:

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

Tot seguit, instal·leu el nou paquet de configuració del repositori per garantir la compatibilitat amb els nous paquets i incloure qualsevol pedaç de seguretat o de correcció d'errors.

A Debian 12, executeu:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
# dpkg -i zabbix-release_latest+debian12_all.deb

A Debian 11, executeu:

# wget https://repo.zabbix.com/zabbix/6.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb
# dpkg -i zabbix-release_latest+debian11_all.deb

Per a versions de Debian més antigues, canvieu l'enllaç de dalt amb el correcte del repositori de Zabbix. Tanmateix, fixeu-vos que els paquets d'aquestes versions podrien no incloure tots els components de Zabbix. Per obtindre un llistat dels components inclosos, veieu els paquets de Zabbix.

A Ubuntu 24.04, executeu:

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

A Ubuntu 22.04, executeu:

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

A Ubuntu 20.04, executeu:

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

Per a versions d'Ubuntu més antigues, canvieu l'enllaç de dalt amb el correcte del repositori de Zabbix. Tanmateix, fixeu-vos que els paquets d'aquestes versions podrien no incloure tots els components de Zabbix. Per obtindre un llistat dels components inclosos, veieu els paquets de Zabbix.

És possible que veieu un missatge sobre la configuració del dipòsit Zabbix:

# Fitxer de configuració '/etc/apt/sources.list.d/zabbix.list'
# ==> Esborrat (per vós o per un script) des de la instal·lació.
# ==> El distribuïdor de paquets ha enviat una versió actualitzada.
# Què voldríeu fer al respecte?  Les vostres opcions són:
# Y o I : instal·leu la versió del responsable del paquet
# N o O : mantingueu la vostra versió instal·lada actualment
# D: veieu les diferències entre les versions
# Z: inicieu una shell per examinar la situació
# L'acció predeterminada és mantindre la vostra versió actual.
# *** zabbix.list (Y/I/N/O/D/Z) [per defecte=N]?

Trieu "Y" (o "I") per instal·lar la versió del responsable del paquet de la configuració del dipòsit Zabbix.

Després, actualitzeu la informació del repositori:

# apt-get update
5 Actualització dels components de Zabbix

Per actualitzar els components de Zabbix, podeu executar:

 # apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • Si empreu PostgreSQL, substituïu mysql per pgsql a l'ordre.
  • Si sou actualitzant el proxy, substituïu server per proxy a l'ordre.
  • Si sou actualitzant l'agent 2, substituïu zabbix-agent per zabbix-agent2 zabbix-agent2-plugin-* a l'ordre.

Actualitzar el Zabbix agent 2 amb la comanda apt install zabbix-agent2 pot donar error. Per obtindre més informació, veieu els Errors coneguts.

És possible que veieu un missatge sobre la configuració del servidor Zabbix (o proxy):

# Fitxer de configuració '/etc/zabbix/zabbix_server.conf'
# ==> Modificat (per vós o per un script) des de la instal·lació.
# ==> El distribuïdor de paquets ha enviat una versió actualitzada.
# Què voldríeu fer al respecte?  Les opcions són:
# Y o I : instal·leu la versió del responsable del paquet
# N o O : mantingueu la versió instal·lada actualment
# D: veieu les diferències entre les versions
# Z: engegueu una shell per examinar la situació
# L'acció predeterminada és mantindre la versió actual.
# *** zabbix_server.conf (Y/I/N/O/D/Z) [per defecte=N]?

Trieu l'opció que millor s'adapti a la vostra situació. Per exemple, trieu D per comparar la configuració actual i la nova, i després decidiu si voleu instal·lar la versió del responsable del paquet (Y o I).

Tot seguit, actualitzeu la interfície web amb Apache, executant:

 # apt-get install zabbix-apache-conf

Les distribucions anteriors a Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) no tenen PHP7.2 o més nou, que és un requisit per la interfície de Zabbix 5.0 Veieu informació sobre com instal·lar la interfície de Zabbix a distribucions antigues.

6 Reviseu els paràmetres de configuració dels components

Assegureu-vos de revisar les Notes d'actualització per comprovar si cal fer canvis en els paràmetres de configuració.

Per obtindre nous paràmetres opcionals, consulteu la pàgina Novetats.

7 Inici dels processos de Zabbix

Inicieu els components actualitzats de Zabbix.

# systemctl start zabbix-server
# systemctl start zabbix-proxy
# systemctl start zabbix-agent
# systemctl start zabbix-agent2
8 Esborrar galetes i memòria cau del navegador web

Després de l'actualització, és possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web perquè la interfície web de Zabbix funcioni correctament.

Actualització entre versions menors

És possible actualitzar entre versions menors de Zabbix 6.4.x (per exemple, de 6.4.1 a 6.4.3).

Primer, actualitzeu la informació del repositori:

 # apt update

Després, per actualitzar la versió menor de Zabbix, executeu:

 # apt install --only-upgrade 'zabbix.*'

Per actualitzar només la versió menor del servidor Zabbix, executeu:

 # apt install --only-upgrade 'zabbix-server.*'

Per actualitzar només la versió menor de l'agent Zabbix, executeu:

 # apt install --only-upgrade 'zabbix-agent.*'

o, per a l'agent de Zabbix 2:

 # apt install --only-upgrade 'zabbix-agent2.*'