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

# Prérequis des appareils

Ce dont un endpoint Windows, Linux ou macOS a besoin pour exécuter l'agent SONAR : systèmes d'exploitation, architectures, privilèges et exclusions antivirus.

## Ce que couvre cette page

Ce dont un appareil a besoin avant que vous y installiez l'agent SONAR : quels systèmes d'exploitation et quelles architectures de processeur disposent d'un programme d'installation, quels privilèges l'installation exige, ce qui est écrit sur le disque, et quels dossiers et processus exclure de l'analyse antivirus et EDR.

Le serveur SONAR est exploité par DataDike. Rien sur cette page ne s'y applique : les prérequis ci-dessous concernent les endpoints que vous gérez. Pour les connexions qu'un endpoint doit pouvoir ouvrir, voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).

## Systèmes d'exploitation et architectures

La console génère un programme d'installation par système d'exploitation et par architecture. Voici les combinaisons qu'elle propose, et les versions de système d'exploitation sur lesquelles l'agent fonctionne.

| Plateforme | Architectures proposées dans **Install Agent**                        | Versions du système d'exploitation                                                                          |
| ---------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Windows    | **64-bit** (x64), **32-bit** (x86)                                    | Windows 10, Windows 11, Windows Server 2016 et versions ultérieures                                         |
| Linux      | **64-bit** (x86-64), **32-bit** (x86), **ARM 64-bit**, **ARM 32-bit** | Toute distribution qui utilise systemd comme système d'initialisation, avec un noyau Linux 3.2 ou ultérieur |
| macOS      | **Intel 64-bit**, **Apple Silicon**                                   | macOS 12 Monterey et versions ultérieures                                                                   |

Les points qui décident du programme d'installation à choisir :

* **Programme d'installation Windows 64 bits sur un Windows 32 bits.** Le programme d'installation 64 bits vérifie le système d'exploitation et s'arrête avec le message *This application requires a 64-bit Windows operating system.* Utilisez le programme d'installation **32-bit** sur un Windows 32 bits.
* **Windows sur ARM.** Il n'existe pas de programme d'installation ARM pour Windows.
* **Linux sans systemd.** Le script d'installation Linux s'arrête avec le message *This install script only supports systemd*. Pour vérifier une machine, exécutez `ps --no-headers -o comm 1` : la sortie doit être `systemd`.
* **Distributions Linux reconnues par le script.** Le script configure les paramètres régionaux (locale) du système de l'une de deux façons : l'une pour la famille Debian (Ubuntu, Debian, Raspbian, Kali, Linux Mint), l'autre pour les autres distributions qu'il reconnaît (Fedora, Rocky Linux, CentOS, RHEL, Amazon Linux, Arch, openSUSE). Toute autre distribution systemd est configurée de la seconde façon.
* **macOS.** Choisissez **Apple Silicon** pour les Mac de la série M et **Intel 64-bit** pour les Mac Intel. `uname -m` renvoie `arm64` sur Apple silicon et `x86_64` sur Intel.

Ce que chaque plateforme permet une fois l'agent installé varie : l'inventaire logiciel, l'application des mises à jour Windows Update et le module de productivité, par exemple, n'existent que sous Windows. Voir [Plateformes prises en charge](https://wiki.datadike.com/fr/sonar/reference/supported-platforms.md).

## Privilèges nécessaires à l'installation

| Plateforme | Qui exécute le programme d'installation                                                  | Compte sous lequel l'agent s'exécute |
| ---------- | ---------------------------------------------------------------------------------------- | ------------------------------------ |
| Windows    | Un administrateur local. Le programme d'installation demande une élévation de privilèges | Local System                         |
| Linux      | `root`, depuis une session sans affichage graphique (SSH ou console texte)               | `root`                               |
| macOS      | Un administrateur, via `sudo`                                                            | `root` (launch daemon système)       |

Dans tout autre cas, le script Linux refuse de s'exécuter :

* hors root : *ERROR: Must be run as root* ;
* depuis une session graphique : *ERROR: Display detected. Installer only supports running headless, i.e from ssh.* Exécutez-le via SSH, passez à une session texte avec `sudo systemctl isolate multi-user.target` ou, si la variable provient uniquement du transfert X (X forwarding), exécutez `unset DISPLAY` et réessayez.

Le script Linux a également besoin de `bash` et de `wget` sur la machine.

## Ce qui est écrit sur l'appareil

### Windows

| Chemin                           | Contenu                                                                                                                                                                                                                         |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `C:\Program Files\Sonar\`        | Exécutable de l'agent `sonarrmm.exe` (environ 10,6 Mo en 64 bits, 10,1 Mo en 32 bits), `uninstall.exe`, le fichier journal `agent.log` et le module de productivité `productivity.exe` (environ 25,4 Mo) lorsqu'il est installé |
| `C:\Program Files\Sonar\python\` | Environnement d'exécution Python que l'agent télécharge à son premier démarrage, utilisé pour exécuter les scripts Python                                                                                                       |
| `C:\Program Files\Mesh Agent\`   | Agent d'accès à distance (`MeshAgent.exe`)                                                                                                                                                                                      |
| `C:\ProgramData\Sonar\`          | Dossier de travail pour les scripts et les mises à jour de l'agent                                                                                                                                                              |
| `HKLM\SOFTWARE\Sonar`            | Configuration de l'agent                                                                                                                                                                                                        |

Un agent 32 bits installé sur un Windows 64 bits utilise à la place `C:\Program Files (x86)\Sonar\` et `C:\Program Files (x86)\Mesh Agent\`.

Le programme d'installation inscrit **Sonar**, éditeur **DataDike®**, dans la liste des programmes installés.

### Linux

| Chemin                                   | Contenu                                                             |
| ---------------------------------------- | ------------------------------------------------------------------- |
| `/usr/local/bin/sonaragent`              | Exécutable de l'agent (environ 10,5 à 11,3 Mo selon l'architecture) |
| `/opt/sonaragent/`                       | Dossier de travail de l'agent                                       |
| `/opt/sonarmesh/`                        | Agent d'accès à distance (`meshagent`)                              |
| `/etc/sonaragent.json`                   | Configuration de l'agent                                            |
| `/etc/systemd/system/sonaragent.service` | Unité de service de l'agent                                         |
| `/var/log/sonaragent.log`                | Journal de l'agent                                                  |

### macOS

| Chemin                                    | Contenu                                                             |
| ----------------------------------------- | ------------------------------------------------------------------- |
| `/opt/sonaragent/sonaragent`              | Exécutable de l'agent (environ 10,7 à 11,4 Mo selon l'architecture) |
| `/opt/sonarmesh/`                         | Agent d'accès à distance (`meshagent`)                              |
| `/Library/LaunchDaemons/sonaragent.plist` | Launch daemon de l'agent                                            |
| `/etc/sonaragent.json`                    | Configuration de l'agent                                            |
| `/var/log/sonaragent.log`                 | Journal de l'agent                                                  |

{% hint style="info" %}
Sous Windows, l'installation de l'agent configure la stratégie Windows Update pour que Windows n'installe pas les mises à jour automatiquement : l'application des mises à jour est alors pilotée depuis SONAR. La désinstallation de l'agent réactive les mises à jour automatiques. Voir [Installer l'agent sous Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md) pour l'ensemble des modifications apportées par le programme d'installation.
{% endhint %}

## Exclusions antivirus et EDR

L'agent exécute des commandes, des scripts et des mises à jour sur l'appareil en tant que Local System ou root, ce qui est exactement le comportement que surveillent les produits de sécurité. Ajoutez ces exclusions dans votre antivirus ou votre EDR avant un déploiement à grande échelle.

### Windows

| Type      | Exclusion                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------ |
| Dossier   | `C:\Program Files\Sonar\` (`C:\Program Files (x86)\Sonar\` pour un agent 32 bits sur un Windows 64 bits)           |
| Dossier   | `C:\Program Files\Mesh Agent\` (`C:\Program Files (x86)\Mesh Agent\` pour un agent 32 bits sur un Windows 64 bits) |
| Dossier   | `C:\ProgramData\Sonar\`                                                                                            |
| Processus | `sonarrmm.exe`                                                                                                     |
| Processus | `MeshAgent.exe`                                                                                                    |
| Processus | `productivity.exe`, là où le module de productivité est installé                                                   |

La méthode d'installation **PowerShell** ajoute elle-même les trois dossiers à la liste d'exclusions de Microsoft Defender lorsque Defender est actif. Avec toute autre méthode, et avec tout autre produit de sécurité, ajoutez-les vous-même.

### Linux

| Type      | Exclusion                   |
| --------- | --------------------------- |
| Fichier   | `/usr/local/bin/sonaragent` |
| Dossier   | `/opt/sonaragent/`          |
| Dossier   | `/opt/sonarmesh/`           |
| Processus | `sonaragent`                |
| Processus | `meshagent`                 |

### macOS

| Type      | Exclusion          |
| --------- | ------------------ |
| Dossier   | `/opt/sonaragent/` |
| Dossier   | `/opt/sonarmesh/`  |
| Processus | `sonaragent`       |
| Processus | `meshagent`        |

## Comment vérifier qu'un appareil satisfait à ces prérequis

* **Windows :** dans PowerShell, `[Environment]::Is64BitOperatingSystem` renvoie `True` sur un Windows 64 bits ; `winver` affiche la version.
* **Linux :** `ps --no-headers -o comm 1` renvoie `systemd` ; `uname -m` affiche l'architecture (`x86_64`, `i686`, `aarch64`, `armv7l`) ; `uname -r` affiche la version du noyau.
* **macOS :** `uname -m` renvoie `arm64` ou `x86_64` ; `sw_vers` affiche la version de macOS.

## Pages associées

* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.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)
* [Plateformes prises en charge](https://wiki.datadike.com/fr/sonar/reference/supported-platforms.md)
