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.

---

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

---