> 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/install-agent-macos.md).

# Instalar o agente no macOS

Instale o agente do SONAR em um Mac Intel ou Apple silicon com o comando de Agents › Install Agent, confira o que ele instala e verifique se o Mac se reporta.

## O que é e quando usar

No macOS, **Agents › Install Agent** produz um comando de uma linha para o Terminal, vinculado a um cliente e a um site. Executado no Mac, o comando baixa o agente do SONAR para a arquitetura escolhida e o executa com `sudo`. O agente então instala o agente de acesso remoto, registra o dispositivo e cria o launch daemon dele. O mesmo comando funciona em quantos Macs daquele site forem necessários enquanto continuar válido.

## Antes de começar

* O seu papel tem a permissão **Install Agents** em **Admin Center › Roles** e acesso ao site de destino.
* O Mac executa o macOS 12 Monterey ou posterior. Confira o processador: `uname -m` retorna `arm64` no Apple silicon e `x86_64` no Intel. Veja [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md).
* Você consegue executar comandos com `sudo` no Mac.
* O Mac consegue alcançar o endereço da API e o endereço de acesso remoto do SONAR na 443/tcp. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).

## Passos

### Obter o comando

1. Abra **Agents › Install Agent**, ou clique em **New Agent** na lista de dispositivos de **Dashboard › Sysadmin**.
2. Escolha o **Client** e o **Site**.
3. Em **Operating system**, selecione **macOS**.
4. Em **Agent type**, selecione **Workstation** ou **Server**.
5. Em **Architecture**, selecione **Apple Silicon** ou **Intel 64-bit**.
6. Se quiser, ligue **Enable token expiration (hours)** e informe em **Hours** por quantas horas o comando continua válido.
7. Clique em **View macOS install instructions**. A caixa de diálogo **Manual Installation** se abre com *Run the following command in your terminal*.
8. Clique em **Copy Command Line**. Para acrescentar um argumento de **Optional Arguments** (por exemplo `-desc "Design team iMac"`), adicione-o ao final do comando.

As opções de **Optional features** valem para dispositivos Windows. A instalação no macOS não as usa.

### Executar no Mac

1. Abra o **Terminal** no Mac, em uma pasta na qual você possa gravar, como a sua pasta pessoal.
2. Cole o comando e pressione Return. Ele baixa o arquivo do agente `sonaragent-v<version>-darwin-<architecture>`, torna-o executável e o executa com `sudo`.
3. Digite a senha de administrador quando o `sudo` pedir.
4. Aguarde *Installation was successful!* na saída.

O agente se copia para `/opt/sonaragent/`, então o arquivo baixado pode ser excluído depois.

### Pastas que o macOS protege

Em um Mac, a janela de acesso remoto do SONAR oferece **Terminal**, **File Browser** e **Processes**. O macOS mantém algumas pastas (entre elas a Mesa, os Documentos e os Downloads de um usuário) fora do alcance dos serviços em segundo plano até que o acesso seja permitido. Para navegar nessas pastas ou alterá-las a partir do **Terminal** ou do **File Browser**, permita o agente de acesso remoto, `meshagent` em `/opt/sonarmesh/`, em **Full Disk Access** (acesso total ao disco), em **System Settings › Privacy & Security**. Em Macs gerenciados, um perfil de configuração de MDM (Privacy Preferences Policy Control) pode conceder a mesma permissão.

## O que você deve ver

O que a instalação cria:

| Item                    | Onde                                                                                                                         |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Agente do SONAR         | `/opt/sonaragent/sonaragent`                                                                                                 |
| Launch daemon do agente | `/Library/LaunchDaemons/sonaragent.plist`, rótulo `sonaragent`. Inicia com o sistema e é reiniciado automaticamente se parar |
| Configuração do agente  | `/etc/sonaragent.json`                                                                                                       |
| Log do agente           | `/var/log/sonaragent.log`                                                                                                    |
| Agente de acesso remoto | `/opt/sonarmesh/`, rótulo de launch daemon `meshagent`                                                                       |

Se o Mac já tinha um agente, o instalador primeiro remove o agente antigo e o agente de acesso remoto antigo (*Existing meshagent found, attempting to remove...*, *Existing sonaragent plist found, attempting to remove...*) e depois instala de novo.

## Como verificar se funcionou

