[comment]: # translation:outdated

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

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

[comment]: # ({7a4a680b-a27e6cdd})
#### Visão geral 

Esta seção fornece os passos necessários para uma atualização bem-sucedida do [upgrade](/manual/installation/upgrade) do Zabbix **5.4**.x para o Zabbix **6.0**.x usando os pacotes oficiais do Zabbix para Debian/Ubuntu.
Embora a atualização dos agentes do Zabbix não seja obrigatória (mas recomendada), o servidor e os proxies do Zabbix devem ser da mesma versão principal [same major
version](/manual/appendix/compatibility). Portanto, em uma configuração de servidor-proxy, o servidor Zabbix e todos os proxies devem ser interrompidos e atualizados.
Manter os proxies em execução durante a atualização do servidor não trará mais nenhum benefício, pois durante a atualização do proxy seus dados antigos serão descartados e nenhum novo dado será coletado até que a configuração do proxy seja sincronizada com o servidor.
Observe que com o banco de dados SQLite nos proxies, os dados de histórico dos proxies antes da atualização serão perdidos, porque a atualização do banco de dados SQLite não é suportada e o arquivo de banco de dados SQLite deve ser removido manualmente. Quando o proxy é iniciado pela primeira vez e o arquivo de banco de dados SQLite está ausente, o proxy o cria automaticamente.

Dependendo do tamanho do banco de dados, a atualização do banco de dados para a versão 6.0 pode levar bastante tempo.


::: notewarning
Antes da atualização, certifique-se de ler as **notas de atualização!**
:::

As seguintes notas de atualização estão disponíveis:

