Pular para o conteúdo principal

Instalar no Linux

Pré-requisitos​

  • Linux 64-bit (Ubuntu 20.04+, Debian 11+, CentOS/RHEL 8+)
  • Acesso sudo ou root
  • Conectividade de saída TCP 443 para o CLM

Instalação via Quick Install (recomendado)​

  1. Acesse Agents no menu lateral
  2. Clique em Install Agent
  3. Na aba Quick Install, preencha:
    • Agent Name — identificador único para este agente, ex: linux-prod-01
  4. Clique em Generate Pairing Code
  5. Copie o comando gerado e execute no servidor Linux com sudo

O script realiza automaticamente:

  • Download do binário clm-agent
  • Criação do arquivo /opt/clm-agent/config.yaml
  • Registro do serviço systemd clm-agent
  • Início automático do serviço

Após alguns segundos, o agente aparecerá com status Online na tela de Agents.

Instalação manual (ambientes sem internet)​

1. Crie o agente no CLM

Acesse Agents → Install Agent → Quick Install, preencha o nome e clique em Generate Pairing Code. Salve o token gerado — ele é exibido apenas uma vez.

2. Baixe o binário

Na aba Manual Setup, baixe o binário Linux amd64 e transfira para o servidor via SCP ou mirror interno.

3. Prepare o diretório

sudo mkdir -p /opt/clm-agent
sudo mv clm-agent-linux-amd64 /opt/clm-agent/clm-agent
sudo chmod +x /opt/clm-agent/clm-agent

4. Crie o arquivo de configuração

sudo nano /opt/clm-agent/config.yaml

Conteúdo:

server:
  url: "wss://SEU-DOMINIO-CLM/api/agent/connect"
  token: "agent_COLE_O_TOKEN_AQUI"

agent:
  name: "nome-do-servidor"
  heartbeat_interval: 30
  reconnect_delay: 5
  max_reconnect_delay: 300

5. Registre como serviço systemd

sudo nano /etc/systemd/system/clm-agent.service

Conteúdo:

[Unit]
Description=CLM On-Premises Agent
After=network.target

[Service]
ExecStart=/opt/clm-agent/clm-agent --config /opt/clm-agent/config.yaml
Restart=always
RestartSec=5
WorkingDirectory=/opt/clm-agent

[Install]
WantedBy=multi-user.target

Ative e inicie o serviço:

sudo systemctl daemon-reload
sudo systemctl enable clm-agent
sudo systemctl start clm-agent

Gerenciar o agente​

Verificar status

sudo systemctl status clm-agent

Iniciar

sudo systemctl start clm-agent

Parar

sudo systemctl stop clm-agent

Reiniciar

sudo systemctl restart clm-agent

Ver logs em tempo real

sudo journalctl -u clm-agent -f

Rotacionar token

Gere um novo token na linha do agente em Agents → Rotate Token, atualize o config.yaml e reinicie:

sudo nano /opt/clm-agent/config.yaml
sudo systemctl restart clm-agent

Desinstalar

sudo systemctl stop clm-agent
sudo systemctl disable clm-agent
sudo rm /etc/systemd/system/clm-agent.service
sudo systemctl daemon-reload
sudo rm -rf /opt/clm-agent
note
Desinstalar o agente do servidor não remove o registro no CLM. Use a ação **Delete** na linha do agente em **Agents** para remover o registro da plataforma também.