For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo
September 22 — Documentation updated for compatibility with the latest PAM version (5.3.0).

Integre seu primeiro dispositivo

De um console vazio a um primeiro dispositivo online: crie um cliente e um site, gere o instalador do agente, execute-o e confirme que o dispositivo se reporta.

O que é e quando usar

Um dispositivo aparece no SONAR assim que o agente é instalado nele, e o agente é sempre instalado em um site de um cliente. Esta página percorre o caminho completo uma vez (cliente, site, instalador, instalação, verificação) para que você conheça cada tela antes de implantar agentes em escala.

Antes de começar

  • Um usuário do SONAR cujo papel conceda Manage Clients e Manage Sites (para criar o cliente e o site), Install Agents (para gerar o instalador) e List Agents (para ver o dispositivo no Sysadmin). Se o seu papel estiver limitado a alguns clientes, um cliente que você criar é adicionado aos Allowed Clients do seu papel.

  • Um computador com uma versão suportada de Windows, Linux ou macOS, e uma conta com direitos de administrador nele (root no Linux e no macOS). Veja Requisitos dos dispositivos.

  • Esse computador consegue abrir conexões HTTPS de saída na porta 443 para os endereços do seu SONAR. Veja Requisitos de rede.

Passos

  1. Abra Management › Create › Client.

  2. Em Name, digite o nome do cliente, por exemplo CLIENT-A.

  3. Em Default first site, digite o nome do primeiro site dele, por exemplo SITE-01, e clique em Save. O cliente e o site são criados juntos.

  4. Para adicionar mais sites depois, abra Management › Create › Site, escolha o Client, digite o Name e salve.

  5. Abra Agents › Install Agent. A janela Add an agent se abre.

  6. Escolha o Client e o Site aos quais o dispositivo pertence.

  7. Escolha o Operating system, o Agent type (Workstation ou Server) e a Architecture do computador.

  8. No Windows, revise as Optional features e escolha o Installation method. Dynamic (.exe) é o mais simples.

  9. Deixe Enable token expiration (hours) desligado para um primeiro teste, ou ligue-o e defina por quantas horas o instalador continua válido.

  10. Clique no botão na parte inferior da janela (por exemplo, Download Windows installer (.exe)) e leve o arquivo ou o comando até o computador.

  11. Execute o instalador no computador com direitos de administrador. Os passos para cada sistema estão em Instalar o agente no Windows, Instalar o agente no Linux e Instalar o agente no macOS.

  12. No console, abra Dashboard › Sysadmin e clique no cartão do seu cliente no Clients overview.

  13. Encontre o dispositivo pelo nome do host, ou digite-o em Search devices..., e selecione a linha.

Se o console ainda não tiver nenhum cliente, abrir Dashboard › Sysadmin mostra Initial Setup em vez do Clients overview. Essa tela cria o primeiro cliente e o primeiro site em um único formulário: preencha Add Client e Add Site, escolha o Default timezone for agents e clique em Finish. Depois continue a partir do passo 5.

O que você deve ver

  • Depois de Save, a mensagem CLIENT-A was added, e o cliente aparece como um cartão no Clients overview. Um site adicionado sozinho retorna Site SITE-02 was added!.

  • Com Dynamic (.exe), uma mensagem de que o instalador do seu cliente e site será baixado agora, se ele expira, e de que nenhum argumento de linha de comando é necessário. O arquivo recebe o nome do cliente, do site, do tipo de agente e da arquitetura, por exemplo sonar-clienta-SITE-01-workstation-amd64.exe.

  • Com os outros métodos, um script para baixar ou um comando para copiar.

  • No Sysadmin, o cartão do cliente conta um dispositivo, e a lista de dispositivos mostra uma linha para o novo computador.

Como verificar se funcionou

Em Dashboard › Sysadmin, na linha do dispositivo:

  • Agent Status mostra ONLINE.

  • Last Response mostra um horário do último minuto ou dos dois últimos, e First Seen mostra quando o agente se registrou.

  • Client, Site e Type correspondem ao que você escolheu no instalador.

Selecione a linha. Na aba Home do painel do dispositivo:

  • a barra no topo mostra Online e, assim que o agente de acesso remoto se conectar, Remote Online;

  • Hardware Details está preenchido (modelo, processador, sistema operacional, memória, rede) poucos minutos depois da instalação. No Linux e no macOS, os campos que o sistema não informa mostram Not available.

Depois abra Reports & Audits › Audits: há uma entrada Agent Install para o nome do host do dispositivo.

No próprio computador, o serviço do agente está em execução: Sonar Agent Service (sonarrmm) no Windows, sonaragent no Linux e no macOS.

