> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/guias-de-atualizacao-and-manutencao/atualizacao-do-weknow-server.md).

# Atualização do Weknow Server

Este artigo apresenta o procedimento para verificar, baixar e aplicar atualizações do **Weknow Server** utilizando a ferramenta **Weknow Server Updater**.

### 1. Antes de iniciar

Para iniciar o processo de atualização de infraestrutura, certifique-se de cumprir os critérios de acesso locais:

* **Perfil de Acesso:** O analista responsável deve estar logado no sistema operacional da máquina servidora com um usuário pertencente ao grupo de Administradores do Windows.
* **Ação Supervisionada:** A esteira de atualização do Weknow é manual e controlada, exigindo acompanhamento visual até a sua conclusão.

{% hint style="danger" %}

* **Alerta Crítico de Backup e Irreversibilidade:** Não há suporte para downgrade de versão no servidor. Uma vez aplicada a nova versão, a estrutura física das tabelas de metadados no banco de dados pode ser alterada permanentemente.
* **Regra de Ouro:** Nunca acione o utilitário de atualização sem antes certificar-se de que a rotina diária de backup automatizado foi concluída com sucesso ou de ter gerado um *snapshot/dump* manual recente. Em caso de dúvidas, consulte a sua equipe de DBA antes de prosseguir.\
   Em caso de dúvidas, consulte a [Política de backup preventivo](/wedocs-5.2/infraestrutura-instalacao-e-requisitos/guias-de-atualizacao-and-manutencao/politica-de-backup-preventivo.md)ou sua equipe de DBA antes de prosseguir.
  {% endhint %}

### 2. Abrindo o Weknow Server Updater

1. Acesse o servidor onde o **Weknow Server** está instalado.
2. Abra o diretório de instalação da plataforma.
3. Execute o aplicativo **Weknow Server Updater** (`wknw_server_updater.exe`) com privilégios de administrador.

### 3. Conhecendo a interface

Ao abrir o **Weknow Server Updater**, será exibida a lista dos componentes instalados e o status de cada um deles.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FN7LBWnFyFQRXxBSlyDPD%2Fimage.png?alt=media&amp;token=03049d98-b04d-4961-a23d-83852ace6cff" alt=""><figcaption></figcaption></figure>

Essa tela apresenta as seguintes informações:

| Coluna            | Descrição                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Aplicação**     | Componente instalado no ambiente (Weknow Server, Weknow Client, Weknow Task Manager e Serviço MonetDB, quando utilizado). |
| **Versão**        | Versão atualmente instalada do componente.                                                                                |
| **Situação**      | Indica se existe atualização disponível ou se o componente está atualizado.                                               |
| **Identificador** | Código utilizado para identificação da instalação.                                                                        |
| **Diretório**     | Local onde os arquivos do componente estão armazenados.                                                                   |
| **Serviços**      | Situação dos serviços do Windows relacionados ao componente.                                                              |

Além da grade de aplicações, a barra superior reúne os principais comandos do atualizador, utilizados durante o processo de manutenção do ambiente.

### 4. Executando a atualização

Para mitigar riscos de quebra de compatibilidade, as aplicações secundárias dependem diretamente da atualização do núcleo central (Core).

1. Na interface do atualizador, clique no botão **Verificar** para buscar novas builds.
2. Havendo atualizações disponíveis, localize o botão **Atualizar**.
3. Clique na seta do menu suspenso ao lado do botão e selecione a diretriz recomendada: **Atualizar Servidor**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FSlCYKhQNXYekqsPenp9f%2Fimage.png?alt=media&amp;token=6e67a9dc-9648-4698-a64e-37a5cfda4500" alt=""><figcaption></figcaption></figure>

4. Caso precise aplicar uma manutenção isolada devido a necessidades planejadas da instituição, o menu suspenso disponibiliza rotinas específicas:

* **Atualizar Servidor:** Atualiza estritamente o núcleo principal. É o pré-requisito para liberar a atualização de componentes secundários incompatíveis.
* **Atualizar Gerenciador Tarefas / Serviço MonetDB / Cliente:** Atualiza os respectivos módulos isolados, desde que a versão do Servidor já seja compatível ou superior.

5. Ao concluir a esteira de instalação, o sistema abrirá uma janela com as descrições detalhadas das melhorias e correções implementadas nesta build. Você também pode acessar esse histórico a qualquer momento clicando no botão **Notas de versão**.

### 5. Recursos auxiliares de manutenção

Na **barra superior do Weknow Updater**, estão disponíveis os principais comandos para gerenciamento das atualizações, incluindo as opções **Verificar**, **Atualizar**, **Reparar** e **Serviços**.

* **Reparar:** Executa as rotinas integradas do utilitário `wknw_cleaner.exe`. Faz uma varredura profunda no aplicativo selecionado para corrigir permissões de pastas do Windows, expurgar arquivos de cache temporários corrompidos e restabelecer os atalhos nativos do sistema.
* **Serviços:** Abre uma interface de controle simplificada que permite parar, iniciar ou reiniciar os serviços do Windows vinculados ao ecossistema Weknow diretamente por dentro do atualizador, dispensando o uso do console `services.msc` do sistema operacional.