2 Debian/Ubuntu

Descripción general

Esta sección proporciona los pasos necesarios para una actualización exitosa de Zabbix 5.4.x a la última versión de Zabbix 6.0.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu.

Si bien la actualización de los agentes de Zabbix no es obligatoria (pero se recomienda), el servidor Zabbix y los servidores proxy deben ser de la misma versión principal. Por lo tanto, en una configuración de servidor-proxy, el servidor Zabbix y todos los servidores proxy deben detenerse y actualizarse. Mantener los servidores proxy en ejecución durante la actualización del servidor ya no traerá ningún beneficio, ya que durante la actualización del servidor proxy se descartarán sus datos antiguos y no se recopilarán datos nuevos hasta que la configuración del proxy se sincronice con el servidor.

Tenga en cuenta que con la base de datos SQLite en servidores proxy, los datos históricos de los servidores proxy antes de la actualización se perderán, ya que la actualización de la base de datos SQLite no es compatible y el archivo de la base de datos SQLite debe eliminarse manualmente. Cuando se inicia el servidor proxy por primera vez y falta el archivo de la base de datos SQLite, el servidor proxy lo crea automáticamente.

Dependiendo del tamaño de la base de datos, la actualización de la base de datos a la versión 6.0 puede tardar mucho tiempo.

Las siguientes notas de actualización están disponibles:

También puede consultar los requisitos para 6.0.

Para obtener instrucciones sobre cómo actualizar entre versiones menores de Zabbix 6.0.x (por ejemplo, de 6.0.1 a 6.0.3), consulte Actualización entre versiones menores.

Procedimiento de actualización

1 Detener los procesos de Zabbix

Detener el servidor Zabbix para asegurarse de que no se inserten datos nuevos en la base de datos.

systemctl stop zabbix-server

Si se actualiza el proxy, el agente o el agente 2 de Zabbix, también se deben detener estos componentes:

systemctl stop zabbix-proxy
       systemctl stop zabbix-agent
       systemctl stop zabbix-agent2

2 Copia de seguridad de la base de datos Zabbix existente

Este es un paso muy importante. Asegúrese de tener una copia de seguridad de su base de datos. Ayudará si falla el procedimiento de actualización (falta de espacio en disco , apagado, cualquier problema inesperado).

3 Copia de seguridad de archivos de configuración, archivos PHP y binarios de Zabbix

Haga una copia de seguridad de los binarios de Zabbix, los archivos de configuración y el directorio de archivos PHP.

Archivos de configuración:

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

Archivos PHP y binarios de Zabbix:

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

4 Actualizar el paquete de configuración del repositorio

Antes de continuar con la actualización, desinstale el paquete de repositorio actual:

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

Luego, instale el último paquete de configuración del repositorio para garantizar la compatibilidad con los paquetes más nuevos e incluir los parches de seguridad o correcciones de errores recientes.

En Debian 12, ejecute:

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

En Debian 11, ejecute:

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

En Debian 10, ejecute:

wget Español:https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb
       dpkg -i zabbix-release_latest+debian10_all.deb

Para versiones anteriores de Debian, reemplace el enlace anterior con el correcto del repositorio de Zabbix. Sin embargo, tenga en cuenta que los paquetes para esas versiones pueden no incluir todos los componentes de Zabbix. Para obtener una lista de los componentes incluidos, consulte paquetes de Zabbix.

En Ubuntu 24.04, ejecute:

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

En Ubuntu 22.04, ejecute:

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

En Ubuntu 20.04, ejecute:

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

En Ubuntu 18.04, ejecute:

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

Para versiones anteriores de Ubuntu, reemplace el enlace anterior con el correcto de Zabbix repositorio. Sin embargo, tenga en cuenta que los paquetes para esas versiones pueden no incluir todos los componentes de Zabbix. Para obtener una lista de los componentes incluidos, consulte los paquetes de Zabbix.

Es posible que vea un mensaje sobre la configuración del repositorio de Zabbix:

Archivo de configuración '/etc/apt/sources.list.d/zabbix.list'
       ==> Eliminado (por usted o por un script) desde la instalación.
       ==> El distribuidor de paquetes ha enviado una versión actualizada.
       ¿Qué le gustaría hacer al respecto? Sus opciones son:
       Y o I : instalar la versión del mantenedor del paquete
       N u O : mantener la versión instalada actualmente
       D : mostrar las diferencias entre las versiones
       Z : iniciar un shell para examinar la situación
       La acción predeterminada es mantener la versión actual.
       *** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Ingrese Y (o I) para instalar la versión del mantenedor del paquete de la configuración del repositorio Zabbix.

Luego, actualice la información del repositorio:

apt update

5 Actualizar los componentes de Zabbix

Para actualizar los componentes de Zabbix, puede ejecutar algo como:

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

Si usa PostgreSQL, sustituya mysql por pgsql en el comando. Si actualiza el proxy, sustituya server por proxy en el comando. Si actualiza el agente Zabbix 2, sustituya zabbix-agent por zabbix-agent2 en el comando.

Puede que aparezca un mensaje sobre la configuración del servidor Zabbix (o proxy):

Archivo de configuración '/etc/zabbix/zabbix_server.conf'
       ==> Modificado (por usted o por un script) desde la instalación.
       ==> El distribuidor del paquete ha enviado una versión actualizada.
       ¿Qué le gustaría hacer al respecto? Sus opciones son:
       Y o I : instalar la versión del mantenedor del paquete
       N u O : mantener la versión instalada actualmente
       D : mostrar las diferencias entre las versiones
       Z : iniciar un shell para examinar la situación
       La acción predeterminada es mantener la versión actual.
       *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Ingrese la opción que mejor se adapte a su situación. Por ejemplo, ingrese D para comparar la configuración actual y la nueva, luego decida si desea instalar la versión del mantenedor del paquete (Y o I).

Luego, para actualizar la interfaz web con Apache correctamente, ejecute también:

apt install zabbix-apache-conf

Las distribuciones anteriores a Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) no proporcionan PHP 7.2 o posterior, que es necesario para la interfaz Zabbix 6.0. Consulte información sobre la instalación de la interfaz Zabbix en distribuciones anteriores.

6 Revisar los parámetros de configuración del componente

Asegúrese de revisar las Notas de actualización para verificar si se requiere algún cambio en los parámetros de configuración.

7 Iniciar procesos de Zabbix

Inicie los componentes actualizados de Zabbix.

systemctl start zabbix-server
       systemctl start zabbix-proxy
       systemctl start zabbix-agent
       systemctl start zabbix-agent2

8 Borrar las cookies y la caché del navegador web

Después de la actualización, es posible que tenga que borrar las cookies y la caché del navegador web para que la interfaz web de Zabbix funcione correctamente.

Actualización entre versiones menores

Es posible actualizar entre versiones menores de Zabbix 6.0.x (por ejemplo, de 6.0.1 a 6.0.3).

Primero, actualice la información del repositorio:

apt update

Luego, para actualizar la versión menor de Zabbix, ejecute:

apt install --only-upgrade 'zabbix*'

Para actualizar solo la versión menor del servidor Zabbix, ejecute:

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

Para actualizar solo la versión menor del agente Zabbix, ejecute:

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

o, para el agente Zabbix 2:

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