> 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-linux.md).

# Instalar o agente no Linux

Baixe o script de instalação para Linux em Agents › Install Agent, execute-o como root e confirme o serviço systemd sonaragent e o dispositivo em Sysadmin.

## O que é e quando usar

No Linux, **Agents › Install Agent** produz um script de shell vinculado a um cliente e a um site. Executado como root no dispositivo, o script baixa o agente do SONAR, instala o agente de acesso remoto, registra o dispositivo e cria o serviço systemd `sonaragent`. O mesmo script pode ser reutilizado em quantos dispositivos Linux daquele site forem necessários enquanto continuar válido, e ele também serve de desinstalador.

## Antes de começar

* O seu papel tem a permissão **Install Agents** em **Admin Center › Roles** e acesso ao site de destino.
* O dispositivo executa uma distribuição Linux com o systemd como sistema de inicialização: `ps --no-headers -o comm 1` precisa exibir `systemd`. Veja [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md).
* Você consegue executar comandos como `root` no dispositivo, por SSH ou por um console de texto. O script se recusa a ser executado a partir de uma sessão gráfica.
* `bash` e `wget` estão instalados.
* O dispositivo 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

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 **Linux**.
4. Em **Agent type**, selecione **Workstation** ou **Server**.
5. Em **Architecture**, selecione **64-bit**, **32-bit**, **ARM 64-bit** ou **ARM 32-bit**, de acordo com o dispositivo (`uname -m`: `x86_64`, `i686`, `aarch64`, `armv7l`).
6. Se quiser, ligue **Enable token expiration (hours)** e informe em **Hours** por quantas horas o script continua válido.
7. Clique em **Download Linux install script (.sh)**. O arquivo se chama `sonar-<client>-<site>-<type>.sh`.
8. Copie o script para o dispositivo, por exemplo com `scp`.
9. No dispositivo, execute-o como root:

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

   Para ver uma saída detalhada enquanto o agente se registra, acrescente `--debug`. Para instalar o agente do SONAR sem o agente de acesso remoto, acrescente `--nomesh`; o controle remoto fica então indisponível nesse dispositivo.

As opções de **Optional features** valem para dispositivos Windows. O script para Linux não as usa.

## O que você deve ver

O script exibe o andamento:

```
Downloading sonar agent...
Downloading and installing mesh agent...
Getting mesh node id...
```

seguido da saída do próprio registro do agente, que termina com *Installation was successful!*

O que o script instala:

| Item                    | Onde                                                                                                                                                                                                             |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agente do SONAR         | `/usr/local/bin/sonaragent`                                                                                                                                                                                      |
| Serviço do agente       | `sonaragent.service`, arquivo de unidade `/etc/systemd/system/sonaragent.service`, descrição *Sonar RMM Linux Agent*. É executado como `root`, habilitado na inicialização 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/`, serviço `meshagent.service`                                                                                                                                                                   |

Antes de instalar, o script remove qualquer agente do SONAR e agente de acesso remoto anteriores que encontrar no dispositivo, de modo que executá-lo de novo faz uma reinstalação limpa. Antes de instalar o agente de acesso remoto, ele também gera a localidade `en_US.UTF-8` e a define como localidade do sistema.

## Como verificar se funcionou

1. No dispositivo:

   ```bash
   systemctl status sonaragent
   systemctl status meshagent
   ```

   Os dois precisam informar `active (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 dispositivo, 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 nenhum indicador **Remote Offline** depois que o agente de acesso remoto se conecta.
4. Em **Reports & Audits › Audits**, uma entrada **Agent Install** registra o novo agente com o nome do host dele.

## Erros comuns

| Sintoma                                                                                                | Causa                                                                                                                                                | Correção                                                                                                                           |
| ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| *ERROR: Must be run as root*                                                                           | O script não foi executado como root                                                                                                                 | Execute-o com `sudo` ou como `root`                                                                                                |
| *This install script only supports systemd*                                                            | A distribuição não usa systemd                                                                                                                       | O agente precisa do systemd; veja [Requisitos dos dispositivos](https://wiki.datadike.com/pt/sonar/deploy-operate/requirements.md) |
| *ERROR: Display detected. Installer only supports running headless, i.e from ssh.*                     | O script foi iniciado a partir de uma sessão gráfica, ou com encaminhamento X                                                                        | Execute-o por SSH, mude para uma sessão de texto com `sudo systemctl isolate multi-user.target` ou execute `unset DISPLAY` antes   |
| *ERROR: Unknown parameter: …*                                                                          | Foi passado um argumento que o script não aceita. Com `uninstall` como único argumento o script desinstala; fora isso, aceita `--debug` e `--nomesh` | Remova o argumento                                                                                                                 |
| *ERROR: Unable to download sonar agent*                                                                | O dispositivo não consegue baixar a partir do endereço da API                                                                                        | Confira a 443/tcp e a resolução de nomes do endereço da API                                                                        |
| *Installer token has expired. Please generate a new one.*                                              | O script foi gerado com expiração do token e o prazo já passou                                                                                       | Baixe um novo script                                                                                                               |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM* | O script foi salvo antes de a versão do agente do SONAR mudar                                                                                        | Baixe um novo script                                                                                                               |
| O script fica parado em *Getting mesh node id...*                                                      | O agente de acesso remoto não iniciou ou não consegue alcançar o endereço de acesso remoto                                                           | Confira `systemctl status meshagent` e a conectividade com o endereço de acesso remoto na 443/tcp                                  |
| `sonaragent` está em execução, mas o dispositivo nunca aparece como **Online**                         | O agente não consegue manter a conexão com o endereço da API                                                                                         | Veja [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)                      |

## Referência de campos

| Campo                               | O que faz                                                                                          | Valores aceitos                                        | Padrão                            |
| ----------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | --------------------------------- |
| **Client**                          | Cliente em que o dispositivo é registrado                                                          | Clientes aos quais o seu papel dá acesso               | Primeiro cliente da lista         |
| **Site**                            | Site em que o dispositivo é registrado                                                             | Sites do cliente escolhido                             | Primeiro site do cliente          |
| **Operating system**                | Plataforma do instalador                                                                           | **Windows**, **Linux**, **macOS**                      | **Windows**                       |
| **Agent type**                      | Registra o dispositivo 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 script baixa                                            | **64-bit**, **32-bit**, **ARM 64-bit**, **ARM 32-bit** | **64-bit**                        |
| **Enable token expiration (hours)** | Quando ligado, o script deixa de funcionar depois do número de horas informado                     | Ligado, desligado; **Hours** de 1 a 999999             | Desligado; 24 horas quando ligado |

### Argumentos do script

| Argumento   | O que faz                                                                                                                                                            |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--debug`   | Exibe uma saída detalhada enquanto o agente se registra                                                                                                              |
| `--nomesh`  | Não instala o agente de acesso remoto                                                                                                                                |
| `uninstall` | Remove o agente do SONAR e o agente de acesso remoto, em vez de instalar. Veja [Remover agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/remove-agents.md) |

## 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)
* [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.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)
