Instalar agente e coletor

Abrir na plataforma

Guia passo-a-passo para colocar um agente rodando num host monitorado ou subir um coletor local numa máquina dentro da rede do cliente. A plataforma gera pacotes prontos, por SO e versão, já amarrados ao coletor que você escolheu.

Para a conceituação (agente vs coletor, coletor da nuvem vs local), ver Agentes & Hubs.

Onde achar o pacote

1. Abra Administração → Agentes & Hubs.
2. Na linha do coletor que vai receber os hosts: passe o mouse em Agent e escolha Windows ou Linux, ou clique em Collector (só em coletores locais) para a tela do coletor.
3. A plataforma abre a lista de distribuições suportadas. Clique na distribuição/versão para ver os passos prontos, com a URL e o nome de pacote já gerados.

O pacote é específico do par tenant + coletor

O nome do arquivo inclui o coletor escolhido. Baixar um pacote do coletor A e instalar apontando para o coletor B não funciona: cada agente fica amarrado ao coletor de origem.

Pré-requisitos comuns

• Conectividade do host até o coletor (porta do agente).
• DNS funcional, se o endereço do coletor for FQDN.
• Acesso de root (Linux) ou Administrador (Windows) na máquina onde o agente vai rodar.
• Sistema operacional na lista suportada (ver tabelas abaixo).

Agente Linux

Distribuições e arquiteturas suportadas hoje:

Família	Versões	Arquiteturas
RHEL	7, 8, 9	x86_64
Debian	9, 10, 11, 12, 13	9 só x86_64; 10 em diante x86_64 e arm64
Ubuntu	18.04, 20.04, 22.04, 24.04	18.04 só x86_64; 20.04 em diante x86_64 e arm64

Família RHEL

Vale para RHEL 7, 8 e 9 (e derivados binários como Rocky e Alma).

Passo 1. Instalar dependências do sistema:

sudo yum install -y \
  unixODBC-devel \
  net-snmp-devel \
  OpenIPMI-devel \
  c-ares \
  libevent-devel \
  curl

Passo 2. Baixar o pacote. Use o link Download que aparece na página do agente ou copie o curl -L -O que a plataforma já gera com a URL e o nome de pacote prontos para o seu coletor.

Passo 3. Instalar:

sudo rpm -ivh "<nome-do-pacote>.rpm"

O nome do pacote segue o padrão <coletor>_specialone-agent-rhel<versao>-el<versao>.<versao-agente>-1.x86_64.rpm. A plataforma copia o nome exato para você no passo 3.

Família Debian e Ubuntu

Mesmo procedimento para Debian 9 a 13 e Ubuntu 18.04 a 24.04.

Passo 1. Atualizar repositórios e instalar dependências:

sudo apt update && sudo apt install -y \
  unixodbc-dev \
  libsnmp-dev \
  libopenipmi-dev \
  libc-ares2 \
  libevent-dev \
  curl

Passo 2. Baixar o pacote pelo link Download ou pelo curl -L -O da página.

Passo 3. Instalar:

sudo dpkg -i "<nome-do-pacote>.deb"

Padrão do nome de pacote:

• Debian: <coletor>_specialone-agent-debian<X>_<versao>.<codename>_<arch>.deb
• Ubuntu: <coletor>_specialone-agent-ubuntu<X.YY>_<versao>.<codename>_<arch>.deb

Codenames usados:

Versão	Codename
Debian 9	stretch
Debian 10	buster
Debian 11	bullseye
Debian 12	bookworm
Debian 13	trixie
Ubuntu 18.04	bionic
Ubuntu 20.04	focal
Ubuntu 22.04	jammy
Ubuntu 24.04	noble

ARM64 disponível

Para Raspberry Pi, ARM Servers e nuvens com CPU ARM (Graviton, Ampere), escolher a opção ARM64 no passo 2. Vale para Debian 10+ e Ubuntu 20.04+.

Use o pacote da distribuição certa

O pacote do bookworm instalado num bullseye falha por mismatch de dependência de glibc. Confira o codename do alvo antes de baixar.

Agente Windows

Duas variantes na página de download:

• Windows Server: 2016, 2019, 2022.
• Windows Desktop: 10 e 11.

O fluxo é o mesmo nos dois, muda só o nome do pacote.

Passo 1. Baixar o pacote.

Pelo navegador: link Download na página do agente.

Por PowerShell (sessão de Administrador):

Invoke-WebRequest `
  -Uri "<url-gerada-pela-plataforma>" `
  -OutFile "<nome-do-pacote>.zip"

Passo 2. Instalar:

Expand-Archive "<nome-do-pacote>.zip" -DestinationPath .
# Executar como Administrador:
.\SpecialOne Agent Install.bat

Padrão do nome do pacote:

• Windows Server: <coletor>_specialone-agent-x86_64.zip
• Windows Desktop: <coletor>_specialone-agent_desktop-x86_64.zip

Rodar como Administrador

O .bat registra um serviço, instala o agente em C:\Program Files\SpecialOne\Agent e configura inicialização automática. Sem privilégio de Administrador a instalação falha silenciosa (o arquivo extrai mas o serviço não é criado).

