# 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.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/agente/kcs-erro-de-instalacao-do-agente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.