> 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/deploy-operate/mass-deployment.md).

# Implantar agentes em escala

Distribua o agente SONAR para muitos dispositivos: instaladores reutilizáveis, links em Agents › Deployments, GPO, distribuição de software e conferência.

## O que é e quando usar

Cada instalador gerado pelo console fica vinculado a um cliente e a um site, e funciona em qualquer quantidade de dispositivos enquanto for válido. Levar o SONAR a um site inteiro é, portanto, uma questão de gerar um instalador por site e por tipo de dispositivo e executá-lo em todos eles com a ferramenta que você já usa: Política de Grupo, uma ferramenta de distribuição de software ou de MDM, um RMM que está sendo substituído, automação por SSH.

Há duas fontes de instaladores:

* **Agents › Install Agent**: um arquivo ou comando que você baixa uma vez e distribui, seja o **Dynamic (.exe)** ou o script **PowerShell** do Windows, o script do Linux ou o comando do macOS. Veja as páginas de cada plataforma, com os links abaixo.
* **Agents › Deployments**: um **link de download** reutilizável por site, para Windows. A cada vez que o link é aberto, o SONAR gera um instalador novo com a versão atual do agente, até a data definida em **Expiry** na implantação.

## Antes de começar

* Para gerenciar os links de implantação, o seu papel tem **List Deployments** e **Manage Deployments** em **Admin Center › Roles**. Para gerar instaladores em **Install Agent**, ele tem **Install Agents**. As duas permissões cobrem apenas os sites aos quais o seu papel dá acesso.
* Os clientes e os sites existem. Planeje um instalador ou uma implantação por site, por tipo de dispositivo (**Server** ou **Workstation**) e por arquitetura.
* As exclusões de antivírus e de EDR estão configuradas antes da distribuição. Veja [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md#exclusoes-de-antivirus-e-edr).
* Todas as redes de destino permitem saída em 443/tcp para os endereços da API do SONAR e do acesso remoto. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).
* Para os instaladores de **Install Agent**, ative **Enable token expiration (hours)** com horas suficientes para cobrir toda a janela de distribuição. Depois desse prazo, o instalador para de funcionar e é preciso gerar outro.

## Passos

### Criar um link de implantação (Windows)

