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

# Retirer des agents

Retirez l'agent SONAR depuis le menu d'actions de l'appareil, désinstallez-le localement sur Windows, Linux ou macOS, ou archivez l'appareil pour garder son historique.

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

Retirer un agent désinstalle SONAR de l'appareil et sort l'appareil de la console. Utilisez-le lorsqu'un appareil est mis au rebut, remplacé ou quitte votre gestion. Il existe trois façons de procéder, aux résultats différents :

| Action                                           | Désinstalle de l'appareil            | Fiche de l'appareil dans la console                                                     |
| ------------------------------------------------ | ------------------------------------ | --------------------------------------------------------------------------------------- |
| **Remove Agent** (menu d'actions de l'appareil)  | Oui, lorsque l'appareil est en ligne | Supprimée, avec ses données                                                             |
| **Archive Agent** (menu d'actions de l'appareil) | Oui, lorsque l'appareil est en ligne | Conservée, avec son historique, marquée comme archivée                                  |
| Désinstallation locale sur l'appareil            | Oui                                  | Conservée ; l'appareil passe hors ligne jusqu'à ce que vous le retiriez dans la console |

## Avant de commencer

* **Remove Agent** nécessite **Uninstall Agents** dans **Admin Center › Roles**. **Archive Agent** nécessite **Edit Agent**. Ces deux actions ne fonctionnent que sur les appareils des sites auxquels votre rôle donne accès.
* Déterminez si vous avez encore besoin de l'historique de l'appareil dans la console. **Remove Agent** le supprime ; **Archive Agent** le conserve.
* Pour une désinstallation locale, il vous faut les droits d'administrateur sur Windows, ou `root` sur Linux et macOS.

## Étapes

### Retirer un agent depuis la console

