Esta sección proporciona los pasos requeridos para una actualización exitosa de Zabbix 5.4.x a Zabbix 6.0.x usando 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 todos los proxies deben ser de la misma versión. Por lo tanto, en la configuración de un servidor-proxy , el servidor Zabbix y todos los proxies deben detenerse y actualizarse. Mantener los proxies en ejecución durante la actualización del servidor no generará ningún beneficio ya que durante la actualización del proxy, los datos antiguos se descartarán y no se recopilarán nuevos datos hasta que la configuración del proxy se sincronice con el servidor principal.
Tenga en cuenta que con la base de datos SQLite en proxies, los datos históricos de los proxies antes de la actualización se perderán, porque la actualización de la base de datos SQLite no está soportada y el archivo de la base de datos SQLite debe eliminarse manualmente. Cuándo el proxy se inicia por primera vez y el archivo de base de datos de SQLite no existe, el proxy lo crea automáticamente.
Según el 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.
Antes de la actualización, asegúrese de leer la información relevante ¡notas de actualización!
Están disponibles las siguientes notas de actualización:
Actualizar desde | Leer las notas de actualización completas | Cambios más importantes entre versiones |
---|---|---|
5.4.x | Para: Zabbix 6.0 |
Se actualizaron las versiones mínimas requeridas de la base de datos; El servidor/proxy no se iniciará si la base de datos está desactualizada; Los registros de auditoría se perdieron porque cambió la estructura de base de datos. |
5.2.x | Para: Zabbix 5.4 Zabbix 6.0 |
Se actualizaron las versiones mínimas requeridas de la base de datos; Los elementos agregados se eliminaron como un tipo separado. |
5.0.x LTS | Para: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
La versión mínima requerida de PHP se actualizó de 7.2.0 a 7.2.5. |
4.4.x | Para: Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Se eliminó la compatibilidad con IBM DB2; Se actualizó la versión mínima requerida de PHP de 5.4.0 a 7.2.0; Se actualizó la versión mínima requerida de la base de datos; Se cambió el directorio de archivos PHP de Zabbix. |
4.2.x | Para: Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Jabber, Ez Texting tipos de medios eliminados. |
4.0.x LTS | Para: Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Los proxies más antiguos ya no pueden enviar datos a un servidor actualizado; Los agentes más nuevos ya no podrán trabajar con un servidor Zabbix más antiguo. |
3.4.x | Para: Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Las bibliotecas 'libpthread' y 'zlib' ahora son obligatorias; El soporte para el protocolo de texto sin formato y el encabezado son obligatorios; Los agentes Zabbix de la versión anterior a la 1.4 ya no son compatibles;<br >El parámetro Server en la configuración del proxy pasivo ahora es obligatorio. |
3.2.x | Para: Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Compatibilidad con SQLite como base de datos principal eliminada para servidor/frontend Zabbix; Expresiones regulares compatibles con Perl (PCRE) admitidas en lugar de POSIX extendido; Bibliotecas 'libpcre' y 'libevent' obligatorias para Servidor Zabbix; Comprobaciones de código de salida fueron agregadas para losparámetros de usuario, comandos remotos y métricas system.run[] sin el indicador 'nowait', así como scripts ejecutados por el servidor Zabbix; La puerta de enlace Zabbix Java debe actualizarse para soportar la nueva funcionalidad. |
3.0.x LTS | Para: Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
La actualización de la base de datos puede ser lenta, según el tamaño de la tabla de historial. |
2.4.x | Para: Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Versión PHP mínima requerida actualizada de 5.3.0 a 5.4.0 Se debe especificar el parámetro LogFile del agente |
2.2.x LTS | Para: Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Supervisión distribuida basada en nodos eliminada |
2.0.x | Para: Zabbix 2.2 Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
La versión mínima requerida de PHP se actualizó de 5.1.6 a 5.3.0; Se requiere una base de datos MySQL que distingue entre mayúsculas y minúsculas para que el servidor funcione correctamente; Se requiere la intercalación del conjunto de caracteres utf8 y utf8_bin para que el servidor Zabbix funcione correctamente con la base de datos MySQL. Consulte los scripts de creación de bases de datos. Se requiere la extensión de PHP 'mysqli' en lugar de 'mysql' |
También es posible que desee comprobar los requisitos para 6.0.
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 la otra. Por ejemplo, ejecute tail -f zabbix_server.log
o tail -f zabbix_proxy.log
en la segunda sesión SSH que le ira mostrando las últimas entradas del archivo de log y posibles errores en tiempo real. Esto puede ser crítico para las instancias de producción.
Detenga el servidor Zabbix para asegurarse de que no se inserten nuevos datos en base de datos.
Si actualiza el proxy Zabbix, detenga el proxy también.
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).
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:
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.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 los 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 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 los paquetes de Zabbix.
Luego, actualice la información del repositorio:
Para actualizar los componentes de Zabbix, puede ejecutar algo como:
Si utiliza PostgreSQL, sustituya mysql
por pgsql
en el comando. Si está actualizando el proxy, sustituya server
por proxy
en el comando. Si está actualizando el agente 2 de Zabbix, sustituya zabbix-agent
por zabbix-agent2
en el comando.
Luego, para actualizar correctamente la interfaz web con Apache, ejecute también:
::: noteimportant Actualizar Zabbix Agent 2 con el comando apt install zabbix-agent2
podría provocar un error. Para obtener más información, consulte los Problemas conocidos .:::
Luego, para actualizar correctamente la interfaz web con Apache, 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 requerido para Zabbix frontend 6.0. Ver la información sobre como instalar la interfaz web de Zabbix en distribuciones más antiguas.
Asegúrese de revisar las Notas de actualización para verificar si se requiere algún cambio en los parámetros de configuración.
Inicie los componentes actualizados de Zabbix.
service zabbix-server start
service zabbix-proxy start
service zabbix-agent start
service zabbix-agent2 start
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.
Es posible actualizar versiones menores de 6.0.x (por ejemplo, desde 6.0.1 a 6.0.3). Es fácil.
Para actualizar la versión menor de Zabbix, ejecute:
Para actualizar la versión menor del servidor Zabbix, ejecute:
Para actualizar la versión menor del agente Zabbix, ejecute:
o, para el agente 2 de Zabbix: