[comment]: # translation:outdated

[comment]: # ({91aab3e5-91aab3e5})
#2 Debian/Ubuntu

[comment]: # ({/91aab3e5-91aab3e5})

[comment]: # ({9e784714-d02acea9})
#### Descripción general

Esta sección proporciona los pasos necesarios para una
[actualización](/manual/installation/upgrade) exitosa de Zabbix **6.2**.x a la última versión de Zabbix
**6.4**.x utilizando los paquetes oficiales de Zabbix para Debian/Ubuntu.

::: notewarning
Antes de la actualización, asegúrese de leer las
[**notas de actualización**](/manual/installation/upgrade_notes_640) relevantes.
:::

También puede consultar los
[requisitos](/manual/installation/requirements) para 6.4.

::: notetip
Puede ser ú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 ver 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 secundarias de Zabbix 6.4.x (por ejemplo, de 6.4.1 a 6.4.3), consulte [Actualizar entre versiones secundarias](#upgrade-between-minor-versions).

[comment]: # ({/9e784714-d02acea9})

[comment]: # ({93ff8b03-93ff8b03})
#### Procedimiento de actualización

[comment]: # ({/93ff8b03-93ff8b03})

[comment]: # ({d72abfc3-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]: # ({/d72abfc3-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]: # ({1809f839-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]: # ({/1809f839-6c141723})

[comment]: # ({9015eb72-31c75b55})
##### 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.4/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.4/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb
    # dpkg -i zabbix-release_latest+debian11_all.deb

Para versiones anteriores de Debian, reemplace el enlace anterior con el correcto de [Zabbix repositorio](https://repo.zabbix.com/zabbix/6.4/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.4&os_distribution=debian&os_version=10&components=agent&db=&ws=).

En **Ubuntu 24.04**, ejecute:

    # wget https://repo.zabbix.com/zabbix/6.4/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.4/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.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb
    # dpkg -i zabbix-release_latest+ubuntu20.04_all.deb

Para versiones anteriores de Ubuntu, reemplace el enlace anterior con el correcto del [repositorio de Zabbix](https://repo.zabbix.com/zabbix/6.4/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 [paquetes de Zabbix](https://www.zabbix.com/download?zabbix=6.4&os_distribution=ubuntu&os_version=18.04&components=agent&db=&ws=).

Es posible que aparezca un mensaje sobre la configuración del repositorio 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 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 su 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 su 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]: # ({/9015eb72-31c75b55})

[comment]: # ({ab5457da-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 Zabbix 2 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 su 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 su 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 5.0.
Consulte [información](/manual/installation/frontend/frontend_on_rhel7) sobre la instalación de la interfaz Zabbix en distribuciones anteriores.

[comment]: # ({/ab5457da-08c7383c})

[comment]: # ({48dad00b-455f4e97})
##### 6 Revisar los parámetros de configuración del componente

Asegúrese de revisar las [Notas de actualización](/manual/installation/upgrade_notes_640) para verificar si se requiere algún cambio en los parámetros de configuración.

Para conocer nuevos parámetros opcionales, consulte la página [Novedades](/manual/introduction/whatsnew640).

[comment]: # ({/48dad00b-455f4e97})

[comment]: # ({3190fa72-624a8fc7})
##### 7 Iniciar procesos Zabbix

Inicie los componentes actualizados de Zabbix.

    # systemctl start zabbix-server
    # systemctl start zabbix-proxy
    # systemctl start zabbix-agent
    # systemctl start zabbix-agent2

[comment]: # ({/3190fa72-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]: # ({81c1418d-9bab02f2})
#### Actualización entre versiones menores

Es posible actualizar entre versiones menores de Zabbix 6.4.x (por ejemplo, de 6.4.1 a 6.4.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]: # ({/81c1418d-9bab02f2})
