> 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/mass-deployment.md).

# Déployer des agents à grande échelle

Diffusez l'agent SONAR sur de nombreux appareils : installateurs réutilisables, liens dans Agents › Deployments, GPO, distribution logicielle et vérification.

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

Chaque installateur produit par la console est lié à un client et à un site, et fonctionne sur un nombre quelconque d'appareils tant qu'il reste valide. Déployer SONAR sur un site entier revient donc à produire un installateur par site et par type d'appareil, puis à l'exécuter partout avec l'outil que vous utilisez déjà : stratégie de groupe, outil de distribution logicielle ou de MDM, RMM en cours de remplacement, automatisation par SSH.

Il existe deux sources d'installateurs :

* **Agents › Install Agent** : un fichier ou une commande que vous téléchargez une fois et que vous distribuez, qu'il s'agisse du **Dynamic (.exe)** ou du script **PowerShell** pour Windows, du script pour Linux ou de la commande pour macOS. Consultez les pages de chaque plateforme, en lien ci-dessous.
* **Agents › Deployments** : un **lien de téléchargement** réutilisable par site, pour Windows. Chaque fois que le lien est ouvert, SONAR produit un nouvel installateur avec la version actuelle de l'agent, jusqu'à la date fixée dans **Expiry** pour le déploiement.

## Avant de commencer

