> 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/fr/sonar/deploy-operate/install-agent-linux.md).

# Installer l'agent sous Linux

Téléchargez le script d'installation Linux dans Agents › Install Agent, exécutez-le en root et vérifiez le service systemd sonaragent et l'appareil dans Sysadmin.

## Ce que c'est et quand l'utiliser

Sous Linux, **Agents › Install Agent** produit un script shell lié à un client et à un site. Exécuté en tant que root sur l'appareil, le script télécharge l'agent SONAR, installe l'agent d'accès à distance, enregistre l'appareil et crée le service systemd `sonaragent`. Le même script peut être réutilisé sur autant d'appareils Linux de ce site que nécessaire tant qu'il reste valide, et il sert aussi de programme de désinstallation.

## Avant de commencer

* Votre rôle dispose de l'autorisation **Install Agents** dans **Admin Center › Roles**, ainsi que de l'accès au site cible.
* L'appareil exécute une distribution Linux qui utilise systemd comme système d'initialisation : `ps --no-headers -o comm 1` doit afficher `systemd`. Voir [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md).
* Vous pouvez exécuter des commandes en tant que `root` sur l'appareil, via SSH ou depuis une console texte. Le script refuse de s'exécuter depuis une session graphique.
* `bash` et `wget` sont installés.
* L'appareil peut joindre l'adresse de l'API et l'adresse d'accès à distance de SONAR sur 443/tcp. Voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).

## Étapes

1. Ouvrez **Agents › Install Agent**, ou cliquez sur **New Agent** dans la liste des appareils de **Dashboard › Sysadmin**.
2. Choisissez le **Client** et le **Site**.
3. Sous **Operating system**, sélectionnez **Linux**.
4. Sous **Agent type**, sélectionnez **Workstation** ou **Server**.
5. Sous **Architecture**, sélectionnez **64-bit**, **32-bit**, **ARM 64-bit** ou **ARM 32-bit**, selon l'appareil (`uname -m` : `x86_64`, `i686`, `aarch64`, `armv7l`).
6. Si vous le souhaitez, activez **Enable token expiration (hours)** et saisissez dans **Hours** le nombre d'heures pendant lesquelles le script reste valide.
7. Cliquez sur **Download Linux install script (.sh)**. Le fichier s'appelle `sonar-<client>-<site>-<type>.sh`.
8. Copiez le script sur l'appareil, par exemple avec `scp`.
9. Sur l'appareil, exécutez-le en tant que root :

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

   Pour afficher une sortie détaillée pendant l'enregistrement de l'agent, ajoutez `--debug`. Pour installer l'agent SONAR sans l'agent d'accès à distance, ajoutez `--nomesh` ; le contrôle à distance n'est alors pas disponible sur cet appareil.

Les options d'**Optional features** s'appliquent aux appareils Windows. Le script Linux ne les utilise pas.

## Ce que vous devez voir

Le script affiche sa progression :

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

suivie de la sortie de l'enregistrement de l'agent lui-même, qui se termine par *Installation was successful!*

Ce que le script installe :

| Élément                  | Emplacement                                                                                                                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent SONAR              | `/usr/local/bin/sonaragent`                                                                                                                                                                                       |
| Service de l'agent       | `sonaragent.service`, fichier d'unité `/etc/systemd/system/sonaragent.service`, description *Sonar RMM Linux Agent*. S'exécute en tant que `root`, activé au démarrage et redémarré automatiquement s'il s'arrête |
| Configuration de l'agent | `/etc/sonaragent.json`                                                                                                                                                                                            |
| Journal de l'agent       | `/var/log/sonaragent.log`                                                                                                                                                                                         |
| Agent d'accès à distance | `/opt/sonarmesh/`, service `meshagent.service`                                                                                                                                                                    |

Avant d'installer, le script supprime tout agent SONAR et tout agent d'accès à distance antérieurs qu'il trouve sur l'appareil, si bien qu'une nouvelle exécution effectue une réinstallation propre. Avant d'installer l'agent d'accès à distance, il génère également les paramètres régionaux `en_US.UTF-8` et les définit comme paramètres régionaux du système.

## Comment vérifier que cela a fonctionné

1. Sur l'appareil :

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

   Les deux doivent indiquer `active (running)`.
2. Dans la console, ouvrez **Dashboard › Sysadmin**, choisissez le client et recherchez le nom d'hôte. La ligne affiche **Agent Status** **Online**, l'**OS** remonté par l'appareil, le **Client**, le **Site** et le **Type** choisis, et la date du jour dans **First Seen**.
3. Sélectionnez la ligne. L'en-tête du panneau de détails affiche la version de l'agent, et aucun badge **Remote Offline** une fois l'agent d'accès à distance connecté.
4. Dans **Reports & Audits › Audits**, une entrée **Agent Install** consigne le nouvel agent avec son nom d'hôte.

## Erreurs courantes

| Symptôme                                                                                               | Cause                                                                                                                                                        | Correction                                                                                                                          |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| *ERROR: Must be run as root*                                                                           | Le script n'a pas été exécuté en tant que root                                                                                                               | Exécutez-le avec `sudo` ou en tant que `root`                                                                                       |
| *This install script only supports systemd*                                                            | La distribution n'utilise pas systemd                                                                                                                        | L'agent a besoin de systemd ; voir [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md)     |
| *ERROR: Display detected. Installer only supports running headless, i.e from ssh.*                     | Le script a été lancé depuis une session graphique, ou avec le transfert X                                                                                   | Exécutez-le via SSH, passez à une session texte avec `sudo systemctl isolate multi-user.target` ou exécutez d'abord `unset DISPLAY` |
| *ERROR: Unknown parameter: …*                                                                          | Un argument que le script n'accepte pas a été passé. Avec `uninstall` comme seul argument, le script désinstalle ; sinon, il accepte `--debug` et `--nomesh` | Retirez l'argument                                                                                                                  |
| *ERROR: Unable to download sonar agent*                                                                | L'appareil ne peut pas télécharger depuis l'adresse de l'API                                                                                                 | Vérifiez le 443/tcp et la résolution de noms de l'adresse de l'API                                                                  |
| *Installer token has expired. Please generate a new one.*                                              | Le script a été généré avec une expiration du jeton et ce délai est écoulé                                                                                   | Téléchargez un nouveau script                                                                                                       |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM* | Le script a été enregistré avant que la version de l'agent SONAR ne change                                                                                   | Téléchargez un nouveau script                                                                                                       |
| Le script reste bloqué sur *Getting mesh node id...*                                                   | L'agent d'accès à distance n'a pas démarré ou ne peut pas joindre l'adresse d'accès à distance                                                               | Vérifiez `systemctl status meshagent` et la connectivité vers l'adresse d'accès à distance sur 443/tcp                              |
| `sonaragent` s'exécute mais l'appareil n'apparaît jamais **Online**                                    | L'agent ne parvient pas à maintenir sa connexion avec l'adresse de l'API                                                                                     | Voir [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)                                    |

## Référence des champs

| Champ                               | Ce qu'il fait                                                                                           | Valeurs acceptées                                      | Par défaut                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------ |
| **Client**                          | Client sous lequel l'appareil est enregistré                                                            | Clients auxquels votre rôle donne accès                | Premier client de la liste           |
| **Site**                            | Site sous lequel l'appareil est enregistré                                                              | Sites du client choisi                                 | Premier site du client               |
| **Operating system**                | Plateforme du programme d'installation                                                                  | **Windows**, **Linux**, **macOS**                      | **Windows**                          |
| **Agent type**                      | Enregistre l'appareil comme poste de travail ou comme serveur, ce qui apparaît dans la colonne **Type** | **Workstation**, **Server**                            | **Workstation**                      |
| **Architecture**                    | Architecture de processeur de l'agent que le script télécharge                                          | **64-bit**, **32-bit**, **ARM 64-bit**, **ARM 32-bit** | **64-bit**                           |
| **Enable token expiration (hours)** | Lorsque cette option est activée, le script cesse de fonctionner après le nombre d'heures saisi         | Activé, désactivé ; **Hours** de 1 à 999999            | Désactivé ; 24 heures à l'activation |

### Arguments du script

| Argument    | Ce qu'il fait                                                                                                                                                              |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--debug`   | Affiche une sortie détaillée pendant l'enregistrement de l'agent                                                                                                           |
| `--nomesh`  | N'installe pas l'agent d'accès à distance                                                                                                                                  |
| `uninstall` | Retire l'agent SONAR et l'agent d'accès à distance au lieu de les installer. Voir [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md) |

## Pages associées

* [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md)
* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)
* [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md)
* [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md)
* [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)