1. Dans **Dashboard › Sysadmin**, sélectionnez l'appareil.
2. Ouvrez le menu d'actions de l'appareil (**Other actions**, dans l'en-tête du panneau de détails) et choisissez **Remove Agent**.
3. SONAR vérifie d'abord si l'appareil répond.
   * S'il ne répond pas, la boîte de dialogue **Agent offline** affiche *… cannot be contacted. Would you like to continue with the uninstall? If so, the agent will need to be manually uninstalled from the computer.* Cliquez sur **Yes** pour continuer ou sur **No** pour arrêter.
4. Dans **Remove \<hostname>**, saisissez le **Reason**. Il est obligatoire et il est conservé dans la piste d'audit.
5. Cliquez sur **Remove Agent**.

### Archiver un agent

1. Sélectionnez l'appareil et ouvrez le menu d'actions de l'appareil.
2. Choisissez **Archive Agent**.
3. Dans **Archive Agent**, saisissez `yes` pour confirmer, puis cliquez sur **Archive**.

**Archive Agent** désinstalle l'agent de l'appareil de la même façon que **Remove Agent**, mais la fiche de l'appareil et son historique restent dans la console. SONAR ne déclenche aucune alerte pour un appareil archivé, et les appareils archivés ne sont pas comptés parmi les appareils en ligne, hors ligne ou en retard.

**Unarchive Agent**, dans le même menu, retire la marque d'archivage. Cette action ne réinstalle rien : pour gérer de nouveau l'appareil, installez-y l'agent. L'appareil s'enregistre alors sous une nouvelle fiche.

### Désinstaller localement sur Windows

Dans une invite de commandes élevée :

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

Pour un agent 32 bits sur un Windows 64 bits, le programme de désinstallation est `C:\Program Files (x86)\Sonar\uninstall.exe`. L'agent peut aussi être supprimé sous le nom **Sonar** depuis la liste des programmes installés de Windows.

### Désinstaller localement sur Linux

Exécutez en tant que root le script d'installation Linux obtenu dans **Agents › Install Agent**, avec l'argument `uninstall` :

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

N'importe quel script Linux généré par la console convient, quels que soient son client, son site ou son expiration. Le script se supprime lui-même à la fin.

### Désinstaller localement sur macOS

En tant qu'administrateur, dans 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
```

## Ce que vous devez voir

**Remove Agent** se termine par *\<hostname> will now be uninstalled.* et l'appareil quitte la liste des appareils. **Archive Agent** se termine par *Archived was enabled on \<hostname>*.

Ce que la désinstallation retire de l'appareil :

| Plateforme | Éléments retirés                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows    | Le service `sonarrmm` ; le service du module de productivité, `SonarProductivityService` ; l'agent d'accès à distance ; la configuration `HKLM\SOFTWARE\Sonar` ; `C:\ProgramData\Sonar\` et les tâches planifiées créées par SONAR ; les dossiers `C:\Program Files\Sonar\` et `C:\Program Files\Mesh Agent\` ; l'entrée **Sonar** de la liste des programmes installés. La stratégie Windows Update définie à l'installation est rétablie, si bien que Windows installe de nouveau les mises à jour automatiquement |
| Linux      | `sonaragent.service` et son fichier d'unité, `/usr/local/bin/sonaragent`, `/opt/sonaragent/`, `/etc/sonaragent.json` ; l'agent d'accès à distance, `meshagent.service` et `/opt/sonarmesh/`                                                                                                                                                                                                                                                                                                                          |
| macOS      | Le launch daemon `sonaragent` et son plist, `/opt/sonaragent/`, `/etc/sonaragent.json` ; l'agent d'accès à distance et `/opt/sonarmesh/`                                                                                                                                                                                                                                                                                                                                                                             |

Avec **Remove Agent** et **Archive Agent**, l'appareil est aussi retiré du service d'accès à distance, de sorte que la prise de contrôle à distance ne lui est plus proposée.

## Comment vérifier que cela a fonctionné

1. **Console, Remove Agent :** l'appareil n'apparaît plus dans **Dashboard › Sysadmin** lorsque vous recherchez son nom d'hôte. Dans **Reports & Audits › Audits**, une entrée **Delete** indique *\<user> deleted agent \<hostname> - \<reason>*.
2. **Console, Archive Agent :** le menu d'actions de l'appareil propose désormais **Unarchive Agent**.
3. **Appareil Windows :** `sc query sonarrmm` renvoie *The specified service does not exist as an installed service*, et `C:\Program Files\Sonar\` a disparu.
4. **Appareil Linux :** `systemctl status sonaragent` indique que l'unité est introuvable.
5. **Appareil macOS :** `sudo launchctl print system/sonaragent` indique que le service est introuvable.

## Erreurs courantes

| Symptôme                                                                                  | Cause                                                                                                                     | Correction                                                                                                                                                   |
| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| La boîte de dialogue **Agent offline** apparaît                                           | L'appareil est éteint ou ne peut pas joindre SONAR, si bien que la commande de désinstallation ne peut pas lui parvenir   | Cliquez sur **Yes** pour retirer la fiche, puis désinstallez localement sur l'appareil ; ou cliquez sur **No** et réessayez lorsque l'appareil sera en ligne |
| L'appareil a été retiré dans la console, mais l'agent est toujours sur l'ordinateur       | L'appareil était hors ligne au moment du retrait                                                                          | Désinstallez localement, avec les commandes ci-dessus                                                                                                        |
| Un appareil désinstallé localement reste dans la liste comme hors ligne                   | Une désinstallation locale ne modifie pas la console                                                                      | Retirez-le avec **Remove Agent** et répondez **Yes** dans **Agent offline**                                                                                  |
| **Remove Agent** reste désactivé dans **Remove \<hostname>**                              | Le **Reason** est vide                                                                                                    | Saisissez un motif                                                                                                                                           |
| **Remove Agent** ou **Archive Agent** affiche *You don't have permission for this action* | Votre rôle ne dispose pas de **Uninstall Agents** ou d'**Edit Agent**                                                     | Demandez la permission                                                                                                                                       |
| Après une réinstallation, l'appareil apparaît deux fois                                   | L'ancienne fiche a été conservée (archivée, ou désinstallée localement) et la réinstallation en a enregistré une nouvelle | Retirez l'ancienne fiche avec **Remove Agent**                                                                                                               |

## Pages associées

* [La liste des appareils](https://wiki.datadike.com/fr/sonar/administration/devices/device-list.md)
* [Installer l'agent sous Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md)
* [Installer l'agent sous Linux](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-linux.md)
* [Installer l'agent sous macOS](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-macos.md)
* [Piste d'audit](https://wiki.datadike.com/fr/sonar/administration/audit/audit-trail.md)
