Actualización desde fuentes

Descripción general

Esta sección proporciona los pasos necesarios para realizar correctamente una actualización de Zabbix 7.4.x a Zabbix 8.0.x utilizando fuentes oficiales de Zabbix.

Antes de realizar la actualización, asegúrese de leer las notas de actualización correspondientes.

También puede consultar los requisitos de la versión 8.0.

Puede resultar útil ejecutar dos sesiones SSH en paralelo durante la actualización: en una, ejecute los pasos de actualización y, en la otra, supervise los registros del server/proxy. Por ejemplo, ejecute tail -f zabbix_server.log o tail -f zabbix_proxy.log en la segunda sesión SSH para mostrar las entradas más recientes del archivo de registro y los posibles errores en tiempo real. Esto puede ser fundamental en instancias de producción.

Proceso de actualización del servidor

1 Detener el server

Detenga el server de Zabbix para asegurarse de que no se inserten datos nuevos en la base de datos.

2 Realizar una copia de seguridad de la base de datos de Zabbix existente

Este es un paso muy importante.
Asegúrese de tener una copia de seguridad de su base de datos.
Será útil si el procedimiento de actualización falla (falta de espacio en disco, apagado, cualquier problema inesperado).

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

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

4 Instalar los nuevos binarios del server

Utilice estas instrucciones para compilar el server de Zabbix a partir del código fuente.

5 Revisar los parámetros de configuración del server

Asegúrese de revisar las Notas de actualización para comprobar si se requieren cambios en los parámetros de configuración.

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

6 Iniciar los nuevos binarios de Zabbix

Inicie los nuevos binarios.
Compruebe los archivos de registro para verificar que los binarios se hayan iniciado correctamente.

Zabbix server actualizará automáticamente la base de datos.
Al iniciarse, Zabbix server informa de las versiones actuales (obligatoria y opcional) y de las versiones requeridas de la base de datos.
Si la versión obligatoria actual es anterior a la versión requerida, Zabbix server ejecuta automáticamente los parches de actualización de la base de datos necesarios.
El inicio y el nivel de progreso (porcentaje) de la actualización de la base de datos se escriben en el archivo de registro de Zabbix server.
Cuando finaliza la actualización, se escribe el mensaje "database upgrade fully completed" en el archivo de registro.
Si alguno de los parches de actualización falla, Zabbix server no se iniciará.
Zabbix server tampoco se iniciará si la versión obligatoria actual de la base de datos es posterior a la requerida.
Zabbix server solo se iniciará si la versión obligatoria actual de la base de datos corresponde a la versión obligatoria requerida.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Antes de iniciar el server:

  • Asegúrese de que el usuario de la base de datos tenga permisos suficientes (crear tablas, eliminar tablas, crear índices y eliminar índices).
  • Asegúrese de disponer de suficiente espacio libre en disco.
7 Instalar la nueva interfaz web de Zabbix

La versión mínima requerida de PHP es la 8.2.0.
Actualícela si es necesario y siga las instrucciones de instalación.

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.

Proceso de actualización del proxy

1 Detener proxy

Detener el proxy de Zabbix.

2 Realizar una copia de seguridad de los archivos de configuración y binarios del proxy de Zabbix

Haga una copia de seguridad del binario del proxy de Zabbix y del archivo de configuración.

3 Instalar los nuevos binarios del proxy

Utilice estas instrucciones para compilar el proxy de Zabbix a partir del código fuente.

4 Revisar los parámetros de configuración del proxy

Asegúrese de revisar las Notas de actualización para comprobar si se requieren cambios en los parámetros de configuración.

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

5 Iniciar el nuevo proxy de Zabbix

Inicie el nuevo proxy de Zabbix.
Compruebe los archivos de registro para verificar si el proxy se ha iniciado correctamente.

El proxy de Zabbix actualizará automáticamente la base de datos.
La actualización de la base de datos se realiza de forma similar a cuando se inicia el server de Zabbix.

Proceso de actualización del agent

La actualización de los agents no es obligatoria. Solo debe actualizar los agents si es necesario para acceder a la nueva funcionalidad.

El procedimiento de actualización descrito en esta sección puede utilizarse para actualizar tanto el Zabbix agent como el Zabbix agent 2.

1 Detener el agente

Detenga el agente Zabbix.

2 Realice una copia de seguridad de los archivos de configuración y los binarios del agente Zabbix

Haga una copia de seguridad del binario del agente Zabbix y del archivo de configuración.

3 Instalar nuevos binarios del agent

Utilice estas instrucciones para compilar el agent de Zabbix a partir del código fuente.

Como alternativa, puede descargar agents de Zabbix precompilados desde la página de descargas de Zabbix.

4 Revisar los parámetros de configuración del agent

Asegúrese de revisar las Notas de actualización para comprobar si se requieren cambios en los parámetros de configuración.

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

5 Iniciar el nuevo Zabbix agent

Inicie el nuevo Zabbix agent.
Compruebe los archivos de registro para verificar si el agent se ha iniciado correctamente.

Actualización entre versiones menores

Al actualizar entre versiones menores de 8.0.x (por ejemplo, de 8.0.1 a 8.0.3), es necesario ejecutar las mismas acciones para el server/proxy/agent que durante la actualización entre versiones principales. La única diferencia es que, al actualizar entre versiones menores, no se realizan cambios en la base de datos.