Actualización desde fuentes

Descripción general

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

¡Antes de la actualización asegúrese de leer las notas de actualización relevantes!

También puede revisar los requisitos para 8.0.

Puede ser útil ejecutar dos sesiones SSH en paralelo durante la actualización, ejecutando los pasos de actualización en una y monitoreando los logs 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 log y posibles errores en tiempo real. Esto puede ser crítico para instancias en producción.

Proceso de actualización del servidor

1 Detener el servidor

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

2 Realice una 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. Esto será de ayuda si el procedimiento de actualización falla (falta de espacio en disco, corte de energía, cualquier problema inesperado).

3 Realizar una copia de seguridad de los 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.

4 Instalar los nuevos binarios del servidor

Utilice estas instrucciones para compilar el servidor Zabbix desde las fuentes.

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. Revise los archivos de registro para comprobar si los binarios se han iniciado correctamente.

El servidor Zabbix actualizará automáticamente la base de datos. Al iniciarse, el servidor Zabbix informa de las versiones actuales (obligatoria y opcional) y requeridas de la base de datos. Si la versión obligatoria actual es anterior a la versión requerida, el servidor Zabbix 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 del servidor Zabbix. Cuando la actualización se completa, se escribe un mensaje "actualización de la base de datos completada completamente" en el archivo de registro. Si alguno de los parches de actualización falla, el servidor Zabbix no se iniciará. El servidor Zabbix tampoco se iniciará si la versión obligatoria actual de la base de datos es más reciente que la requerida. El servidor Zabbix 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 servidor:

  • Asegúrese de que el usuario de la base de datos tenga suficientes permisos (crear tabla, eliminar tabla, crear índice, eliminar índice)
  • Asegúrese de tener suficiente espacio libre en disco.
7 Instale la nueva interfaz web de Zabbix

La versión mínima requerida de PHP es 8.2.0. Actualice 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 desde las fuentes.

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

Asegúrese de revisar las Notas de actualización 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.

5 Iniciar el nuevo proxy de Zabbix

Inicie el nuevo proxy de Zabbix. Revise los archivos de registro para ver 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 manera similar a cuando se inicia el servidor de Zabbix.

Proceso de actualización del agente

Actualizar los agentes no es obligatorio. Solo necesita actualizar los agentes 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 agente de Zabbix como el agente de Zabbix 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 los nuevos binarios del agent

Utilice estas instrucciones para compilar el agent de Zabbix desde las fuentes.

Alternativamente, puede descargar los 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 los nuevos parámetros opcionales, consulte la página Novedades.

5 Iniciar el nuevo agente de Zabbix

Inicie el nuevo agente de Zabbix. Revise los archivos de registro para ver si el agente 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 servidor/proxy/agente que durante la actualización entre versiones mayores. La única diferencia es que al actualizar entre versiones menores no se realizan cambios en la base de datos.