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

# Installer l'agent sous macOS

Installez l'agent SONAR sur un Mac Intel ou Apple silicon avec la commande d'Agents › Install Agent, voyez ce qu'elle installe et vérifiez que le Mac remonte.

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

Sous macOS, **Agents › Install Agent** produit une commande Terminal d'une seule ligne, liée à un client et à un site. Exécutée sur le Mac, la commande télécharge l'agent SONAR pour l'architecture choisie et l'exécute avec `sudo`. L'agent installe ensuite l'agent d'accès à distance, enregistre l'appareil et crée son launch daemon. La même commande fonctionne sur autant de Mac de ce site que nécessaire tant qu'elle reste valide.

## 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.
* Le Mac exécute macOS 12 Monterey ou une version ultérieure. Vérifiez son processeur : `uname -m` renvoie `arm64` sur Apple silicon et `x86_64` sur Intel. Voir [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md).
* Vous pouvez exécuter des commandes avec `sudo` sur le Mac.
* Le Mac 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

### Obtenir la commande

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 **macOS**.
4. Sous **Agent type**, sélectionnez **Workstation** ou **Server**.
5. Sous **Architecture**, sélectionnez **Apple Silicon** ou **Intel 64-bit**.
6. Si vous le souhaitez, activez **Enable token expiration (hours)** et saisissez dans **Hours** le nombre d'heures pendant lesquelles la commande reste valide.
7. Cliquez sur **View macOS install instructions**. La boîte de dialogue **Manual Installation** s'ouvre avec *Run the following command in your terminal*.
8. Cliquez sur **Copy Command Line**. Pour ajouter un argument d'**Optional Arguments** (par exemple `-desc "Design team iMac"`), ajoutez-le à la fin de la commande.

Les options d'**Optional features** s'appliquent aux appareils Windows. L'installation sous macOS ne les utilise pas.

### L'exécuter sur le Mac

1. Ouvrez **Terminal** sur le Mac, dans un dossier où vous pouvez écrire, comme votre dossier de départ.
2. Collez la commande et appuyez sur Return. Elle télécharge le fichier de l'agent `sonaragent-v<version>-darwin-<architecture>`, le rend exécutable et l'exécute avec `sudo`.
3. Saisissez le mot de passe administrateur lorsque `sudo` le demande.
4. Attendez *Installation was successful!* dans la sortie.

L'agent se copie lui-même dans `/opt/sonaragent/` : le fichier téléchargé peut donc être supprimé ensuite.

### Dossiers protégés par macOS

Sur un Mac, la fenêtre d'accès à distance de SONAR propose **Terminal**, **File Browser** et **Processes**. macOS tient certains dossiers (dont le Bureau, les Documents et les Téléchargements d'un utilisateur) hors de portée des services d'arrière-plan tant que l'accès n'a pas été autorisé. Pour parcourir ou modifier ces dossiers depuis **Terminal** ou **File Browser**, autorisez l'agent d'accès à distance, `meshagent` dans `/opt/sonarmesh/`, sous **Full Disk Access** (accès complet au disque), dans **System Settings › Privacy & Security**. Sur les Mac gérés, un profil de configuration MDM (Privacy Preferences Policy Control) peut accorder la même autorisation.

## Ce que vous devez voir

Ce que l'installation crée :

| Élément                  | Emplacement                                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Agent SONAR              | `/opt/sonaragent/sonaragent`                                                                                                            |
| Launch daemon de l'agent | `/Library/LaunchDaemons/sonaragent.plist`, libellé `sonaragent`. Démarre avec le système et est 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/`, libellé de launch daemon `meshagent`                                                                                 |

Si le Mac avait déjà un agent, le programme d'installation supprime d'abord l'ancien agent et l'ancien agent d'accès à distance (*Existing meshagent found, attempting to remove...*, *Existing sonaragent plist found, attempting to remove...*), puis réinstalle.

## Comment vérifier que cela a fonctionné

1. Sur le Mac :

   ```bash
   sudo launchctl print system/sonaragent | grep state
   sudo launchctl print system/meshagent | grep state
   ```

   Les deux doivent afficher `state = 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 le Mac, 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, une fois l'agent d'accès à distance connecté, **Remote Online**.
4. Cliquez sur **Take Control**. La fenêtre d'accès à distance s'ouvre sur **Terminal**, avec un shell sur le Mac.
5. 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                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| *must run as root*                                                                                                                      | L'agent a été exécuté sans `sudo`                                                                | Relancez la commande entière telle qu'elle a été copiée ; elle inclut déjà `sudo`                                                    |
| Le shell signale *Bad CPU type in executable*                                                                                           | L'architecture choisie ne correspond pas à celle du Mac                                          | Obtenez de nouveau la commande avec l'autre option d'**Architecture**                                                                |
| *Installer token has expired. Please generate a new one.*                                                                               | La commande a été générée avec une expiration du jeton et ce délai est écoulé                    | Obtenez une nouvelle commande                                                                                                        |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM*                                  | La commande a été enregistrée avant que la version de l'agent SONAR ne change                    | Obtenez une nouvelle commande                                                                                                        |
| *Unable to download the mesh agent from the RMM.*                                                                                       | Le programme d'installation n'a pas pu obtenir l'agent d'accès à distance via l'adresse de l'API | Vérifiez la connectivité vers l'adresse de l'API et relancez la commande                                                             |
| **Terminal** ou **File Browser** reçoit *Operation not permitted* dans le Bureau, les Documents ou les Téléchargements d'un utilisateur | macOS protège ces dossiers                                                                       | Autorisez `meshagent` sous **Full Disk Access**                                                                                      |
| L'appareil est en ligne mais affiche **Remote Offline**                                                                                 | L'agent d'accès à distance ne peut pas joindre l'adresse d'accès à distance                      | Voir [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md#un-appareil-apparait-remote-offline) |

## Référence des champs

| Champ                               | Ce qu'il fait                                                                                       | Valeurs acceptées                           | Par défaut                           |
| ----------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------ |
| **Client**                          | Client sous lequel le Mac est enregistré                                                            | Clients auxquels votre rôle donne accès     | Premier client de la liste           |
| **Site**                            | Site sous lequel le Mac est enregistré                                                              | Sites du client choisi                      | Premier site du client               |
| **Operating system**                | Plateforme du programme d'installation                                                              | **Windows**, **Linux**, **macOS**           | **Windows**                          |
| **Agent type**                      | Enregistre le Mac 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 la commande télécharge                                    | **Intel 64-bit**, **Apple Silicon**         | **Intel 64-bit**                     |
| **Enable token expiration (hours)** | Lorsque cette option est activée, la commande cesse de fonctionner après le nombre d'heures saisi   | Activé, désactivé ; **Hours** de 1 à 999999 | Désactivé ; 24 heures à l'activation |

### Arguments facultatifs

| Argument                           | Ce qu'il fait                                                                                                                                                  |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-log debug`                       | Sortie détaillée pendant l'installation                                                                                                                        |
| `-silent`                          | Accepté par compatibilité avec le programme d'installation Windows. Il ne change rien sous macOS : l'installation écrit toujours ses messages dans le terminal |
| `-nomesh`                          | N'installe pas l'agent d'accès à distance. La fenêtre d'accès à distance n'est alors pas disponible pour le Mac                                                |
| `-desc "<text>"`                   | Définit la **Description** de l'appareil                                                                                                                       |
| `-proxy "http://proxyserver:port"` | Utilise un proxy HTTP. Voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md#proxies)                              |

## 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)
* [Terminal distant](https://wiki.datadike.com/fr/sonar/administration/remote-access/remote-terminal.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)
