> 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/remove-agents.md).

# Remover agentes

Remova o agente SONAR pelo menu de ações do dispositivo, desinstale-o localmente no Windows, Linux ou macOS, ou arquive o dispositivo para manter o histórico.

## O que é e quando usar

Remover um agente desinstala o SONAR do dispositivo e tira o dispositivo do console. Use quando um dispositivo for desativado, substituído ou deixar de estar sob a sua gestão. Há três formas de fazer isso, com resultados diferentes:

| Ação                                             | Desinstala do dispositivo             | Registro do dispositivo no console                                |
| ------------------------------------------------ | ------------------------------------- | ----------------------------------------------------------------- |
| **Remove Agent** (menu de ações do dispositivo)  | Sim, quando o dispositivo está online | Excluído, com os dados dele                                       |
| **Archive Agent** (menu de ações do dispositivo) | Sim, quando o dispositivo está online | Mantido, com o histórico, marcado como arquivado                  |
| Desinstalação local no dispositivo               | Sim                                   | Mantido; o dispositivo fica offline até você removê-lo no console |

## Antes de começar

* **Remove Agent** exige **Uninstall Agents** em **Admin Center › Roles**. **Archive Agent** exige **Edit Agent**. As duas ações só funcionam em dispositivos de sites aos quais o seu papel dá acesso.
* Decida se você ainda precisa do histórico do dispositivo no console. **Remove Agent** o exclui; **Archive Agent** o mantém.
* Para uma desinstalação local, você precisa de direitos de administrador no Windows ou de `root` no Linux e no macOS.

## Passos

### Remover um agente pelo console

1. Em **Dashboard › Sysadmin**, selecione o dispositivo.
2. Abra o menu de ações do dispositivo (**Other actions**, no cabeçalho do painel de detalhes) e escolha **Remove Agent**.
3. O SONAR primeiro verifica se o dispositivo responde.
   * Se não responder, a caixa de diálogo **Agent offline** exibe *… cannot be contacted. Would you like to continue with the uninstall? If so, the agent will need to be manually uninstalled from the computer.* Clique em **Yes** para continuar ou em **No** para parar.
4. Em **Remove \<hostname>**, digite o **Reason**. Ele é obrigatório e fica guardado na trilha de auditoria.
5. Clique em **Remove Agent**.

### Arquivar um agente

1. Selecione o dispositivo e abra o menu de ações do dispositivo.
2. Escolha **Archive Agent**.
3. Em **Archive Agent**, digite `yes` para confirmar e clique em **Archive**.

**Archive Agent** desinstala o agente do dispositivo da mesma forma que **Remove Agent**, mas o registro do dispositivo e o histórico dele continuam no console. O SONAR não gera alertas para um dispositivo arquivado, e os dispositivos arquivados não entram na contagem de dispositivos online, offline ou em atraso.

**Unarchive Agent**, no mesmo menu, retira a marca de arquivado. Ele não reinstala nada: para voltar a gerenciar o dispositivo, instale o agente nele. O dispositivo entra então como um novo registro de dispositivo.

### Desinstalar localmente no Windows

Em um Prompt de Comando elevado:

```
"C:\Program Files\Sonar\uninstall.exe" /S
```

Para um agente de 32 bits em um Windows de 64 bits, o desinstalador é `C:\Program Files (x86)\Sonar\uninstall.exe`. O agente também pode ser removido como **Sonar** na lista de programas instalados do Windows.

### Desinstalar localmente no Linux

Execute como root o script de instalação do Linux obtido em **Agents › Install Agent**, com o argumento `uninstall`:

```bash
sudo bash ./sonar-<client>-<site>-<type>.sh uninstall
```

Qualquer script do Linux gerado pelo console serve para isso, seja qual for o cliente, o site ou a validade dele. O script se exclui ao terminar.

### Desinstalar localmente no macOS

Como administrador, no Terminal:

```bash
sudo /opt/sonarmesh/meshagent -fulluninstall
sudo launchctl bootout system /Library/LaunchDaemons/sonaragent.plist
sudo rm -rf /opt/sonarmesh /opt/sonaragent /usr/local/mesh_services
sudo rm -f /etc/sonaragent.json /Library/LaunchDaemons/sonaragent.plist
```

