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 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 Zabbix 6.0.x usando paquetes oficiales de Zabbix para Red Hat Enterprise Linux.
Si bien actualizar los agentes de Zabbix no es obligatorio (pero sí recomendado), el servidor Zabbix y los servidores proxy 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 servidores proxy en ejecución durante la actualización del servidor ya no generará ningún beneficio ya que durante la actualización del proxy sus datos antiguos se descartarán y no se recopilarán nuevos datos 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, porque la actualización de la base de datos SQLite no está soportada y el archivo de base de datos SQLite debe eliminarse manualmente. Cuando el proxy se inicia por primera vez y el archivo de base de datos SQLite no se encuentra, el 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 la información relevante ¡notas de actualización!
Las siguientes notas de actualización están disponibles:
| Actualizar desde | Lea las notas de actualización completas | Cambios más importantes entre versiones |
|---|---|---|
| 5.4.x | Para: Zabbix 6.0 |
Se aumentaron 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 del cambio de estructura de la base de datos. |
| 5.2.x | Para: Zabbix 5.4 Zabbix 6.0 |
Se aumentaron las versiones mínimas requeridas de la base de datos; Se eliminaron los elementos agregados como un tipo separado. |
| 5.0.x LTS | Para: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Versión PHP mínima requerida mejorada 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; La versión mínima requerida de PHP aumentó de 5.4.0 a 7.2.0; Las versiones mínimas requeridas de la base de datos aumentaron; 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. |
| 4.0.x LTS | Para: Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Los servidores proxy 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 |
Bibliotecas 'libpthread' y 'zlib' ahora obligatorias; Se eliminó la compatibilidad con el protocolo de texto sin formato y el encabezado es obligatorio; Los agentes Zabbix anteriores a la versión 1.4 ya no son compatibles; El parámetro Servidor 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ó la compatibilidad con SQLite como base de datos backend para el servidor Zabbix /frontend; 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 verificaciones de código de salida para parámetros de usuario, comandos remotos y sistema .run[] métricas sin el indicador 'nowait', así como scripts ejecutados por el servidor Zabbix; La puerta de enlace Java de Zabbix debe actualizarse para admitir nuevas funciones. |
| 3.0.x LTS | Para: Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4<br >Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Actualización de base de datos puede ser lento, dependiendo del 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 |
Versión PHP mínima requerida actualizada 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<br >Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Se eliminó el monitoreo distribuido basado 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 PHP mínima requerida mejorada de 5.1.6 a 5.3.0; Se requiere una base de datos MySQL que distinga entre mayúsculas y minúsculas para trabajo adecuado del servidor; 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 es posible que desee comprobar los requisitos para 6.0.
Puede resultar útil ejecutar dos sesiones SSH paralelas durante la actualización, ejecutando los pasos de actualización en uno y monitoreando el inicio de sesión del servidor/proxy en otro. Por ejemplo, ejecutar tail -f zabbix_server.log o tail -f zabbix_proxy.log en la segunda sesión SSH que muestra las últimas entradas del archivo de registro y posibles errores en tiempo real. Esto puede ser crítico para las instancias en producción.
Procedimiento de actualización
1 Detener los procesos de Zabbix
Detenga el servidor Zabbix para asegurarse de que no se insertan nuevos datos en la base de datos.
Si se actualiza el proxy, detenga también el proxy.
Ya no es posible iniciar el servidor actualizado y tener proxies más antiguos y no actualizados, que reporten datos a un servidor más reciente. Este enfoque, que nunca fue recomendado ni soportado por Zabbix, ahora está oficialmente deshabilitado, ya que el servidor ignorará los datos de proxies 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 su paquete de repositorio actual. En RHEL 9, ejecute:
(Para versiones anteriores de RHEL, reemplace el enlace anterior por el enlace correcto del repositorio de Zabbix)
5 Actualizar componentes de Zabbix
Para actualizar los componentes de Zabbix, puede ejecutar lo siguiente:
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 2, sustituya zabbix-agent por zabbix-agent2 en el comando.
Actualizar Zabbix Agent 2 con el comando dnf install zabbix-agent2 podría provocar un error. Para obtener más información, consulte los Problemas conocidos.
Para actualizar correctamente la interfaz web con Apache en RHEL 8, 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 6.0.x (por ejemplo, de 6.0.1 a 6.0.3). Actualizar entre versiones menores es fácil.
Para ejecutar la actualización de la versión menor de Zabbix, es necesario ejecutar:
Para ejecutar la actualización de la versión menor del servidor Zabbix, ejecute:
Para ejecutar la actualización de la versión menor del agente Zabbix, ejecute:
o, para el agente 2 de Zabbix: