> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/get-started/first-device.md).

# 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](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md).
* Esse computador consegue abrir conexões HTTPS de saída na porta 443 para os endereços do seu SONAR. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).

## 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](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md), [Instalar o agente no Linux](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-linux.md) e [Instalar o agente no macOS](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-macos.md).
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.

{% hint style="info" %}
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.
{% endhint %}

## 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](https://wiki.datadike.com/pt/sonar/deploy-operate/remove-agents.md)) 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      | Confira [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md) e [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md) |
| 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](https://wiki.datadike.com/pt/sonar/administration/remote-access/remote-control.md)                                                         |

## 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

* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md)
* [Instalar o agente no Windows](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md)
* [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md)
* [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md)
* [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)
