> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/recursos/agente-remoto/kcs-erro-de-instalacao-do-agente.md).

# KCS - Erro de Instalação do Agente

## 📌Erro de Instalação do Agente

🕒 Tempo aproximado para leitura: 00:01:20 min

***

### ❓ Dúvida:

O usuário está enfrentando um erro ao tentar instalar o agente do sistema em sua máquina, recebendo uma mensagem de falha na instalação (ex: "Erro ao instalar o agente nessa máquina..."). A instalação não é concluída, e o cliente precisa de um diagnóstico e uma solução.

<figure><img src="/files/AKicSPUCtIUExnth0WVm" alt=""><figcaption></figcaption></figure>

***

### 🔎 Causa:

O problema na instalação pode ter duas causas principais, que precisam ser diagnosticadas, sendo que a segunda (licenças) é, muitas vezes, a Causa Raiz após descartar a primeira (TLS):

1. Incompatibilidade de Protocolo (TLS): Uma causa comum é a incompatibilidade no protocolo de segurança. O erro acontece quando a chave de registro `force_tls12` não está definida como `true` no Windows, impedindo a comunicação segura necessária para a instalação.
2. Limite de Licenças Excedido: O cliente atingiu o número máximo de agentes inteligentes (licenças) disponíveis em seu cadastro. O sistema Tiflux restringe a instalação de um novo agente quando a quantidade em uso é igual ao limite permitido para aquele cliente.

***

### ✅ Solução:

É essencial solicitar a coleta de logs para confirmar a causa exata do erro. Em seguida, aplique a solução correspondente:

#### Opção 1: Corrigir Incompatibilidade de TLS

O problema pode ser resolvido com uma alteração no registro do Windows, sem a necessidade de acesso remoto:

* Instrução Manual: Abra o Editor de Registro (`regedit`) e navegue até `HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux`. Lá, localize a chave `force_tls12` e altere seu valor para `true`.
* Instrução Via Script: Para aplicação rápida, execute o seguinte comando no Prompt de Comando (CMD) como administrador:

  ```
  REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux" /v "forcetls12" /t REGSZ /d "true" /f
  ```
* Finalização: Após aplicar a solução, é essencial reiniciar o serviço do agente (`TiService`) para que as mudanças tenham efeito.

#### Opção 2: Aumentar o Limite de Licenças

Se o diagnóstico ou os logs indicarem que o limite de agentes foi excedido, o cliente deve:

* Solicitar mais agentes inteligentes junto ao CSM da sua conta.

***