* Pour gérer les liens de déploiement, votre rôle dispose de **List Deployments** et **Manage Deployments** dans **Admin Center › Roles**. Pour générer des installateurs dans **Install Agent**, il dispose de **Install Agents**. Ces deux permissions ne couvrent que les sites auxquels votre rôle donne accès.
* Les clients et les sites existent. Prévoyez un installateur ou un déploiement par site, par type d'appareil (**Server** ou **Workstation**) et par architecture.
* Les exclusions de l'antivirus et de l'EDR sont en place avant la campagne de déploiement. Consultez [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md#exclusions-antivirus-et-edr).
* Chaque réseau cible autorise le trafic sortant en 443/tcp vers les adresses de l'API SONAR et de l'accès à distance. Consultez [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).
* Pour les installateurs issus d'**Install Agent**, activez **Enable token expiration (hours)** avec assez d'heures pour couvrir toute la fenêtre de la campagne de déploiement. Passé ce délai, l'installateur cesse de fonctionner et il faut en générer un nouveau.

## Étapes

### Créer un lien de déploiement (Windows)

1. Ouvrez **Agents › Deployments**. La boîte de dialogue **Deployments** liste les déploiements existants.
2. Cliquez sur le bouton **+** (**Create Deployment**). Le formulaire **Add Deployment** s'ouvre.
3. Choisissez le **Site**.
4. Choisissez l'**Agent Type** : **Server** ou **Workstation**.
5. Fixez la date et l'heure dans **Expiry**.
6. Choisissez l'**Architecture** : **64 bit** ou **32 bit**.
7. Cochez les **Optional Features** que les appareils doivent recevoir. Ce sont les mêmes que dans **Install Agent**, et elles sont décrites dans [Installer l'agent sur Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md#reference-des-champs).
8. Cliquez sur **Create Deployment**. Le message *The deployment was added successfully* s'affiche et la nouvelle ligne est ajoutée à la liste.
9. Dans la ligne, sous **Download Link**, cliquez sur **Copy**. Le message *Link copied to clipboard* le confirme.

L'ouverture du lien télécharge le fichier `sonar-<client>-<site>-<type>-<architecture>.exe`, le même installateur Dynamic que celui que produit **Install Agent**, qui s'exécute en mode silencieux avec `/S`.

### Déployer avec un script de démarrage de stratégie de groupe (Windows)

Un script de démarrage de l'ordinateur s'exécute en tant que Local System, avant toute ouverture de session, ce qui est le contexte qu'attend l'installateur silencieux.

1. Enregistrez un script comme celui-ci, avec votre lien de déploiement, dans un partage lisible par les ordinateurs du domaine :

   ```powershell
   if (-not (Get-Service -Name sonarrmm -ErrorAction SilentlyContinue)) {
       $installer = Join-Path $env:TEMP 'sonar-agent.exe'
       Invoke-WebRequest -Uri '<deployment link>' -OutFile $installer -UseBasicParsing
       Start-Process -FilePath $installer -ArgumentList '/S' -Wait
       Remove-Item $installer -Force
   }
   ```

   Grâce à la vérification du service, le script ne fait rien sur les appareils qui ont déjà l'agent. Au lieu de télécharger depuis un lien, le script peut tout aussi bien exécuter un installateur Dynamic (.exe) copié sur le partage.
2. Dans **Group Policy Management**, créez ou modifiez un GPO lié à l'unité d'organisation des ordinateurs cibles.
3. Sous **Computer Configuration › Policies › Windows Settings › Scripts (Startup/Shutdown)**, ajoutez le script comme script PowerShell de **Startup**.
4. Redémarrez les ordinateurs cibles, ou attendez leur prochain redémarrage.

### Déployer avec un outil de distribution logicielle ou de MDM (Windows)

Empaquetez comme application l'installateur Dynamic (.exe) obtenu dans **Install Agent** ou par un lien de déploiement :

| Paramètre                   | Valeur                                                                                   |
| --------------------------- | ---------------------------------------------------------------------------------------- |
| Commande d'installation     | `sonar-<client>-<site>-<type>-<architecture>.exe /S`                                     |
| Commande de désinstallation | `"C:\Program Files\Sonar\uninstall.exe" /S`                                              |
| Exécuter en tant que        | System                                                                                   |
| Détection                   | Le service `sonarrmm` existe, ou le fichier `C:\Program Files\Sonar\sonarrmm.exe` existe |

Le script PowerShell d'**Install Agent** peut être distribué de la même façon : il vérifie lui-même la présence du service `sonarrmm` et s'arrête si l'agent est déjà installé.

### Déployer sur Linux et macOS

* **Linux :** exécutez le script d'**Install Agent** en tant que root sur chaque machine au moyen de votre automatisation (SSH, gestion de configuration, boucle depuis un hôte de rebond) : `sudo bash ./sonar-<client>-<site>-<type>.sh`. Le script supprime tout agent précédent avant l'installation. Consultez [Installer l'agent sur Linux](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-linux.md).
* **macOS :** exécutez la commande d'**Install Agent** en tant que root au moyen de votre MDM ou d'un shell distant. Lorsque les opérateurs ont besoin des dossiers protégés de l'utilisateur depuis la fenêtre d'accès à distance, accordez **Full Disk Access** par un profil de confidentialité MDM. Consultez [Installer l'agent sur macOS](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-macos.md).

## Ce que vous devez voir

Les appareils apparaissent dans **Dashboard › Sysadmin**, sous leur client et leur site, au fur et à mesure que chaque installation se termine, avec **Agent Status** **Online**. Dans la vue **Clients overview**, la carte du client affiche un nombre d'appareils qui augmente.

## Comment vérifier que cela a fonctionné

1. Ouvrez **Dashboard › Sysadmin** et cliquez sur la carte du client.
2. Triez la liste des appareils par **First Seen**, du plus récent au plus ancien : les appareils de la campagne de déploiement se trouvent en haut, avec la date de leur enregistrement.
3. Ouvrez **Filters** et, sous **Availability**, choisissez **Online** ; sous **Device Type**, choisissez **Servers** ou **Workstations** selon le lot. Comparez le nombre obtenu avec la liste des appareils que vous visiez.
4. Pour les appareils de votre liste qui manquent, vérifiez le résultat enregistré par l'outil de déploiement lui-même sur ces appareils, puis suivez [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md).
5. Dans **Reports & Audits › Audits**, chaque enregistrement d'appareil est une entrée **Agent Install** portant le nom d'hôte, ce qui donne l'ordre et l'heure d'arrivée.

## Erreurs courantes

| Symptôme                                                                                                | Cause                                                                                                                                                                         | Correction                                                                                                              |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| *expire date is invalid* à la création d'un déploiement                                                 | **Expiry** est vide ou incomplet                                                                                                                                              | Renseignez la date et l'heure                                                                                           |
| Les installateurs s'arrêtent avec *Installer token has expired. Please generate a new one.*             | Le déploiement a dépassé sa date d'**Expiry**, le déploiement a été supprimé, ou l'installateur d'**Install Agent** a dépassé l'expiration de son jeton                       | Créez un nouveau déploiement ou un nouvel installateur, et mettez à jour le lien ou le paquet dans votre outil          |
| Des installateurs enregistrés avant la campagne de déploiement s'arrêtent avec *Old installer detected* | La version de l'agent SONAR a changé après la génération du fichier                                                                                                           | Générez de nouveau le fichier, ou utilisez un lien de déploiement, qui produit toujours la version actuelle             |
| L'installation silencieuse signale une réussite, mais l'appareil n'apparaît jamais                      | L'appareil avait déjà un agent, ou ce qu'il en restait ; l'installateur affiche *Existing installation found and must be removed before attempting to reinstall.* et s'arrête | Exécutez `"C:\Program Files\Sonar\uninstall.exe" /S` sur l'appareil, puis réinstallez                                   |
| Une installation lancée dans la session d'un utilisateur connecté ne se termine pas                     | La boîte de message finale de l'agent attend un clic sur **OK**                                                                                                               | Exécutez l'installateur en tant que Local System, ou utilisez le script PowerShell, qui s'exécute sans boîte de message |
| Des appareils arrivent dans le mauvais site                                                             | L'installateur ou le lien d'un autre site a été utilisé                                                                                                                       | Déplacez les appareils vers le bon site, et vérifiez le fichier qu'utilise chaque paquet                                |
| Le bouton **+**, **Copy** ou **Delete** ne fait rien                                                    | Votre rôle ne dispose pas de **Manage Deployments**                                                                                                                           | Demandez la permission                                                                                                  |

## Référence des champs

### Add Deployment

| Champ                 | Ce qu'il fait                                                                                                                                                                 | Valeurs acceptées                                           | Par défaut                      |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------- |
| **Site**              | Site sous lequel les appareils sont enregistrés                                                                                                                               | Les sites auxquels votre rôle a accès, regroupés par client | Le premier site de la liste     |
| **Agent Type**        | Enregistre les appareils comme serveurs ou comme postes de travail                                                                                                            | **Server**, **Workstation**                                 | **Server**                      |
| **Expiry**            | Date et heure au-delà desquelles les installateurs de ce lien cessent de fonctionner                                                                                          | Une date et une heure                                       | 30 jours à partir de maintenant |
| **Architecture**      | Architecture Windows de l'installateur                                                                                                                                        | **64 bit**, **32 bit**                                      | **64 bit**                      |
| **Optional Features** | Les mêmes fonctionnalités que dans **Install Agent** : **Sessions**, **Geolocation**, **Remote access**, **Ping** et, pour les postes de travail, **Disable sleep/hibernate** | Cochée ou non                                               | Aucune cochée                   |

### Liste des déploiements

| Colonne           | Ce qu'elle affiche                                                      |
| ----------------- | ----------------------------------------------------------------------- |
| **Client**        | Client du site du déploiement                                           |
| **Site**          | Site sous lequel les appareils sont enregistrés                         |
| **Type**          | **server** ou **workstation**                                           |
| **Arch**          | `amd64` (64 bit) ou `386` (32 bit)                                      |
| **Expiry**        | Moment où le lien cesse de produire des installateurs fonctionnels      |
| **Created**       | Moment où le déploiement a été créé                                     |
| **Flags**         | **View Flags** ; survolez-le pour voir les fonctionnalités optionnelles |
| **Download Link** | **Copy** place le lien dans le presse-papiers                           |

Pour supprimer un déploiement, faites un clic droit sur sa ligne, choisissez **Delete** et confirmez **Delete deployment?**. Les installateurs déjà téléchargés depuis ce lien cessent eux aussi de fonctionner.

## Pages associées

* [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)
* [La liste des appareils](https://wiki.datadike.com/fr/sonar/administration/devices/device-list.md)
* [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)
