Documentation
Table of Contents
- Descripción general
- Procedimiento de actualización
- 1 Detener los procesos de Zabbix
- 2 Copia de seguridad de la base de datos Zabbix existente
- 3 Copia de seguridad de archivos de configuración, 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 del componente
- 7 Iniciar procesos 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 los pasos necesarios para una actualización exitosa de Zabbix 6.2.x a la última versión de Zabbix 6.4.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu.
Antes de la actualización, asegúrese de leer las notas de actualización relevantes.
También puede consultar los requisitos para 6.4.
Puede ser útil ejecutar dos sesiones SSH paralelas durante la actualización, ejecutando los pasos de actualización en una y monitoreando los registros del servidor/proxy en otra. Por ejemplo, ejecute tail -f zabbix_server.log o tail -f zabbix_proxy.log en la segunda sesión SSH para ver las últimas entradas del archivo de registro y los posibles errores en tiempo real. Esto puede ser fundamental para las instancias de producción.
Para obtener instrucciones sobre cómo actualizar entre versiones secundarias de Zabbix 6.4.x (por ejemplo, de 6.4.1 a 6.4.3), consulte Actualizar entre versiones secundarias.
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.
Si se actualiza el proxy, el agente o el agente 2 de Zabbix, también se deben detener estos componentes:
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:
4 Actualizar el paquete de configuración del repositorio
Antes de continuar con la actualización, desinstale el paquete de repositorio actual:
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.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
# dpkg -i zabbix-release_latest+debian12_all.debEn Debian 11, ejecute:
# 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.debPara versiones anteriores de Debian, 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 Paquetes de Zabbix.
En Ubuntu 24.04, ejecute:
# 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.debEn Ubuntu 22.04, ejecute:
# 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.debEn Ubuntu 20.04, ejecute:
# 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.debPara versiones anteriores de Ubuntu, 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.
Es posible que aparezca 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 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 su 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 su 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:
5 Actualizar los componentes de Zabbix
Para actualizar los componentes de Zabbix, puede ejecutar algo como:
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.
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 su 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 su 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:
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 5.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.
Para conocer nuevos parámetros opcionales, consulte la página Novedades.
7 Iniciar procesos 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 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.4.x (por ejemplo, de 6.4.1 a 6.4.3).
Primero, actualice la información del repositorio:
Luego, para actualizar la versión menor de Zabbix, ejecute:
Para actualizar solo la versión menor del servidor Zabbix, ejecute:
Para actualizar solo la versión menor del agente Zabbix, ejecute:
o, para el agente Zabbix 2: