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 -mrenvoiearm64sur Apple silicon etx86_64sur Intel. Voir Prérequis des appareils.Vous pouvez exécuter des commandes avec
sudosur 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
Ouvrez Agents › Install Agent, ou cliquez sur New Agent dans la liste des appareils de Dashboard › Sysadmin.
Choisissez le Client et le Site.
Sous Operating system, sélectionnez macOS.
Sous Agent type, sélectionnez Workstation ou Server.
Sous Architecture, sélectionnez Apple Silicon ou Intel 64-bit.
Si vous le souhaitez, activez Enable token expiration (hours) et saisissez dans Hours le nombre d'heures pendant lesquelles la commande reste valide.
Cliquez sur View macOS install instructions. La boîte de dialogue Manual Installation s'ouvre avec Run the following command in your terminal.
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
Ouvrez Terminal sur le Mac, dans un dossier où vous pouvez écrire, comme votre dossier de départ.
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 avecsudo.Saisissez le mot de passe administrateur lorsque
sudole demande.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 :
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é
Sur le Mac :
Les deux doivent afficher
state = running.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.
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.
Cliquez sur Take Control. La fenêtre d'accès à distance s'ouvre sur Terminal, avec un shell sur le Mac.
Dans Reports & Audits › Audits, une entrée Agent Install consigne le nouvel agent avec son nom d'hôte.
Erreurs courantes
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
Référence des champs
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
-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?