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

# Requisitos dos dispositivos

O que um endpoint Windows, Linux ou macOS precisa para executar o agente do SONAR: sistemas operacionais, arquiteturas, privilégios e exclusões de antivírus.

## O que esta página cobre

O que um dispositivo precisa antes de você instalar nele o agente do SONAR: quais sistemas operacionais e arquiteturas de processador têm instalador, quais privilégios a instalação exige, o que é gravado em disco e quais pastas e processos excluir da varredura do antivírus e do EDR.

O servidor do SONAR é operado pela DataDike. Nada nesta página se aplica a ele: os requisitos abaixo valem para os endpoints que você gerencia. Para as conexões que um endpoint precisa conseguir abrir, veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).

## Sistemas operacionais e arquiteturas

O console gera um instalador por sistema operacional e arquitetura. Estas são as combinações que ele oferece e as versões de sistema operacional em que o agente é executado.

| Plataforma | Arquiteturas oferecidas em **Install Agent**                          | Versões de sistema operacional                                                                           |
| ---------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Windows    | **64-bit** (x64), **32-bit** (x86)                                    | Windows 10, Windows 11, Windows Server 2016 e posteriores                                                |
| Linux      | **64-bit** (x86-64), **32-bit** (x86), **ARM 64-bit**, **ARM 32-bit** | Qualquer distribuição que use o systemd como sistema de inicialização, com kernel Linux 3.2 ou posterior |
| macOS      | **Intel 64-bit**, **Apple Silicon**                                   | macOS 12 Monterey e posteriores                                                                          |

Pontos que decidem qual instalador escolher:

* **Instalador Windows de 64 bits em Windows de 32 bits.** O instalador de 64 bits verifica o sistema operacional e se encerra com a mensagem *This application requires a 64-bit Windows operating system.* Use o instalador **32-bit** no Windows de 32 bits.
* **Windows em ARM.** Não existe instalador ARM para Windows.
* **Linux sem systemd.** O script de instalação para Linux se encerra com a mensagem *This install script only supports systemd*. Para verificar uma máquina, execute `ps --no-headers -o comm 1`: a saída precisa ser `systemd`.
* **Distribuições Linux que o script reconhece.** O script configura a localidade (locale) do sistema de uma de duas formas: uma para a família Debian (Ubuntu, Debian, Raspbian, Kali, Linux Mint) e outra para as demais distribuições que ele reconhece (Fedora, Rocky Linux, CentOS, RHEL, Amazon Linux, Arch, openSUSE). Qualquer outra distribuição com systemd é configurada da segunda forma.
* **macOS.** Escolha **Apple Silicon** para Macs da série M e **Intel 64-bit** para Macs Intel. `uname -m` retorna `arm64` no Apple silicon e `x86_64` no Intel.

