For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo
September 22 — Documentation updated for compatibility with the latest PAM version (5.3.0).

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.

  • 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.

É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 :

    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

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

Pages associées

Atualizado

Isto foi útil?