Documentation
Table of Contents
- 1 Red Hat Enterprise Linux
- Descripción general
- Procedimiento de actualización
- 1 Detener los procesos de Zabbix
- 2 Hacer una copia de seguridad de la base de datos Zabbix existente
- 3 Copia de respaldo de los 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 de Zabbix
- 8 Borrar las cookies y la caché del navegador web
- Actualización entre versiones menores
1 Red Hat Enterprise Linux
Descripción general
Esta sección proporciona los pasos necesarios para una actualización exitosa de Zabbix 5.4.x a la última versión de Zabbix 6.0.x utilizando los paquetes oficiales de Zabbix para Red Hat Enterprise Linux.
Si bien la actualización de los agentes de Zabbix no es obligatoria (pero se recomienda), el servidor Zabbix y los servidores proxy deben ser de la misma versión principal. Por lo tanto, en una configuración de servidor-proxy, el servidor Zabbix y todos los servidores proxy deben detenerse y actualizarse. Mantener los servidores proxy en ejecución durante la actualización del servidor ya no traerá ningún beneficio, ya que durante la actualización del servidor proxy se descartarán sus datos antiguos y no se recopilarán datos nuevos hasta que la configuración del proxy se sincronice con el servidor.
Tenga en cuenta que con la base de datos SQLite en servidores proxy, los datos históricos de los servidores proxy antes de la actualización se perderán, ya que la actualización de la base de datos SQLite no es compatible y el archivo de la base de datos SQLite debe eliminarse manualmente. Cuando se inicia el servidor proxy por primera vez y falta el archivo de la base de datos SQLite, el servidor proxy lo crea automáticamente.
Dependiendo del 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 las notas de actualización pertinentes.
Las siguientes notas de actualización están disponibles:
| Actualizar desde | Leer 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 o proxy no se iniciará si la base de datos está desactualizada; Se perdieron los registros de auditoría debido al cambio en la estructura de la 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ó el soporte de IBM DB2; Se actualizó la versión mínima requerida de PHP de 5.4.0 a 7.2.0; Se actualizaron las versiones mínimas requeridas de la base de datos; Se modificó 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 |
Se eliminaron los tipos de medios Jabber y Ez Texting. |
| 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; Se eliminó la compatibilidad con el protocolo de texto sin formato y el encabezado es obligatorio; Los agentes de Zabbix de versiones anteriores a la 1.4 ya no son compatibles; 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 |
Se eliminó el soporte de SQLite como base de datos back-end para el servidor/front-end de Zabbix; Se admiten expresiones regulares compatibles con Perl (PCRE) en lugar de POSIX extendido; Las bibliotecas 'libpcre' y 'libevent' son obligatorias para el servidor Zabbix; Se agregaron controles de código de salida para parámetros de usuario, comandos remotos y elementos system.run[] sin el indicador 'nowait', así como scripts ejecutados en el servidor Zabbix; La puerta de enlace Java de Zabbix debe actualizarse para admitir 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 del 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 |
La versión mínima requerida de PHP se actualizó de 5.3.0 a 5.4.0 Se debe especificar el parámetro del agente LogFile |
| 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 |
Se eliminó la monitorización distribuida basada en nodos |
| 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 |
Versión mínima requerida de PHP aumentada de 5.1.6 a 5.3.0; Se requiere una base de datos MySQL que distinga entre mayúsculas y minúsculas para que el servidor funcione correctamente; se requiere el conjunto de caracteres utf8 y la intercalación utf8_bin para que el servidor Zabbix funcione correctamente con la base de datos MySQL. Consulte scripts de creación de bases de datos. Se requiere la extensión PHP 'mysqli' en lugar de 'mysql' |
También puede consultar los requisitos para 6.0.
Puede resultar ú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 mostrarle 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 menores de Zabbix 6.0.x (por ejemplo, de 6.0.1 a 6.0.3), consulte Actualización entre versiones menores.
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:
Ya no es posible iniciar el servidor actualizado y hacer que los servidores proxy más antiguos y no actualizados informen los datos a un servidor más nuevo. Este enfoque, que nunca fue recomendado ni respaldado por Zabbix, ahora está oficialmente deshabilitado, ya que el servidor ignorará los datos de los servidores proxy no actualizados.
2 Hacer una copia de seguridad de la base de datos Zabbix existente
Este es un paso muy importante. Asegúrese de que usted tiene una copia de seguridad de su base de datos. Le ayudará si el procedimiento de actualización falla (falta de espacio en el disco, apagón, cualquier problema inesperado).
3 Copia de respaldo de los archivos de configuración, archivos PHP y binarios de Zabbix
Haga una copia de respaldo de los binarios de Zabbix, los archivos de configuración y del directorio de archivos PHP.
Archivos de configuración:
mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/httpd/conf.d/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, actualice el paquete de repositorio actual a la última versión para garantizar la compatibilidad con los paquetes más nuevos e incluir los parches de seguridad o correcciones de errores recientes.
En RHEL 9, ejecute:
En RHEL 8, ejecute:
Para versiones anteriores de RHEL, reemplace el vínculo 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.
Luego, limpie la memoria caché del administrador de paquetes dnf (incluidos los encabezados, metadatos y archivos de paquetes descargados durante instalaciones o actualizaciones anteriores):
En la siguiente operación dnf, dnf descargará metadatos nuevos de los repositorios, ya que los metadatos antiguos se borrarán.
Consulte también: Problemas conocidos para actualizar el paquete de configuración del repositorio en RHEL.
5 Actualizar 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 actualiza el proxy, sustituya server por proxy en el comando. Si actualiza el agente 2, sustituya zabbix-agent por zabbix-agent2 en el comando.
Actualizar el agente 2 de Zabbix con el comando dnf install zabbix-agent2 podría generar un error. Para obtener más información, consulte Problemas conocidos.
Para actualizar correctamente la interfaz web con Apache, ejecute también:
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.
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.0.x (por ejemplo, de 6.0.1 a 6.0.3).
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 2 de Zabbix: