[comment]: # ({7900383c-7900383c})
# Atualização a partir do código-fonte

[comment]: # ({/7900383c-7900383c})

[comment]: # ({4ab83dcf-92c7a8e5})
#### Visão geral

Esta seção fornece as etapas necessárias para uma
[atualização](/manual/installation/upgrade) bem-sucedida do Zabbix **7.4**.x para o Zabbix
**8.0**.x usando fontes oficiais do Zabbix.

::: notewarning
Antes da atualização, certifique-se de ler as
[**notas de atualização**](/manual/installation/upgrade) relevantes!
:::

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

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

[comment]: # ({/4ab83dcf-92c7a8e5})

[comment]: # ({101d6faf-101d6faf})
#### Processo de atualização do server

[comment]: # ({/101d6faf-101d6faf})

[comment]: # ({b8308740-b8308740})
##### 1 Parar o servidor

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

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

[comment]: # ({ab13a6a4-ab13a6a4})
##### 2 Faça backup do banco de dados Zabbix existente

Esta é uma etapa muito importante. Certifique-se de que você tem um backup do seu banco de dados. Isso ajudará caso o procedimento de atualização falhe (falta de espaço em disco, desligamento de energia, qualquer problema inesperado).

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

[comment]: # ({d2778675-d2778675})
##### 3 Faça 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.

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

[comment]: # ({10191bc2-2bb75ddd})
##### 4 Instale novos binários do server

