Red Hat Enterprise Linux

Descripción general

Esta sección proporciona instrucciones para actualizar de Zabbix 7.4.x a la última versión de Zabbix 8.0.x utilizando los paquetes oficiales de Zabbix para Red Hat Enterprise Linux o sus derivados: AlmaLinux, CentOS Stream, Oracle Linux y Rocky Linux.

Antes de actualizar, revise las notas de actualización correspondientes y asegúrese de que su sistema cumpla con los requisitos para Zabbix 8.0.

Considere ejecutar dos sesiones SSH en paralelo durante la actualización: una para ejecutar los pasos de actualización y otra para monitorizar los registros del servidor/proxy. Por ejemplo, ejecute tail -f zabbix_server.log o tail -f zabbix_proxy.log en la segunda sesión para ver las últimas entradas del registro y posibles errores en tiempo real. Esto puede ser crítico para instancias en producción.

Para obtener instrucciones sobre cómo actualizar entre versiones menores de Zabbix 8.0.x (por ejemplo, de 8.0.1 a 8.0.3), consulte Actualizar entre versiones menores.

Procedimiento de actualización

1 Detener los procesos de Zabbix

Detenga el servidor Zabbix para asegurarse de que no se inserten nuevos datos en la base de datos:

systemctl stop zabbix-server

Si está actualizando el proxy Zabbix, el agente o el agente 2, detenga también estos componentes:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Realizar una copia de seguridad de la base de datos de Zabbix

Realice una copia de seguridad de su base de datos de Zabbix existente para protegerse contra fallos en la actualización (por ejemplo, problemas de espacio en disco, cortes de energía o problemas inesperados).

3 Realizar una copia de seguridad de los archivos de configuración de Zabbix, archivos PHP y binarios de Zabbix

Realice una copia de seguridad de los archivos de configuración existentes de Zabbix, archivos PHP y binarios de Zabbix.

Para los archivos de configuración, ejecute:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

Para los archivos PHP y los binarios de Zabbix, ejecute:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Actualizar el paquete de configuración del repositorio

Antes de continuar con la actualización, actualice el paquete de configuración del repositorio actual a la versión más reciente para garantizar la compatibilidad con los paquetes más nuevos e incluir los parches de seguridad o las correcciones de errores recientes.

En RHEL 10, ejecute:

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/10/noarch/zabbix-release-latest.el10.noarch.rpm

Si está actualizando el proxy de Zabbix en RHEL 10 y desea utilizar APM, instale también el repositorio EPEL y habilite el repositorio CRB, ya que ambos proporcionan dependencias para el paquete APM del proxy de Zabbix:

dnf -y install epel-release || dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm
crb enable

En RHEL 9, ejecute:

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/9/noarch/zabbix-release-latest.el9.noarch.rpm

Para versiones anteriores de RHEL o sus derivados, sustituya el enlace anterior por el correcto de Zabbix repository. Tenga en cuenta, sin embargo, que los paquetes para estas versiones pueden no incluir todos los componentes de Zabbix. Para actualizar dichos componentes mediante paquetes, considere actualizar el sistema operativo. Para consultar la lista de componentes incluidos, vea Zabbix packages.

A continuación, limpie la caché del gestor de paquetes dnf (incluidos los encabezados, los metadatos y los archivos de paquetes descargados durante instalaciones o actualizaciones anteriores):

dnf clean all

En la siguiente operación de dnf, dnf descargará metadatos nuevos de los repositorios, ya que se han eliminado los metadatos antiguos.

Consulte también: Known issues para actualizar el paquete de configuración del repositorio en RHEL.

5 Actualizar los componentes de Zabbix

Para actualizar los componentes de Zabbix, ejecute:

dnf install zabbix-server-mysql zabbix-web-mysql zabbix-selinux-policy zabbix-agent
  • Si utiliza PostgreSQL, sustituya mysql por pgsql en el comando.
  • Si está actualizando el proxy, sustituya server por proxy en el comando.
  • Si tiene RHEL 10 y desea utilizar APM, añada -apm al nombre del paquete del proxy (por ejemplo, zabbix-proxy-mysql-apm).
  • Si está actualizando el agent 2, sustituya zabbix-agent por zabbix-agent2 zabbix-agent2-plugin-* en el comando.
  • Si tiene instalados otros paquetes de Zabbix, considere actualizarlos también incluyéndolos 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 Problemas conocidos.

A continuación, para actualizar el frontend de Zabbix con Apache y reiniciar Apache, ejecute:

dnf install zabbix-apache-conf
systemctl restart httpd
6 Revisar los parámetros de configuración del componente

Revise las notas de actualización relevantes para comprobar si es necesario realizar algún cambio en los parámetros de configuración.

Para los nuevos parámetros opcionales, consulte la página Novedades.

7 Iniciar los procesos de Zabbix

Inicie los componentes actualizados de Zabbix:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
8 Borrar las cookies y la caché del navegador web

Después de la actualización, es posible que deba 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 8.0.x (por ejemplo, de 8.0.1 a 8.0.3).

Para actualizar todos los componentes de Zabbix, ejecute:

dnf upgrade 'zabbix-*'
  • Para actualizar solo el servidor Zabbix, reemplace 'zabbix-*' por 'zabbix-server-*' en el comando.
  • Para actualizar solo el proxy Zabbix, reemplace 'zabbix-*' por 'zabbix-proxy-*' en el comando.
  • Para actualizar solo el agente Zabbix, reemplace 'zabbix-*' por 'zabbix-agent-*' en el comando.
  • Para actualizar solo el agente Zabbix 2, reemplace 'zabbix-*' por 'zabbix-agent2-*' en el comando.