Documentation
Table of Contents
- 2 Debian/Ubuntu
- 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 Actualice los componentes de Zabbix
- 6 Revisar los parámetros de configuración del componente
- 7 Iniciar 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 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.
Procedimiento de actualización
1 Detener los procesos de Zabbix
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.
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
Para continuar con la actualización, su paquete de repositorio actual debe ser desinstalado.
Luego instale el nuevo paquete de configuración del repositorio.
En Debian 12 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-5+debian12_all.deb
dpkg -i zabbix-release_6.0-5+debian12_all.debEn Debian 11 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb
dpkg -i zabbix-release_6.0-1+debian11_all.debEn Debian 10 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
dpkg -i zabbix-release_6.0-1+debian10_all.debEn Debian 9 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
dpkg -i zabbix-release_6.0-1+debian9_all.debEn Ubuntu 20.04 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.debEn Ubuntu 18.04 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.debEn Ubuntu 16.04 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.debEn Ubuntu 14.04 ejecute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.debActualice la información del repositorio.
5 Actualice los componentes de Zabbix
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.
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.
7 Iniciar procesos de Zabbix
Inicie los componentes actualizados de Zabbix.
service zabbix-server start
service zabbix-proxy start
service zabbix-agent start
service zabbix-agent2 start8 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 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: