Esta sección proporciona instrucciones para actualizar de Zabbix 7.4.x a la última versión de Zabbix 8.0.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu.

Antes de actualizar, revise las notas de actualización relevantes y asegúrese de que su sistema cumpla con los requisitos para Zabbix 8.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 del registro y posibles errores en tiempo real. Esto puede ser crítico para instancias en producción.

Para obtener instrucciones sobre cómo actualizar entre versiones menores de Zabbix 8.0.x (por ejemplo, de 8.0.1 a 8.0.3), consulte Actualizar entre versiones menores.

Procedimiento de actualización

1 Detener los procesos de Zabbix

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

systemctl stop zabbix-server

Si está actualizando el proxy de Zabbix, el agente o el agente 2, detenga también estos componentes:

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

2 Realizar 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 fallos en la actualización (por ejemplo, problemas de espacio en disco, cortes de energía o problemas inesperados).

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

Haga 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/
# For Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# For Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.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 actual del repositorio de Zabbix:

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

También puede ser necesario eliminar manualmente cualquier paquete antiguo de Zabbix de su directorio de trabajo (por ejemplo, rm zabbix-release_latest+debian12_all.deb) antes de descargar el nuevo, para evitar que el gestor de paquetes reutilice una versión desactualizada durante el proceso de actualización.

A continuación, instale el paquete de configuración del repositorio más reciente para garantizar la compatibilidad con los paquetes más nuevos e incluir cualquier parche de seguridad o corrección de errores reciente.

En Debian 13, ejecute:

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

En Debian 12, ejecute:

wget https://repo.zabbix.com/zabbix/8.0/release/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, sustituya el enlace anterior por el correcto desde el repositorio de Zabbix. Tenga en cuenta, sin embargo, que los paquetes para estas versiones pueden no incluir todos los componentes de Zabbix, y para actualizar esos componentes desde paquetes, considere actualizar su sistema operativo. Para ver una lista de los componentes incluidos, consulte Paquetes de Zabbix.

En Ubuntu 26.04, ejecute:

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

En Ubuntu 24.04, ejecute:

wget https://repo.zabbix.com/zabbix/8.0/release/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/8.0/release/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, sustituya el enlace anterior por el correcto desde el repositorio de Zabbix. Tenga en cuenta, sin embargo, que los paquetes para estas versiones pueden no incluir todos los componentes de Zabbix, y para actualizar esos componentes desde paquetes, considere actualizar su sistema operativo. Para ver una lista de los componentes incluidos, consulte Paquetes de Zabbix.

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

Configuration file '/etc/apt/sources.list.d/zabbix.list'
==> Deleted (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

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

Luego, actualice la información del repositorio:

apt update

5 Actualizar componentes de Zabbix

Para actualizar los componentes de Zabbix, ejecute:

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

Si usa PostgreSQL, reemplace mysql por pgsql en el comando.
Si está actualizando proxy, reemplace server por proxy en el comando.
Si está actualizando Zabbix agent 2, reemplace zabbix-agent por zabbix-agent2 zabbix-agent2-plugin-* en el comando.

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

Es posible que vea un mensaje sobre la configuración de Zabbix server (o proxy):

Configuration file '/etc/zabbix/zabbix_server.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

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

Después, actualice el frontend de Zabbix y reinicie el servidor web.

Para Apache, ejecute:

apt install zabbix-apache-conf
systemctl restart apache2

Para Nginx, ejecute:

apt install zabbix-nginx-conf
systemctl restart nginx

Para Nginx, es posible que vea un mensaje sobre el archivo de configuración nginx.conf. Introduzca la opción que mejor se adapte a su situación:

Configuration file '/etc/zabbix/nginx.conf'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?

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

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

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

Si utiliza Nginx como servidor web y el archivo de configuración /etc/zabbix/nginx.conf se reinstaló durante la actualización, revise el archivo y actualice las directivas listen y server_name para que coincidan con la configuración de su frontend de Zabbix.

7 Iniciar los 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 deba 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 8.0.x (por ejemplo, de 8.0.1 a 8.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*' por 'zabbix-server*' en el comando.
Para actualizar solo el proxy Zabbix, reemplace 'zabbix*' por 'zabbix-proxy*' en el comando.
Para actualizar solo el agente Zabbix, reemplace 'zabbix*' por 'zabbix-agent*' en el comando.
Para actualizar solo el agente Zabbix 2, reemplace 'zabbix*' por 'zabbix-agent2*' en el comando.

What’s next?

Red Hat Enterprise Linux

Docs

Debian/Ubuntu

Descripción general