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

# Mettre à jour les agents

Comment les agents SONAR se mettent à jour d'eux-mêmes toutes les heures, le paramètre qui le contrôle, ce que fait l'appareil et comment vérifier la version.

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

Lorsque SONAR passe à une nouvelle version de l'agent, les agents déjà installés se mettent à jour d'eux-mêmes : vous n'avez pas à les réinstaller. Cette page explique comment cette mise à jour parvient à chaque appareil, ce que fait l'appareil pendant la mise à jour, comment suivre les mises à jour dans la console et comment vérifier la version qu'exécute un appareil.

## Avant de commencer

* Pour voir le paramètre de mise à jour automatique, votre rôle dispose de **View Core Settings** dans **Admin Center › Roles**.
* Pour suivre les mises à jour dans **Agents › Pending Actions**, il dispose de **List Pending Actions**.
* Les appareils doivent pouvoir télécharger depuis l'adresse de l'API SONAR en 443/tcp, via le proxy configuré à l'installation s'il y en a un. Consultez [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).

## Comment les mises à jour parviennent aux appareils

1. La **mise à jour automatique** est contrôlée par **Enable agent automatic self update** dans **Admin Center › Settings**, onglet **General** (info-bulle *Runs at 35mins past every hour*). La console affiche l'option en lecture seule ; elle est activée ou désactivée avec le support de mise en œuvre DataDike.
2. Tant qu'elle est activée, à la 35e minute de chaque heure, SONAR recherche les agents qui exécutent une version antérieure à la version actuelle de l'agent et envoie à chacun d'eux une commande de mise à jour par sa connexion.
3. Pour chacun de ces appareils, une action en attente **Agent update to \<version>** est enregistrée. La colonne **Due** indique l'heure du prochain cycle de mise à jour.
4. L'appareil télécharge le nouvel agent depuis l'adresse de l'API et l'installe (voir ci-dessous). Son service redémarre sur la nouvelle version.
5. Dès que l'appareil est de nouveau **Online** et remonte la nouvelle version, SONAR marque l'action en attente comme terminée, en une ou deux minutes.

Un appareil éteint ou déconnecté à la 35e minute de l'heure ne reçoit pas la commande. Le cycle de l'heure suivante la renvoie, de sorte que l'appareil se met à jour au premier cycle qui suit sa reconnexion. Il n'y a rien à planifier appareil par appareil.

## Ce que fait l'appareil pendant une mise à jour

| Plateforme | Étapes                                                                                                                                                                                                                                                                       |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows    | Attend un délai aléatoire de 1 à 15 secondes, télécharge l'installateur de la mise à jour dans `C:\ProgramData\Sonar\` et l'exécute en mode silencieux. L'installateur arrête le service `sonarrmm`, remplace `sonarrmm.exe`, enregistre de nouveau le service et le démarre |
| Linux      | Télécharge le nouvel agent à côté de `/usr/local/bin/sonaragent`, remplace le fichier, restaure son contexte SELinux là où SELinux est en mode enforcing, et redémarre `sonaragent.service`                                                                                  |
| macOS      | Télécharge le nouvel agent à côté de `/opt/sonaragent/sonaragent`, remplace le fichier et redémarre le launch daemon `sonaragent`                                                                                                                                            |

Ce qui reste inchangé :

* la configuration de l'agent, c'est-à-dire le client, le site, le type et les fonctionnalités optionnelles choisies à l'installation ;
* l'agent d'accès à distance ;
* sous Windows, le module de productivité (`SonarProductivityService`).

L'appareil n'est injoignable depuis la console que pendant les quelques secondes que prend le redémarrage du service.

## Ce que vous devez voir

* Dans **Agents › Pending Actions** (**All Pending Actions**), des lignes avec l'icône de mise à jour, **Description** *Agent update to \<version>*, ainsi que l'**Agent**, le **Client** et le **Site** de chaque appareil en attente de la mise à jour. Elles quittent la liste à mesure que les appareils terminent la mise à jour ; **Show N Completed** les fait réapparaître.
* Dans **Dashboard › Sysadmin**, la colonne **Pending Actions** compte les actions en attente de chaque appareil, mise à jour comprise.
* Sur un appareil, **Pending Agent Actions**, dans le menu d'actions de l'appareil, ouvre **Pending Actions for \<hostname>** avec les mêmes informations pour cet appareil seul.

## Comment vérifier que cela a fonctionné

1. Dans **Dashboard › Sysadmin**, sélectionnez l'appareil. L'en-tête du panneau de détails affiche la version de l'agent à côté du nom d'hôte.
2. Dans **Agents › Pending Actions**, l'appareil n'a plus de ligne **Agent update** en attente. Avec **Show N Completed**, sa mise à jour apparaît comme **Completed**.
3. Sur l'appareil lui-même :
   * **Windows :** exécutez `"C:\Program Files\Sonar\sonarrmm.exe" -version` ; la première ligne indique *Sonar RMM Agent: \<version>*. Exécuter `"C:\Program Files\Sonar\sonarrmm.exe"` sans argument affiche la version dans le titre de la boîte d'état **Sonar RMM**.
   * **Linux :** `/usr/local/bin/sonaragent -version`.
   * **macOS :** `/opt/sonaragent/sonaragent -version`.

## Erreurs courantes

| Symptôme                                                                                          | Cause                                                                             | Correction                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'action en attente **Agent update** d'un appareil persiste pendant plusieurs cycles              | L'appareil est hors ligne, ou ne peut pas télécharger depuis l'adresse de l'API   | Vérifiez **Agent Status** et **Last Response**. Si l'appareil est en ligne, vérifiez qu'il joint l'adresse de l'API en 443/tcp, puis cherchez des erreurs de téléchargement dans le journal de l'agent. Consultez [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md#journaux-de-lagent) |
| Un appareil Windows cesse de remonter des informations après un cycle de mise à jour              | Le service `sonarrmm` ne s'exécute pas sur l'appareil                             | Sur l'appareil, démarrez le service `sonarrmm` ; s'il est absent, réinstallez l'agent. Consultez [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)                                                                                                                                     |
| Aucune ligne **Agent update** n'apparaît alors que des appareils exécutent une version antérieure | **Enable agent automatic self update** est désactivé pour l'instance              | Contactez le support de mise en œuvre DataDike                                                                                                                                                                                                                                                                                   |
| Un installateur enregistré avant la nouvelle version s'arrête avec *Old installer detected*       | Les installateurs portent la version de l'agent avec laquelle ils ont été générés | Générez un nouvel installateur. Les agents déjà installés ne sont pas concernés, car ils se mettent à jour d'eux-mêmes                                                                                                                                                                                                           |

## Pages associées

* [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)
* [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md)
* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)
* [Paramètres généraux](https://wiki.datadike.com/fr/sonar/administration/settings/general.md)
* [Notes de version](https://wiki.datadike.com/fr/sonar/release-notes.md)
