Table of Contents
- 2 Debian/Ubuntu
- Descripción general
- Procedimiento de actualización
- 1 Detener los procesos de Zabbix
- 2 Realizar una copia de seguridad de la base de datos de Zabbix
- 3 Realizar una copia de seguridad de los archivos de configuración de Zabbix, archivos PHP y binarios de Zabbix
- 4 Actualizar el paquete de configuración del repositorio
- 5 Actualizar los componentes de Zabbix
- 6 Revisar los parámetros de configuración de los componentes
- 7 Iniciar los procesos de Zabbix
- 8 Borrar las cookies y la caché del navegador web
- Actualización entre versiones menores
2 Debian/Ubuntu
Descripción general
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:
Si está actualizando el proxy de Zabbix, el agente o el agente 2, detenga también estos componentes:
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 Realizar una copia de seguridad de los archivos de configuración de Zabbix, archivos PHP y binarios de Zabbix
Realice una copia de seguridad de los archivos de configuración existentes de Zabbix, archivos PHP y binarios de Zabbix.
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:
4 Actualizar el paquete de configuración del repositorio
Antes de proceder con la actualización, desinstale su paquete actual del repositorio de Zabbix:
También puede que necesite 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 obsoleta durante el proceso de actualización.
Luego, instale el paquete de configuración del repositorio más reciente para garantizar la compatibilidad con los paquetes más nuevos y para incluir cualquier parche de seguridad o corrección de errores reciente.
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.debPara versiones anteriores de Debian, reemplace el enlace anterior por el correcto desde el repositorio de Zabbix. Sin embargo, tenga en cuenta 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 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.debEn 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.debPara versiones anteriores de Ubuntu, reemplace el enlace anterior por el correcto desde el repositorio de Zabbix. Sin embargo, tenga en cuenta 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.
Puede ver un mensaje 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] ?Ingrese 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:
5 Actualizar los componentes de Zabbix
Para actualizar los componentes de Zabbix, ejecute:
- Si utiliza PostgreSQL, reemplace
mysqlporpgsqlen el comando. - Si actualiza un proxy, reemplace
serverporproxyen el comando. - Si actualiza Zabbix agent 2, reemplace
zabbix-agentporzabbix-agent2 zabbix-agent2-plugin-*en el comando.
Actualizar Zabbix agent 2 con el comando apt install zabbix-agent2 podría provocar un error. Para más información, consulte Problemas conocidos.
Puede que vea un mensaje sobre la configuración del servidor (o proxy) de Zabbix:
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).
Luego, para actualizar el frontend de Zabbix con Apache y reiniciar Apache, ejecute:
6 Revisar los parámetros de configuración de los componentes
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.
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-agent28 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:
Luego, para actualizar todos los componentes de Zabbix, ejecute:
- 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.