1. Abra **Agents › Deployments**. A caixa de diálogo **Deployments** lista as implantações existentes.
2. Clique no botão **+** (**Create Deployment**). O formulário **Add Deployment** se abre.
3. Escolha o **Site**.
4. Escolha o **Agent Type**: **Server** ou **Workstation**.
5. Defina a data e a hora em **Expiry**.
6. Escolha a **Architecture**: **64 bit** ou **32 bit**.
7. Marque as **Optional Features** que os dispositivos devem receber. São as mesmas de **Install Agent** e estão descritas em [Instalar o agente no Windows](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md#referencia-de-campos).
8. Clique em **Create Deployment**. A mensagem *The deployment was added successfully* aparece, e a nova linha é adicionada à lista.
9. Na linha, em **Download Link**, clique em **Copy**. A mensagem *Link copied to clipboard* confirma a cópia.

Ao abrir o link, é baixado o arquivo `sonar-<client>-<site>-<type>-<architecture>.exe`, o mesmo instalador Dynamic que **Install Agent** gera, que roda em modo silencioso com `/S`.

### Implantar com um script de inicialização da Política de Grupo (Windows)

Um script de inicialização do computador roda como Local System, antes de qualquer pessoa fazer logon, e esse é o contexto que o instalador silencioso espera.

1. Salve um script como este, com o seu link de implantação, em um compartilhamento que os computadores do domínio consigam ler:

   ```powershell
   if (-not (Get-Service -Name sonarrmm -ErrorAction SilentlyContinue)) {
       $installer = Join-Path $env:TEMP 'sonar-agent.exe'
       Invoke-WebRequest -Uri '<deployment link>' -OutFile $installer -UseBasicParsing
       Start-Process -FilePath $installer -ArgumentList '/S' -Wait
       Remove-Item $installer -Force
   }
   ```

   A verificação do serviço faz com que o script não faça nada nos dispositivos que já têm o agente. Em vez de baixar de um link, o script pode, da mesma forma, executar um instalador Dynamic (.exe) copiado para o compartilhamento.
2. Em **Group Policy Management**, crie ou edite uma GPO vinculada à unidade organizacional dos computadores de destino.
3. Em **Computer Configuration › Policies › Windows Settings › Scripts (Startup/Shutdown)**, adicione o script como script PowerShell de **Startup**.
4. Reinicie os computadores de destino, ou aguarde a próxima reinicialização deles.

### Implantar com uma ferramenta de distribuição de software ou de MDM (Windows)

Empacote como aplicativo o instalador Dynamic (.exe) obtido em **Install Agent** ou em um link de implantação:

| Configuração             | Valor                                                                                  |
| ------------------------ | -------------------------------------------------------------------------------------- |
| Comando de instalação    | `sonar-<client>-<site>-<type>-<architecture>.exe /S`                                   |
| Comando de desinstalação | `"C:\Program Files\Sonar\uninstall.exe" /S`                                            |
| Executar como            | System                                                                                 |
| Detecção                 | O serviço `sonarrmm` existe, ou o arquivo `C:\Program Files\Sonar\sonarrmm.exe` existe |

O script PowerShell de **Install Agent** pode ser distribuído da mesma forma: ele mesmo verifica se o serviço `sonarrmm` existe e encerra se o agente já estiver instalado.

### Implantar no Linux e no macOS

* **Linux:** execute o script de **Install Agent** como root em cada máquina, pela sua automação (SSH, gerenciamento de configuração, um loop a partir de um jump host): `sudo bash ./sonar-<client>-<site>-<type>.sh`. O script remove qualquer agente anterior antes de instalar. Veja [Instalar o agente no Linux](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-linux.md).
* **macOS:** execute o comando de **Install Agent** como root pelo seu MDM ou por um shell remoto. Onde os operadores precisarem das pastas protegidas do usuário a partir da janela de acesso remoto, conceda **Full Disk Access** por meio de um perfil de privacidade do MDM. Veja [Instalar o agente no macOS](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-macos.md).

## O que você deve ver

Os dispositivos aparecem em **Dashboard › Sysadmin**, sob o cliente e o site deles, à medida que cada instalação termina, com **Agent Status** **Online**. Na visão **Clients overview**, o cartão do cliente mostra a contagem de dispositivos aumentando.

## Como verificar se funcionou

1. Abra **Dashboard › Sysadmin** e clique no cartão do cliente.
2. Ordene a lista de dispositivos por **First Seen**, dos mais recentes para os mais antigos: os dispositivos da distribuição ficam no topo, com a data em que se registraram.
3. Abra **Filters** e, em **Availability**, escolha **Online**; em **Device Type**, escolha **Servers** ou **Workstations**, conforme o lote. Compare a contagem com a lista de dispositivos que você pretendia atingir.
4. Para os dispositivos da sua lista que estiverem faltando, confira o resultado registrado pela própria ferramenta de implantação nesses dispositivos e, depois, siga [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md).
5. Em **Reports & Audits › Audits**, cada registro de dispositivo é uma entrada **Agent Install** com o nome do host, o que mostra a ordem e a hora de chegada.

## Erros comuns

| Sintoma                                                                             | Causa                                                                                                                                                                   | Correção                                                                                            |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| *expire date is invalid* ao criar uma implantação                                   | **Expiry** está vazio ou incompleto                                                                                                                                     | Preencha a data e a hora                                                                            |
| Os instaladores param com *Installer token has expired. Please generate a new one.* | A implantação passou da data de **Expiry**, a implantação foi excluída, ou o instalador de **Install Agent** passou da expiração do token                               | Crie uma nova implantação ou um novo instalador e atualize o link ou o pacote na sua ferramenta     |
| Instaladores salvos antes da distribuição param com *Old installer detected*        | A versão do agente SONAR mudou depois que o arquivo foi gerado                                                                                                          | Gere o arquivo de novo, ou use um link de implantação, que sempre gera a versão atual               |
| A instalação silenciosa reporta sucesso, mas o dispositivo nunca aparece            | O dispositivo já tinha um agente, ou o que restou de um; o instalador exibe *Existing installation found and must be removed before attempting to reinstall.* e encerra | Execute `"C:\Program Files\Sonar\uninstall.exe" /S` no dispositivo e instale de novo                |
| Uma instalação executada dentro da sessão de um usuário conectado não termina       | A caixa de mensagem final do agente está aguardando o **OK**                                                                                                            | Execute o instalador como Local System, ou use o script PowerShell, que roda sem caixas de mensagem |
| Os dispositivos chegam no site errado                                               | Foi usado o instalador ou o link de outro site                                                                                                                          | Mova os dispositivos para o site certo e confira qual arquivo cada pacote usa                       |
| O botão **+**, **Copy** ou **Delete** não faz nada                                  | O seu papel não tem **Manage Deployments**                                                                                                                              | Solicite a permissão                                                                                |

## Referência de campos

### Add Deployment

| Campo                 | O que faz                                                                                                                                                     | Valores aceitos                                                  | Padrão                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | --------------------------------- |
| **Site**              | Site sob o qual os dispositivos são registrados                                                                                                               | Os sites aos quais o seu papel tem acesso, agrupados por cliente | O primeiro site da lista          |
| **Agent Type**        | Registra os dispositivos como servidores ou como estações de trabalho                                                                                         | **Server**, **Workstation**                                      | **Server**                        |
| **Expiry**            | Data e hora a partir das quais os instaladores deste link param de funcionar                                                                                  | Uma data e uma hora                                              | 30 dias a partir do momento atual |
| **Architecture**      | Arquitetura Windows do instalador                                                                                                                             | **64 bit**, **32 bit**                                           | **64 bit**                        |
| **Optional Features** | Os mesmos recursos de **Install Agent**: **Sessions**, **Geolocation**, **Remote access**, **Ping** e, para estações de trabalho, **Disable sleep/hibernate** | Marcado ou não                                                   | Nenhum marcado                    |

### Lista de implantações

| Coluna            | O que mostra                                                          |
| ----------------- | --------------------------------------------------------------------- |
| **Client**        | Cliente do site da implantação                                        |
| **Site**          | Site sob o qual os dispositivos são registrados                       |
| **Type**          | **server** ou **workstation**                                         |
| **Arch**          | `amd64` (64 bit) ou `386` (32 bit)                                    |
| **Expiry**        | Quando o link deixa de produzir instaladores que funcionam            |
| **Created**       | Quando a implantação foi criada                                       |
| **Flags**         | **View Flags**; passe o mouse por cima para ver os recursos opcionais |
| **Download Link** | **Copy** coloca o link na área de transferência                       |

Para remover uma implantação, clique com o botão direito na linha, escolha **Delete** e confirme **Delete deployment?**. Os instaladores já baixados por esse link também param de funcionar.

## Páginas relacionadas

* [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)
* [Instalar o agente no macOS](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-macos.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)
