[comment]: # translation:outdated [comment]: # ({91aab3e5-91aab3e5}) # 2 Debian/Ubuntu [comment]: # ({/91aab3e5-91aab3e5}) [comment]: # ({fac0d1f2-a27e6cdd}) #### Descripción general Esta sección proporciona los pasos necesarios para una [actualización](/manual/installation/upgrade) exitosa de Zabbix **5.4**.x a la última versión de Zabbix **6.0**.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu. 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](/manual/appendix/compatibility). 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. ::: notewarning 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](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|Se eliminaron los tipos de medios Jabber y Ez Texting.| |4.0.x LTS|Para:
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|Los servidores proxy más antiguos ya no pueden informar 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](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)
Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)
Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)
Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)
Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)
Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)
Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)
Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)
Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)
Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)
Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|Se eliminó la monitorización distribuida basada en nodos| |2.0.x |Para:
Zabbix [2.2](https://www.zabbix.com/documentation/2.2/manual/installation/upgrade_notes_220)
Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)
Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)
Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)
Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)
Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)
Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)
Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)
Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)
Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)
Zabbix [5.4](https://www.zabbix.com/ddocumentación/5.4/manual/installation/upgrade_notes_540)
Zabbix [6.0](/manual/installation/upgrade_notes_600)|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 Zabbix funcione correctamente con la base de datos MySQL; 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](/manual/appendix/install/db_scripts#mysql).
Se requiere la extensión PHP 'mysqli' en lugar de 'mysql'| También puede consultar los [requisitos](/manual/installation/requirements) para 6.0. ::: notetip 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](#upgrade-between-minor-versions). [comment]: # ({/fac0d1f2-a27e6cdd}) [comment]: # ({93ff8b03-93ff8b03}) #### Procedimiento de actualización [comment]: # ({/93ff8b03-93ff8b03}) [comment]: # ({6de52e70-f8102233}) ##### 1 Detener los procesos de Zabbix Detener el servidor Zabbix para asegurarse de que no se inserten datos nuevos en la base de datos. systemctl stop zabbix-server Si se actualiza el proxy, el agente o el agente 2 de Zabbix, también se deben detener estos componentes: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 [comment]: # ({/6de52e70-f8102233}) [comment]: # ({ab13a6a4-ab13a6a4}) ##### 2 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. Ayudará si falla el procedimiento de actualización (falta de espacio en disco , apagado, cualquier problema inesperado). [comment]: # ({/ab13a6a4-ab13a6a4}) [comment]: # ({59495358-6c141723}) ##### 3 Copia de seguridad de 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. Archivos de configuración: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ Archivos PHP y binarios de Zabbix: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ [comment]: # ({/59495358-6c141723}) [comment]: # ({a289e18c-1233529b}) ##### 4 Actualizar el paquete de configuración del repositorio Antes de continuar con la actualización, desinstale el paquete de repositorio actual: rm -Rf /etc/apt/sources.list.d/zabbix.list Luego, instale el último paquete de configuración del repositorio para garantizar la compatibilidad con los paquetes más nuevos e incluir los parches de seguridad o correcciones de errores recientes. En **Debian 12**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb En **Debian 11**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb dpkg -i zabbix-release_latest+debian11_all.deb En **Debian 10**, ejecute: wget Español:https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb dpkg -i zabbix-release_latest+debian10_all.deb Para versiones anteriores de Debian, reemplace el enlace anterior con el correcto del [repositorio de Zabbix](https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/). 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](https://www.zabbix.com/download?zabbix=6.0&os_distribution=debian&os_version=9&components=agent&db=&ws=). En **Ubuntu 24.04**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb dpkg -i zabbix-release_latest+ubuntu24.04_all.deb En **Ubuntu 22.04**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb En **Ubuntu 20.04**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb dpkg -i zabbix-release_latest+ubuntu20.04_all.deb En **Ubuntu 18.04**, ejecute: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb dpkg -i zabbix-release_latest+ubuntu18.04_all.deb Para versiones anteriores de Ubuntu, reemplace el enlace anterior con el correcto de [Zabbix repositorio](https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/). 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 los [paquetes de Zabbix](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=16.04&components=agent&db=&ws=). Es posible que vea un mensaje sobre la configuración del repositorio de Zabbix: Archivo de configuración '/etc/apt/sources.list.d/zabbix.list' ==> Eliminado (por usted o por un script) desde la instalación. ==> El distribuidor de paquetes ha enviado una versión actualizada. ¿Qué le gustaría hacer al respecto? Sus opciones son: Y o I : instalar la versión del mantenedor del paquete N u O : mantener la versión instalada actualmente D : mostrar las diferencias entre las versiones Z : iniciar un shell para examinar la situación La acción predeterminada es mantener la versión actual. *** zabbix.list (Y/I/N/O/D/Z) [default=N] ? Ingrese `Y` (o `I`) para instalar la versión del mantenedor del paquete de la configuración del repositorio Zabbix. Luego, actualice la información del repositorio: apt update [comment]: # ({/a289e18c-1233529b}) [comment]: # ({90992efd-08c7383c}) ##### 5 Actualizar los componentes de Zabbix Para actualizar los componentes de Zabbix, puede ejecutar algo como: apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent 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 Zabbix 2, sustituya `zabbix-agent` por `zabbix-agent2` en el comando. ::: noteimportant Actualizar el agente 2 Zabbix con el comando `apt install zabbix-agent2` podría generar un error. Para obtener más información, consulte [*Problemas conocidos*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Puede que aparezca un mensaje sobre la configuración del servidor Zabbix (o proxy): Archivo de configuración '/etc/zabbix/zabbix_server.conf' ==> Modificado (por usted o por un script) desde la instalación. ==> El distribuidor del paquete ha enviado una versión actualizada. ¿Qué le gustaría hacer al respecto? Sus opciones son: Y o I : instalar la versión del mantenedor del paquete N u O : mantener la versión instalada actualmente D : mostrar las diferencias entre las versiones Z : iniciar un shell para examinar la situación La acción predeterminada es mantener la versión actual. *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ? Ingrese la opción que mejor se adapte a su situación. Por ejemplo, ingrese `D` para comparar la configuración actual y la nueva, luego decida si desea instalar la versión del mantenedor del paquete (`Y` o `I`). Luego, para actualizar la interfaz web con Apache correctamente, ejecute también: apt install zabbix-apache-conf Las distribuciones **anteriores a Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** no proporcionan PHP 7.2 o posterior, que es necesario para la interfaz Zabbix 6.0. Consulte [información](/manual/installation/frontend/frontend_on_debian) sobre la instalación de la interfaz Zabbix en distribuciones anteriores. [comment]: # ({/90992efd-08c7383c}) [comment]: # ({e1a215da-fc690fef}) ##### 6 Revisar los parámetros de configuración del componente Asegúrese de revisar las [Notas de actualización](/manual/installation/upgrade_notes_600) para verificar si se requiere algún cambio en los parámetros de configuración. [comment]: # ({/e1a215da-fc690fef}) [comment]: # ({0da8a796-624a8fc7}) ##### 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-agent2 [comment]: # ({/0da8a796-624a8fc7}) [comment]: # ({49e4f43e-49e4f43e}) ##### 8 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. [comment]: # ({/49e4f43e-49e4f43e}) [comment]: # ({f61e51a3-46606e2c}) #### 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). Primero, actualice la información del repositorio: apt update Luego, para actualizar la versión menor de Zabbix, ejecute: apt install --only-upgrade 'zabbix*' Para actualizar solo la versión menor del servidor Zabbix, ejecute: apt install --only-upgrade 'zabbix-server*' Para actualizar solo la versión menor del agente Zabbix, ejecute: apt install --only-upgrade 'zabbix-agent*' o, para el agente Zabbix 2: apt install --only-upgrade 'zabbix-agent2*' [comment]: # ({/f61e51a3-46606e2c})