2 Debian/Ubuntu

Descripción general

Esta sección proporciona instrucciones sobre cómo actualizar de Zabbix 6.4.x a la última versión de Zabbix 7.0.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu.

Antes de actualizar, revise las notas de actualización pertinentes y asegúrese de que su sistema cumpla con los requisitos para Zabbix 7.0.

Considere ejecutar dos sesiones SSH paralelas durante la actualización: una para ejecutar los pasos de actualización y otra para monitorear los registros del servidor/proxy. Por ejemplo, ejecute tail -f zabbix_server.log o tail -f zabbix_proxy.log en la segunda sesión para ver las últimas entradas de registro y los posibles errores en tiempo real. Esto puede ser crítico para las instancias de producción.

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

Procedimiento de actualización

1 Detener los procesos de Zabbix

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

systemctl stop zabbix-server

Si actualiza el proxy Zabbix, detenga el proxy también.

systemctl stop zabbix-proxy
2 Realice una copia de seguridad de la base de datos de Zabbix

Realice una copia de seguridad de su base de datos de Zabbix existente para protegerse contra errores de actualización (por ejemplo, problemas de espacio en disco, pérdida de energía o problemas inesperados).

3 Realice una copia de seguridad de los archivos de configuración de Zabbix, los archivos PHP y los binarios de Zabbix

Realice una copia de seguridad de los archivos de configuración de Zabbix, los archivos PHP y los binarios de Zabbix existentes.

Para los archivos de configuración, ejecute:

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

Para los archivos PHP y los binarios de Zabbix, ejecute:

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 Zabbix 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/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
       dpkg -i zabbix-release_latest+debian12_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 Zabbix.

En Ubuntu 24.04, ejecute:

wget https://repo.zabbix.com/zabbix/7.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/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Para versiones anteriores de Ubuntu, reemplace el enlace anterior con el correcto del repositorio 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 Zabbix.

Es posible que vea un mensaje sobre la configuración del repositorio 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, ejecute:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • Si utiliza PostgreSQL, reemplace mysql con pgsql en el comando.
  • Si actualiza el proxy, reemplace server con proxy en el comando.
  • Si actualiza el agente Zabbix 2, reemplace zabbix-agent con zabbix-agent2 en el comando.

Actualizar el agente Zabbix 2 con el comando apt install zabbix-agent2 podría generar un error. Para obtener más información, consulte Problemas conocidos.

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) [predeterminado=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 de Zabbix con Apache, ejecute:

apt install zabbix-apache-conf
6 Revise los parámetros de configuración de los componentes

Revise las notas de actualización pertinentes para verificar si es necesario realizar algún cambio en los parámetros de configuración.

Para conocer los nuevos parámetros opcionales, consulte la página Novedades.

7 Iniciar procesos de Zabbix

Iniciar 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 memoria caché del navegador web

Después de la actualización, es posible que deba borrar las cookies y la memoria 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 7.0.x (por ejemplo, de 7.0.1 a 7.0.3).

Primero, actualice la información del repositorio:

apt update

Luego, para actualizar todos los componentes de Zabbix, ejecute:

apt install --only-upgrade 'zabbix*'
  • Para actualizar solo el servidor Zabbix, reemplace 'zabbix*' con 'zabbix-server*' en el comando.
  • Para actualizar solo el proxy Zabbix, reemplace 'zabbix*' con 'zabbix-proxy*' en el comando.
  • Para actualizar solo el agente Zabbix, reemplace 'zabbix*' con 'zabbix-agent*' en el comando.
  • Para actualizar solo el agente Zabbix 2, reemplace 'zabbix*' con 'zabbix-agent2*' en el comando.