Use estas
[instruções](/manual/installation/install/sources#installing-zabbix-daemons)
para compilar o Zabbix server a partir do código-fonte.

[comment]: # ({/10191bc2-2bb75ddd})

[comment]: # ({b743963f-ec6edae7})
##### 5 Revisar os parâmetros de configuração do server

Certifique-se de revisar as [Notas de atualização](/manual/installation/upgrade_notes) para verificar se são necessárias alterações nos parâmetros de configuração.

Para novos parâmetros opcionais, consulte a página [O que há de novo](/manual/whatsnew).

[comment]: # ({/b743963f-ec6edae7})

[comment]: # ({a01e967f-a01e967f})
##### 6 Inicie os novos binários do Zabbix

Inicie os novos binários. Verifique os arquivos de log para ver se os binários foram iniciados com sucesso.

O Zabbix server irá atualizar o banco de dados automaticamente. Ao iniciar, o Zabbix server informa as versões atuais (obrigatórias e opcionais) e as versões exigidas do banco de dados. Se a versão obrigatória atual for mais antiga que a versão exigida, o Zabbix server executa automaticamente os patches de atualização necessários no banco de dados. O início e o nível de progresso (porcentagem) da atualização do banco de dados são registrados no arquivo de log do Zabbix server. Quando a atualização for concluída, uma mensagem "database upgrade fully completed" será registrada no arquivo de log. Se algum dos patches de atualização falhar, o Zabbix server não será iniciado. O Zabbix server também não será iniciado se a versão obrigatória atual do banco de dados for mais recente que a exigida. O Zabbix server só será iniciado se a versão obrigatória atual do banco de dados corresponder à versão obrigatória exigida.

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

Antes de iniciar o server:

-   Certifique-se de que o usuário do banco de dados tenha permissões suficientes (create table, drop table, create index, drop index)
-   Certifique-se de que há espaço livre suficiente em disco.

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

[comment]: # ({7e535690-22e0e4e9})
##### 7 Instale a nova interface web do Zabbix

A versão mínima do PHP necessária é 8.2.0. Atualize se necessário e siga as [instruções de instalação](/manual/installation/frontend).

[comment]: # ({/7e535690-22e0e4e9})

[comment]: # ({49e4f43e-49e4f43e})
##### 8 Limpe os cookies e o 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]: # ({75f5b3ed-75f5b3ed})
#### Processo de atualização do proxy

[comment]: # ({/75f5b3ed-75f5b3ed})

[comment]: # ({f33e6ddb-f33e6ddb})
##### 1 Parar o proxy

Pare o proxy Zabbix.

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

[comment]: # ({2e03c550-2e03c550})
##### 2 Faça backup dos arquivos de configuração e binários do Zabbix proxy

Faça uma cópia de backup do binário do Zabbix proxy e do arquivo de configuração.

[comment]: # ({/2e03c550-2e03c550})

[comment]: # ({2369ed2b-024201dc})
##### 3 Instale os novos binários do proxy

Use estas
[instruções](/manual/installation/install/sources#installing-zabbix-daemons)
para compilar o proxy Zabbix a partir do código-fonte.

[comment]: # ({/2369ed2b-024201dc})

[comment]: # ({3b255488-2fbda571})
##### 4 Revisar os parâmetros de configuração do proxy

Certifique-se de revisar as [Notas de atualização](/manual/installation/upgrade_notes) para verificar se são necessárias alterações nos parâmetros de configuração.

Para novos parâmetros opcionais, consulte a página [O que há de novo](/manual/whatsnew).

[comment]: # ({/3b255488-2fbda571})

[comment]: # ({9177a792-520f43c6})
##### 5 Inicie o novo proxy Zabbix

Inicie o novo proxy Zabbix. Verifique os arquivos de log para ver se o proxy foi iniciado com sucesso.

O proxy Zabbix irá atualizar o banco de dados automaticamente. A atualização do banco de dados ocorre de forma semelhante ao iniciar o [server Zabbix](/manual/installation/upgrade/sources#start-new-zabbix-binaries).

[comment]: # ({/9177a792-520f43c6})

[comment]: # ({59736bba-59736bba})
#### Processo de atualização do agent

::: noteimportant
A atualização dos agents não é obrigatória. Você só precisa
atualizar os agents se for necessário acessar a nova
funcionalidade.
:::

O procedimento de atualização descrito nesta seção pode ser usado para
atualizar tanto o agent Zabbix quanto o agent Zabbix 2.

[comment]: # ({/59736bba-59736bba})

[comment]: # ({02698e69-02698e69})
##### 1 Parar o agent

Pare o agent do Zabbix.

[comment]: # ({/02698e69-02698e69})

[comment]: # ({50263823-50263823})
##### 2 Faça backup dos arquivos de configuração e dos binários do agent Zabbix

Faça uma cópia de backup do binário do agent Zabbix e do arquivo de configuração.

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

[comment]: # ({627babed-467f56b3})
##### 3 Instalar novos binários do agent

Use estas
[instruções](/manual/installation/install/sources#installing-zabbix-daemons)
para compilar o Zabbix agent a partir do código-fonte.

Como alternativa, você pode baixar Zabbix agents pré-compilados na
[página de download do Zabbix](http://www.zabbix.com/download.php).

[comment]: # ({/627babed-467f56b3})

[comment]: # ({1a30a495-34721aad})
##### 4 Revisar os parâmetros de configuração do agent

Certifique-se de revisar as [Notas de atualização](/manual/installation/upgrade_notes) para verificar se são necessárias alterações nos parâmetros de configuração.

Para novos parâmetros opcionais, consulte a página [O que há de novo](/manual/whatsnew).

[comment]: # ({/1a30a495-34721aad})

[comment]: # ({04c253a7-04c253a7})
##### 5 Inicie o novo agent do Zabbix

Inicie o novo agent do Zabbix. Verifique os arquivos de log para ver se o agent foi iniciado com sucesso.

[comment]: # ({/04c253a7-04c253a7})

[comment]: # ({3ae7f617-a06019d2})
#### Atualização entre versões secundárias

Ao atualizar entre versões secundárias do 8.0.x (por exemplo, de 8.0.1 para 8.0.3), é necessário executar as mesmas ações para server/proxy/agent que durante a atualização entre versões principais. A única diferença é que, ao atualizar entre versões secundárias, nenhuma alteração é feita no banco de dados.

[comment]: # ({/3ae7f617-a06019d2})