Distribuição via GPO ou MDM

Para fleets, embrulhe o .zip num pacote de distribuição (GPO no AD, Intune, MEM, JAMF para clientes mistos). O nome do coletor faz parte do .zip, então o mesmo pacote serve para todos os hosts que vão reportar ao mesmo coletor.

Coletor local

O coletor roda em Linux. Para ambientes 100% Windows, o Coletor padrão na nuvem SpecialOne (já provisionado em todo tenant) cobre o caso de uso.

Distribuições suportadas para o pacote do coletor:

Família	Versões
RHEL	9
Debian	11, 12
Ubuntu	20.04, 22.04, 24.04

Fluxo

Passo 1. Cadastre o coletor em Agentes & Hubs → Novo Coletor (nome e endereço).

Passo 2. Na linha do coletor recém-criado, clique em Collector.

Passo 3. Escolha a distribuição da máquina que vai hospedar o coletor.

Passo 4. Baixe o pacote pelo link Download.

Passo 5. Instale na máquina.

Em RHEL 9:

sudo rpm -ivh "<coletor>_specialone-collector-rhel9-...rpm"

Em Debian ou Ubuntu:

sudo dpkg -i "<coletor>_specialone-collector-<distro>-...deb"

Passo 6. Aguarde a primeira comunicação: o status do coletor sai de Unknown para Online em até 3 minutos.

Coletor da nuvem não tem pacote

O Coletor padrão na nuvem SpecialOne roda na infra da plataforma; não tem botão Collector para download. Use-o para checagens sintéticas contra alvos públicos sem instalar nada na rede do cliente.

Validação pós-instalação

Após instalar agente ou coletor, valide em 3 pontos.

1. Status do serviço no host

Em Linux:

systemctl status specialone-agent
# esperado: active (running)

systemctl status specialone-collector

Em Windows: abra services.msc, procure SpecialOne Agent, estado Em execução.

2. Conectividade até o coletor (apenas agente)

Em Linux:

nc -vz <endereço-do-coletor> <porta-do-agente>

Em Windows PowerShell:

Test-NetConnection -ComputerName <endereço-do-coletor> -Port <porta-do-agente>

3. Aparição na plataforma

Abra Infraestrutura → Hosts e procure pelo nome do host. Ele deve aparecer com status Online em até 3 minutos (janela do auto-refresh da plataforma).

Se passados ~5 minutos o host segue Offline ou nem aparece, ir para o troubleshooting.

Troubleshooting

Agente instalado mas não fica Online

• Firewall do host: liberar saída para o endereço e a porta do agente do coletor.
• Firewall do segmento: regra entre VLANs, DMZ, datacenters ou cloud VPCs.
• DNS: se o coletor foi cadastrado com FQDN, o host precisa resolver. Teste com nslookup ou Resolve-DnsName.
• Log do agente:
  • Linux: /var/log/specialone-agent/agent.log
  • Windows: C:\Program Files\SpecialOne\Agent\logs\agent.log

Pacote rejeitado pelo gerenciador de pacotes

• RHEL com erro de dependência: rode o passo 1 antes de tentar o rpm -ivh. Sem unixODBC-devel, net-snmp-devel e OpenIPMI-devel o pacote não instala.

• Debian/Ubuntu com erro de pendência: resolver com:

  sudo apt -f install
  

  Em seguida, tentar o dpkg -i de novo.

• Versão errada da distribuição: o pacote carrega el8, bullseye, jammy, etc. no nome. Instalar o pacote do RHEL 9 num RHEL 8 vai falhar por mismatch de glibc.

Erro 401 ou 403 no curl

O download é autenticado. Se rodar o curl numa sessão que não tem cookie da plataforma, vai dar 401/403. Soluções:

• Baixar pelo navegador logado e copiar o arquivo para a máquina alvo (via scp, S3, etc).
• Usar o curl -L -O em uma máquina onde você fez login na plataforma na mesma sessão.

Reinstalar após mudar nome ou endereço do coletor

Editar o coletor (nome ou endereço) força reinstalação nos agentes. Fluxo:

1. Em Agentes & Hubs, edite o coletor.
2. Baixe o pacote novo na página do agente, agora com o nome ou endereço atualizado.
3. Reinstale nos hosts. O instalador detecta o agente anterior e atualiza a configuração (não precisa desinstalar antes).

Windows: Install.bat finaliza mas o serviço não fica

Quase sempre é falta de privilégio:

• Abra PowerShell com Executar como Administrador antes de rodar o .bat.
• Confirme em services.msc: o serviço SpecialOne Agent deve existir e estar em Em execução.
• Se sumiu, rode de novo o .bat como Administrador.

Próximos passos

• Agentes & Hubs

  ---

  Tela de cadastro e gestão dos coletores que recebem os agentes.

  Voltar para Agentes & Hubs

• Hosts

  ---

  Cadastrar os hosts e atribuí-los ao coletor responsável.

  Abrir Hosts

• Conceitos

  ---

  Vocabulário da plataforma: agente, coletor, perfil de monitoramento.

  Ver Conceitos