|Atualização a partir de |Leia as notas de atualização completas|Mudanças mais importantes entre versões|
|--|--|------|
|5.4.x    |Para:<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Versões mínimas necessárias do banco de dados aumentadas;<br>O Server/proxy não será iniciado se o banco de dados estiver desatualizado;<br>Registros de log de auditoria perdidos devido à mudança na estrutura do banco de dados.|
|5.2.x    |Para:<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Versões mínimas necessárias do banco de dados aumentadas;<br>tens de agregação removidos como um tipo separado.|
|5.0.x LTS|Para:<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Versão mínima necessária do PHP aumentada de 7.2.0 para 7.2.5.|
|4.4.x    |Para:<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Suporte ao IBM DB2 removido;<br>ersão mínima necessária do PHP aumentada de 5.4.0 para 7.2.0;<br>ersões mínimas necessárias do banco de dados aumentadas;<br>Diretório de arquivos PHP do Zabbix alterado..|
|4.2.x    |Para:<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Tipos de mídia Jabber e Ez Texting removidos..|
|4.0.x LTS|Para:<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Proxies mais antigos não poderão mais enviar dados para um servidor atualizado;<br>Agentes mais recentes não serão mais capazes de funcionar com um servidor Zabbix mais antigo.|
|3.4.x    |For:<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Bibliotecas 'libpthread' e 'zlib' agora são obrigatórias;<br>Suporte para protocolo de texto simples removido e o cabeçalho é obrigatório;<br>Versões pré-1.4 do Zabbix agentes não são mais suportadas;<br>O parâmetro do servidor na configuração do proxy passivo agora é obrigatório.|
|3.2.x    |Para:<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Suporte do SQLite como banco de dados backend removido para servidor/frontend do Zabbix;<br>Expressões regulares compatíveis com Perl (PCRE) suportadas em vez de POSIX estendido;<br>'Bibliotecas 'libpcre' e 'libevent' obrigatórias para o servidor Zabbix;<br>
Verificações de código de saída adicionadas para parâmetros de usuário, comandos remotos e itens system.run \[\] do Zabbix server sem a flag 'nowait', bem como scripts executados pelo servidor Zabbix;<br>O Java gateway do Zabbix deve ser atualizado para suportar novas funcionalidades.|
|3.0.x LTS|Para:<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.4/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|A atualização do banco de dados pode ser lenta, dependendo do tamanho da tabela de histórico.|
|2.4.x    |Para:<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Aumento da versão mínima do PHP de 5.3.0 para 5.4.0<br>O parâmetro do agente LogFile deve ser especificado|
|2.2.x LTS|For:<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Monitoramento distribuído baseado em nós removido|
|2.0.x    |Para:<br>Zabbix [2.2](https://www.zabbix.com/documentation/2.2/manual/installation/upgrade_notes_220)<br>Zabbix [2.4](https://www.zabbix.com/documentation/2.4/manual/installation/upgrade_notes_240)<br>Zabbix [3.0](https://www.zabbix.com/documentation/3.0/manual/installation/upgrade_notes_300)<br>Zabbix [3.2](https://www.zabbix.com/documentation/3.2/manual/installation/upgrade_notes_320)<br>Zabbix [3.4](https://www.zabbix.com/documentation/3.4/manual/installation/upgrade_notes_340)<br>Zabbix [4.0](https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400)<br>Zabbix [4.2](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_420)<br>Zabbix [4.4](https://www.zabbix.com/documentation/4.2/manual/installation/upgrade_notes_440)<br>Zabbix [5.0](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500)<br>Zabbix [5.2](https://www.zabbix.com/documentation/5.2/manual/installation/upgrade_notes_520)<br>Zabbix [5.4](https://www.zabbix.com/documentation/5.4/manual/installation/upgrade_notes_540)<br>Zabbix [6.0](/manual/installation/upgrade_notes_600)|Aumento da versão mínima do PHP de 5.1.6 para 5.3.0;;<br>Banco de dados MySQL com distinção entre maiúsculas e minúsculas necessário para o funcionamento adequado do servidor; o conjunto de caracteres utf8 e a colação utf8\_bin são necessários para o servidor Zabbix funcionar corretamente com o banco de dados MySQL. Consulte os scripts [database creation scripts](/manual/appendix/install/db_scripts#mysql).<br>Extensão PHP 'mysqli' necessária em vez de 'mysql'|

Você também pode querer verificar os requisitos [requirements](/manual/installation/requirements) para o 6.0.

::: notetip
Pode ser útil executar duas sessões SSH paralelas durante a atualização, executando os passos de atualização em uma e monitorando os logs do servidor/proxy em outra. Por exemplo, execute `tail -f zabbix_server.log` ou `tail -f zabbix_proxy.log` na segunda sessão SSH, mostrando as últimas entradas de log e possíveis erros em tempo real. Isso pode ser crítico para instâncias de produção.
:::

[comment]: # ({/7a4a680b-a27e6cdd})

[comment]: # ({93ff8b03-93ff8b03})
#### Procedimento de atualização

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

[comment]: # ({cc3d8cb3-f8102233})
##### 1 Pare os processos do Zabbix

Pare o servidor Zabbix para garantir que nenhum dado novo seja inserido no banco de dados.

    service zabbix-server stop

Se estiver atualizando o proxy do Zabbix, pare o proxy também.

    service zabbix-proxy stop

[comment]: # ({/cc3d8cb3-f8102233})

[comment]: # ({ab13a6a4-ab13a6a4})
##### 2 Fazer backup do banco de dados do Zabbix

Este é um passo muito importante. Certifique-se de ter um backup do seu banco de dados. Isso ajudará caso o procedimento de atualização falhe (falta de espaço em disco, desligamento inesperado, qualquer problema inesperado).

[comment]: # ({/ab13a6a4-ab13a6a4})

[comment]: # ({59495358-6c141723})
##### 3 Backup dos arquivos de configuração, arquivos PHP e binários do Zabbix

Faça uma cópia de backup dos binários do Zabbix, arquivos de configuração
e do diretório de arquivos PHP.

Arquivos de configuração:

    # mkdir /opt/zabbix-backup/
    # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
    # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

Arquivos PHP e binários do Zabbix:

    # cp -R /usr/share/zabbix/ /opt/zabbix-backup/
    # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/

[comment]: # ({/59495358-6c141723})

[comment]: # ({1d5cbe78-1233529b})
##### 4 Atualizar pacote de configuração do repositório

Para prosseguir com a atualização, seu pacote de repositório atual precisa ser desinstalado.

    rm -Rf /etc/apt/sources.list.d/zabbix.list

Em seguida, instale o novo pacote de configuração do repositório.

No **Debian 12**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-5+debian12_all.deb
    dpkg -i zabbix-release_6.0-5+debian12_all.deb

No **Debian 11**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb
    dpkg -i zabbix-release_6.0-1+debian11_all.deb

No **Debian 10**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
    dpkg -i zabbix-release_6.0-1+debian10_all.deb

On **Debian 9** run:

    wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
    dpkg -i zabbix-release_6.0-1+debian9_all.deb

No **Ubuntu 20.04**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
    dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb

On **Ubuntu 18.04** run:

    wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
    dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb

No **Ubuntu 16.04**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
    dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb

No **Ubuntu 14.04**, execute:

    wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
    dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb

Atualize as informações do repositório.

    apt-get update

[comment]: # ({/1d5cbe78-1233529b})

[comment]: # ({bd33d416-08c7383c})
##### 5 Atualizar os componentes do Zabbix

Para atualizar os componentes do Zabbix, você pode executar algo como:

    apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

Se estiver usando PostgreSQL, substitua `mysql` por `pgsql` no comando.
Se estiver atualizando o proxy, substitua `server` por `proxy` no comando. 
Se estiver atualizando o Zabbix agent 2, substitua`zabbix-agent` por `zabbix-agent2` no comando.

::: noteimportant
Atualizar o Zabbix agent 2 com o comando `apt install zabbix-agent2` pode resultar em um erro.
Para mais informações, consulte [*Known issues*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older).
:::

Em seguida, para atualizar corretamente o frontend da web com o Apache, execute também:

    apt-get install zabbix-apache-conf

Distribuições **anteriores ao Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** não fornecem PHP 7.2 ou mais recente, que é necessário para o frontend do Zabbix 6.0.
Consulte informações [information](/manual/installation/frontend/frontend_on_debian) sobre como instalar o frontend do Zabbix em distribuições mais antigas.

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

[comment]: # ({e1a215da-fc690fef})
##### 6 Revisar parâmetros de configuração dos componentes

Certifique-se de revisar as [Upgrade notes](/manual/installation/upgrade_notes_600) para verificar se há alguma alteração nos parâmetros de configuração necessários.

[comment]: # ({/e1a215da-fc690fef})

[comment]: # ({44e5c261-624a8fc7})
##### 7 Inicie os processos do Zabbix

Inicie os componentes do Zabbix atualizados.

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

[comment]: # ({/44e5c261-624a8fc7})

[comment]: # ({49e4f43e-49e4f43e})
##### 8 Limpe os cookies e cache do navegador

Após a atualização pode ser necessário limpar os cookies e o cache do 
navegador para que a interface web do Zabbix funcione corretamente.

[comment]: # ({/49e4f43e-49e4f43e})

[comment]: # ({34a79976-46606e2c})
#### Atualização entre versão secundárias

É possível atualizar versões secundárias do Zabbix 6.0.x (por exemplo,
de 6.0.1 para 6.0.3). A atualização entre versões secundárias é fácil.

Para atualizar a versão secundária do Zabbix, execute:

    $ sudo apt install --only-upgrade 'zabbix.*'

Para atualizar a versão secundária do Zabbix Server, execute:

    $ sudo apt install --only-upgrade 'zabbix-server.*'

Para atualizar a versão secundária do Zabbix Agent, utilize:

    $ sudo apt install --only-upgrade 'zabbix-agent.*'

ou, para Zabbix Agent 2:

    $ sudo apt install --only-upgrade 'zabbix-agent2.*'

[comment]: # ({/34a79976-46606e2c})
