KCS - Agente Remoto - Erro de Instalação do Agente

⚙️ KCS - Agente Remoto - Erro de Instalação do Agente

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

---

❓ Dúvida / Problema

O usuário enfrenta um erro ao tentar instalar o agente do sistema em sua máquina (ex: "Erro ao instalar o agente nessa máquina..."), impedindo a conclusão do processo.

---

🔎 Causa / Contexto

O erro de instalação possui duas causas principais:

1. Incompatibilidade ou Ausência do Protocolo TLS 1.2: A chave de registro force_tls12 não está configurada como true ou a própria subchave no Registro do Windows está ausente devido a falhas prévias na instalação, impedindo a comunicação segura necessária com os servidores.

2. Limite de Licenças Excedido: O cliente atingiu a quantidade máxima de agentes inteligentes permitidos pelo seu plano cadastrado no TiFlux.

---

✅ Solução / Como Resolver

Colete os logs da instalação para confirmar a causa exata e aplique o procedimento correspondente:

Opção 1: Corrigir Incompatibilidade ou Ausência do TLS 1.2

Caso a chave não esteja configurada como true ou o caminho de registro do TiFlux ainda não exista na máquina, utilize uma das opções de correção abaixo:

A) Via PowerShell (Recomendado - Cria a chave se não existir)

Abra o PowerShell como Administrador e execute o script abaixo para criar o caminho no registro (caso ausente) e definir a propriedade para true: PowerShell

$regPath = "HKLM:\SOFTWARE\TiFlux"

# Cria a chave no Registro caso não exista
if (-not (Test-Path $regPath)) {
    New-Item -Path $regPath -Force | Out-Null
}

# Cria ou altera o valor de force_tls12 para "true"
New-ItemProperty `
    -Path $regPath `
    -Name "force_tls12" `
    -Value "true" `
    -PropertyType String `
    -Force | Out-Null

Write-Host "force_tls12 definido como true."

B) Via Prompt de Comando (CMD)

Abra o Prompt de Comando (CMD) como Administrador e execute: DOS

REG ADD "HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux" /v "force_tls12" /t REG_SZ /d "true" /f

C) Manualmente pelo Editor de Registro (Regedit)

1. Abra o regedit.

2. Navegue até o caminho HKEY_LOCAL_MACHINE\SOFTWARE\TiFlux (caso a pasta TiFlux não exista em SOFTWARE, crie-a manualmente).

3. Crie ou edite a String Value force_tls12 e altere o valor para true.

⚠️ Aviso: Após alterar ou criar a chave no Registro, reinicie o serviço do agente (TiService) ou refaça a instalação do executável.

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

Se os logs indicarem teto de agentes atingido:

• O cliente deve entrar em contato com o CSM (Customer Success Manager) de sua conta para solicitar a expansão do limite de agentes inteligentes.

💡 Dica de Especialista / Nota: Em máquinas sem instalações prévias do TiFlux, a pasta do registro em HKLM:\SOFTWARE\TiFlux pode não ter sido gerada. Nesses cenários, utilize preferencialmente o script do PowerShell (Opção A), pois ele cria a estrutura de diretórios e a chave de forma automatizada sem gerar erros de caminho não encontrado.

---

🔍 Palavras-chave para busca

erro ao instalar agente nessa maquina tiflux,
falha instalacao agente remoto force_tls12,
criar chave force_tls12 regedit powershell,
script powershell registrar force_tls12 tiflux,
agente remoto limiar de licencas excedido,
tiservice nao conecta tls 12 registro