O que cada plataforma pode fazer depois que o agente é instalado varia: o inventário de software, a aplicação de atualizações do Windows Update e o módulo de produtividade, por exemplo, existem só no Windows. Veja [Plataformas suportadas](https://wiki.datadike.com/pt/sonar/reference/supported-platforms.md).

## Privilégios necessários para instalar

| Plataforma | Quem executa o instalador                                                        | Conta com que o agente é executado |
| ---------- | -------------------------------------------------------------------------------- | ---------------------------------- |
| Windows    | Um administrador local. O instalador solicita elevação de privilégios            | Local System                       |
| Linux      | `root`, a partir de uma sessão sem ambiente gráfico (SSH ou um console de texto) | `root`                             |
| macOS      | Um administrador, por meio de `sudo`                                             | `root` (launch daemon do sistema)  |

Em qualquer outra condição, o script para Linux se recusa a ser executado:

* sem ser root: *ERROR: Must be run as root*;
* a partir de uma sessão gráfica: *ERROR: Display detected. Installer only supports running headless, i.e from ssh.* Execute-o por SSH, mude para uma sessão de texto com `sudo systemctl isolate multi-user.target` ou, se a variável vier apenas do encaminhamento X (X forwarding), execute `unset DISPLAY` e tente de novo.

O script para Linux também precisa de `bash` e `wget` na máquina.

## O que é gravado no dispositivo

### Windows

| Caminho                          | Conteúdo                                                                                                                                                                                                                                     |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `C:\Program Files\Sonar\`        | Executável do agente `sonarrmm.exe` (cerca de 10,6 MB na versão de 64 bits e 10,1 MB na de 32 bits), `uninstall.exe`, o arquivo de log `agent.log` e o módulo de produtividade `productivity.exe` (cerca de 25,4 MB), quando ele é instalado |
| `C:\Program Files\Sonar\python\` | Ambiente de execução do Python que o agente baixa na primeira inicialização, usado para executar scripts Python                                                                                                                              |
| `C:\Program Files\Mesh Agent\`   | Agente de acesso remoto (`MeshAgent.exe`)                                                                                                                                                                                                    |
| `C:\ProgramData\Sonar\`          | Pasta de trabalho para scripts e atualizações do agente                                                                                                                                                                                      |
| `HKLM\SOFTWARE\Sonar`            | Configuração do agente                                                                                                                                                                                                                       |

Um agente de 32 bits instalado em Windows de 64 bits usa `C:\Program Files (x86)\Sonar\` e `C:\Program Files (x86)\Mesh Agent\` no lugar desses caminhos.

O instalador registra **Sonar**, editor **DataDike®**, na lista de programas instalados.

### Linux

| Caminho                                  | Conteúdo                                                               |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| `/usr/local/bin/sonaragent`              | Executável do agente (cerca de 10,5 a 11,3 MB, conforme a arquitetura) |
| `/opt/sonaragent/`                       | Pasta de trabalho do agente                                            |
| `/opt/sonarmesh/`                        | Agente de acesso remoto (`meshagent`)                                  |
| `/etc/sonaragent.json`                   | Configuração do agente                                                 |
| `/etc/systemd/system/sonaragent.service` | Unidade de serviço do agente                                           |
| `/var/log/sonaragent.log`                | Log do agente                                                          |

### macOS

| Caminho                                   | Conteúdo                                                               |
| ----------------------------------------- | ---------------------------------------------------------------------- |
| `/opt/sonaragent/sonaragent`              | Executável do agente (cerca de 10,7 a 11,4 MB, conforme a arquitetura) |
| `/opt/sonarmesh/`                         | Agente de acesso remoto (`meshagent`)                                  |
| `/Library/LaunchDaemons/sonaragent.plist` | Launch daemon do agente                                                |
| `/etc/sonaragent.json`                    | Configuração do agente                                                 |
| `/var/log/sonaragent.log`                 | Log do agente                                                          |

{% hint style="info" %}
No Windows, a instalação do agente configura a política do Windows Update para que o Windows não instale atualizações automaticamente: a aplicação de atualizações passa a ser conduzida pelo SONAR. Desinstalar o agente reativa as atualizações automáticas. Veja [Instalar o agente no Windows](https://wiki.datadike.com/pt/sonar/deploy-operate/install-agent-windows.md) para tudo o que o instalador altera.
{% endhint %}

## Exclusões de antivírus e EDR

O agente executa comandos, scripts e atualizações no dispositivo como Local System ou root, que é exatamente o comportamento que os produtos de segurança vigiam. Adicione estas exclusões ao seu antivírus ou EDR antes de uma implantação em larga escala.

### Windows

| Tipo     | Exclusão                                                                                                              |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| Pasta    | `C:\Program Files\Sonar\` (`C:\Program Files (x86)\Sonar\` para um agente de 32 bits em Windows de 64 bits)           |
| Pasta    | `C:\Program Files\Mesh Agent\` (`C:\Program Files (x86)\Mesh Agent\` para um agente de 32 bits em Windows de 64 bits) |
| Pasta    | `C:\ProgramData\Sonar\`                                                                                               |
| Processo | `sonarrmm.exe`                                                                                                        |
| Processo | `MeshAgent.exe`                                                                                                       |
| Processo | `productivity.exe`, onde o módulo de produtividade estiver instalado                                                  |

O método de instalação **PowerShell** adiciona ele mesmo as três pastas à lista de exclusões do Microsoft Defender quando o Defender está ativo. Com qualquer outro método, e com qualquer outro produto de segurança, adicione-as você mesmo.

### Linux

| Tipo     | Exclusão                    |
| -------- | --------------------------- |
| Arquivo  | `/usr/local/bin/sonaragent` |
| Pasta    | `/opt/sonaragent/`          |
| Pasta    | `/opt/sonarmesh/`           |
| Processo | `sonaragent`                |
| Processo | `meshagent`                 |

### macOS

| Tipo     | Exclusão           |
| -------- | ------------------ |
| Pasta    | `/opt/sonaragent/` |
| Pasta    | `/opt/sonarmesh/`  |
| Processo | `sonaragent`       |
| Processo | `meshagent`        |

## Como conferir se um dispositivo atende a esses requisitos

* **Windows:** no PowerShell, `[Environment]::Is64BitOperatingSystem` retorna `True` no Windows de 64 bits; `winver` mostra a versão.
* **Linux:** `ps --no-headers -o comm 1` retorna `systemd`; `uname -m` mostra a arquitetura (`x86_64`, `i686`, `aarch64`, `armv7l`); `uname -r` mostra a versão do kernel.
* **macOS:** `uname -m` retorna `arm64` ou `x86_64`; `sw_vers` mostra a versão do macOS.

## Páginas relacionadas

* [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.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)
* [Plataformas suportadas](https://wiki.datadike.com/pt/sonar/reference/supported-platforms.md)