O dashboard Home passa a contar o novo dispositivo em poucos minutos, no próximo recálculo dos seus números.

Erros comuns

Sintoma
Causa
Correção

Create › Client, Install Agent ou New Agent está esmaecido com You don't have permission for this action

O papel não tem Manage Clients, Manage Sites ou Install Agents

Peça a um administrador que conceda a permissão em Admin Center › Roles

client with this name already exists.

Os nomes de cliente são únicos em todo o console

Escolha outro nome, ou adicione um site ao cliente existente

Client name cannot contain the | character ou Site name cannot contain the | character

O nome contém uma barra vertical

Remova o caractere

O botão de download continua desabilitado

Nenhum cliente ou site está selecionado

Escolha os dois na janela Add an agent

Please enter a valid number of hours

A expiração do token está ligada com um número de horas inválido

Digite um número inteiro de horas, ou desligue a expiração

Installer token has expired. Please generate a new one. no computador

O instalador foi gerado com uma expiração que já passou

Gere um novo instalador

Old installer detected no computador

O instalador foi gerado antes de os agentes no servidor serem atualizados

Gere um novo instalador

Existing installation found em um computador Windows

O agente já está instalado nele

Remova primeiro o agente existente (veja Remover agentes) e depois execute o instalador de novo

A instalação terminou, mas nenhum dispositivo aparece

O computador não consegue alcançar os endereços do SONAR na porta 443

O dispositivo aparece, mas mostra Remote Offline

O agente de acesso remoto ainda não se conectou

Espere alguns minutos; se ele continuar offline, veja Controle remoto

Referência de campos

Create Client

Campo
O que faz
Valores aceitos
Padrão

Name

O nome do cliente, exibido na árvore, nos cartões e em todas as listas

Obrigatório. Único. Sem barra vertical

(sem padrão)

Default first site

O nome do site criado junto com o cliente

Obrigatório. Sem barra vertical

(sem padrão)

Custom Fields

Valores dos campos personalizados de cliente, quando houver algum definido em Admin Center › Settings › Custom Fields

Depende do campo

Por campo

Create Site

Campo
O que faz
Valores aceitos
Padrão

Client

O cliente ao qual o site pertence

Um cliente existente

(sem padrão)

Name

O nome do site

Obrigatório. Único dentro do cliente. Sem barra vertical

(sem padrão)

Custom Fields

Valores dos campos personalizados de site, quando houver algum definido

Depende do campo

Por campo

Add an agent

Campo
O que faz
Valores aceitos
Padrão

Client

O cliente ao qual o novo dispositivo pertence

Um cliente que o seu papel permite

(sem padrão)

Site

O site ao qual o novo dispositivo pertence

Um site do cliente escolhido

(sem padrão)

Operating system

O sistema para o qual o instalador é gerado

Windows, Linux, macOS

Windows

Agent type

Se o dispositivo é uma estação de trabalho ou um servidor. Decide qual política de automação para estações de trabalho ou para servidores se aplica a ele

Workstation, Server

Workstation

Architecture

A arquitetura do processador do computador

Windows: 64-bit, 32-bit. Linux: 64-bit, 32-bit, ARM 64-bit, ARM 32-bit. macOS: Intel 64-bit, Apple Silicon

64-bit (Intel 64-bit no macOS)

Optional features › Sessions

Windows. Instala o módulo de produtividade, que registra a atividade dos usuários e aplica as políticas de acesso

Ligado, desligado

Ligado

Optional features › Geolocation

Windows. O dispositivo informa a sua posição, exibida na aba Location e em Observability › Geolocation

Ligado, desligado

Ligado

Optional features › Remote access

Windows. Ativa a Área de Trabalho Remota do Windows no computador

Ligado, desligado

Ligado

Optional features › Ping

Windows. Permite que o computador responda a ping através do Firewall do Windows

Ligado, desligado

Ligado

Optional features › Disable sleep/hibernate

Estações de trabalho. Desativa a suspensão e a hibernação para que o dispositivo continue alcançável. Aplica-se no Windows

Ligado, desligado

Ligado

Installation method

Windows. Como o instalador é entregue: Dynamic (.exe), um instalador pronto para executar; PowerShell, um script; Manual, um comando para você mesmo executar. O Linux recebe um script de instalação (.sh) e o macOS um comando, sem escolha a fazer

Dynamic (.exe), PowerShell, Manual

Dynamic (.exe)

Enable token expiration (hours)

Limita por quanto tempo o instalador pode registrar novos dispositivos. Desligado, o instalador não expira

Desligado, ou um número de horas

Desligado; 24 horas quando ligado

Páginas relacionadas

Atualizado

Isto foi útil?