1. No Mac:

   ```bash
   sudo launchctl print system/sonaragent | grep state
   sudo launchctl print system/meshagent | grep state
   ```

   Os dois precisam mostrar `state = running`.
2. No console, abra **Dashboard › Sysadmin**, escolha o cliente e pesquise o nome do host. A linha mostra **Agent Status** **Online**, o **OS** informado pelo Mac, o **Client**, o **Site** e o **Type** que você escolheu, e a data de hoje em **First Seen**.
3. Selecione a linha. O cabeçalho do painel de detalhes mostra a versão do agente e, depois que o agente de acesso remoto se conecta, **Remote Online**.
4. Clique em **Take Control**. A janela de acesso remoto se abre em **Terminal**, com um shell no Mac.
5. Em **Reports & Audits › Audits**, uma entrada **Agent Install** registra o novo agente com o nome do host dele.

## Erros comuns

| Sintoma                                                                                                                  | Causa                                                                           | Correção                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *must run as root*                                                                                                       | O agente foi executado sem `sudo`                                               | Execute de novo o comando inteiro, tal como foi copiado; ele já inclui `sudo`                                                                            |
| O shell informa *Bad CPU type in executable*                                                                             | A arquitetura escolhida não corresponde à do Mac                                | Obtenha o comando de novo com a outra opção de **Architecture**                                                                                          |
| *Installer token has expired. Please generate a new one.*                                                                | O comando foi gerado com expiração do token e o prazo já passou                 | Obtenha um novo comando                                                                                                                                  |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM*                   | O comando foi salvo antes de a versão do agente do SONAR mudar                  | Obtenha um novo comando                                                                                                                                  |
| *Unable to download the mesh agent from the RMM.*                                                                        | O instalador não conseguiu obter o agente de acesso remoto pelo endereço da API | Confira a conectividade com o endereço da API e execute o comando de novo                                                                                |
| **Terminal** ou **File Browser** recebe *Operation not permitted* na Mesa, nos Documentos ou nos Downloads de um usuário | O macOS protege essas pastas                                                    | Permita `meshagent` em **Full Disk Access**                                                                                                              |
| O dispositivo está online, mas mostra **Remote Offline**                                                                 | O agente de acesso remoto não consegue alcançar o endereço de acesso remoto     | Veja [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md#um-dispositivo-aparece-como-remote-offline) |

## Referência de campos

| Campo                               | O que faz                                                                                  | Valores aceitos                            | Padrão                            |
| ----------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------ | --------------------------------- |
| **Client**                          | Cliente em que o Mac é registrado                                                          | Clientes aos quais o seu papel dá acesso   | Primeiro cliente da lista         |
| **Site**                            | Site em que o Mac é registrado                                                             | Sites do cliente escolhido                 | Primeiro site do cliente          |
| **Operating system**                | Plataforma do instalador                                                                   | **Windows**, **Linux**, **macOS**          | **Windows**                       |
| **Agent type**                      | Registra o Mac como estação de trabalho ou como servidor, o que aparece na coluna **Type** | **Workstation**, **Server**                | **Workstation**                   |
| **Architecture**                    | Arquitetura de processador do agente que o comando baixa                                   | **Intel 64-bit**, **Apple Silicon**        | **Intel 64-bit**                  |
| **Enable token expiration (hours)** | Quando ligado, o comando deixa de funcionar depois do número de horas informado            | Ligado, desligado; **Hours** de 1 a 999999 | Desligado; 24 horas quando ligado |

### Argumentos opcionais

| Argumento                          | O que faz                                                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `-log debug`                       | Saída detalhada durante a instalação                                                                                                 |
| `-silent`                          | Aceito por compatibilidade com o instalador do Windows. Não muda nada no macOS: a instalação sempre escreve as mensagens no terminal |
| `-nomesh`                          | Não instala o agente de acesso remoto. A janela de acesso remoto fica então indisponível para o Mac                                  |
| `-desc "<text>"`                   | Define a **Description** do dispositivo                                                                                              |
| `-proxy "http://proxyserver:port"` | Usa um proxy HTTP. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md#proxies)      |

## Páginas relacionadas

* [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md)
* [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md)
* [Terminal remoto](https://wiki.datadike.com/pt/sonar/administration/remote-access/remote-terminal.md)
* [Remover agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/remove-agents.md)
* [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)