## O que você deve ver

**Remove Agent** termina com *\<hostname> will now be uninstalled.* e o dispositivo sai da lista de dispositivos. **Archive Agent** termina com *Archived was enabled on \<hostname>*.

O que a desinstalação remove do dispositivo:

| Plataforma | Removido                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows    | O serviço `sonarrmm`; o serviço do módulo de produtividade, `SonarProductivityService`; o agente de acesso remoto; a configuração em `HKLM\SOFTWARE\Sonar`; `C:\ProgramData\Sonar\` e as tarefas agendadas criadas pelo SONAR; as pastas `C:\Program Files\Sonar\` e `C:\Program Files\Mesh Agent\`; a entrada **Sonar** na lista de programas instalados. A política do Windows Update definida na instalação é revertida, de modo que o Windows volta a instalar as atualizações automaticamente |
| Linux      | `sonaragent.service` e o arquivo de unidade dele, `/usr/local/bin/sonaragent`, `/opt/sonaragent/`, `/etc/sonaragent.json`; o agente de acesso remoto, `meshagent.service` e `/opt/sonarmesh/`                                                                                                                                                                                                                                                                                                      |
| macOS      | O launch daemon `sonaragent` e o plist dele, `/opt/sonaragent/`, `/etc/sonaragent.json`; o agente de acesso remoto e `/opt/sonarmesh/`                                                                                                                                                                                                                                                                                                                                                             |

Com **Remove Agent** e **Archive Agent**, o dispositivo também é removido do serviço de acesso remoto, de modo que o controle remoto deixa de ser oferecido para ele.

## Como verificar se funcionou

1. **Console, Remove Agent:** o dispositivo não aparece mais em **Dashboard › Sysadmin** quando você pesquisa pelo nome do host. Em **Reports & Audits › Audits**, uma entrada **Delete** diz *\<user> deleted agent \<hostname> - \<reason>*.
2. **Console, Archive Agent:** o menu de ações do dispositivo passa a oferecer **Unarchive Agent**.
3. **Dispositivo Windows:** `sc query sonarrmm` retorna *The specified service does not exist as an installed service*, e `C:\Program Files\Sonar\` não existe mais.
4. **Dispositivo Linux:** `systemctl status sonaragent` informa que a unidade não foi encontrada.
5. **Dispositivo macOS:** `sudo launchctl print system/sonaragent` informa que o serviço não foi encontrado.

## Erros comuns

| Sintoma                                                                                  | Causa                                                                                                                 | Correção                                                                                                                                                         |
| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A caixa de diálogo **Agent offline** aparece                                             | O dispositivo está desligado ou não consegue alcançar o SONAR, então o comando de desinstalação não pode ser entregue | Clique em **Yes** para remover o registro e depois desinstale localmente no dispositivo; ou clique em **No** e tente de novo quando o dispositivo estiver online |
| O dispositivo foi removido no console, mas o agente continua no computador               | O dispositivo estava offline quando foi removido                                                                      | Desinstale localmente, com os comandos acima                                                                                                                     |
| Um dispositivo desinstalado localmente continua na lista como offline                    | Uma desinstalação local não altera o console                                                                          | Remova-o com **Remove Agent** e responda **Yes** em **Agent offline**                                                                                            |
| **Remove Agent** continua desabilitado em **Remove \<hostname>**                         | O **Reason** está vazio                                                                                               | Digite um motivo                                                                                                                                                 |
| **Remove Agent** ou **Archive Agent** mostra *You don't have permission for this action* | O seu papel não tem **Uninstall Agents** ou **Edit Agent**                                                            | Solicite a permissão                                                                                                                                             |
| Depois de reinstalar, o dispositivo aparece duas vezes                                   | O registro antigo foi mantido (arquivado, ou desinstalado localmente) e a reinstalação criou um novo                  | Remova o registro antigo com **Remove Agent**                                                                                                                    |

## Páginas relacionadas

* [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md)
* [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)
* [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md)
