Installez Agent Client Collector manuellement sur un ordinateur lorsque l’agent n’est pas connecté à l’instance ou lorsque MacOS vous souhaitez des options de personnalisation améliorées.
Avant de commencer
- Assurez-vous d’avoir configuré le Agent Client Collector serveur Web.
- Vérifiez que le système d'exploitation et la version de votre serveur correspondent à la liste des versions du système d'exploitation prises en charge, comme décrit à la rubrique Agent Client Collector L’installation.
- Activez le mode d’image de référence pour cloner des agents supplémentaires en définissant le marqueur d’image de référence situé dans /Library/Preferences/acc.rc.plist.
- Accédez à la et téléchargez le .pkg signé correspondant à votre système d’exploitation.
- Stockez le package d’installation .pkg sur l’un de vos agents installés.
Rôle requis : agent_client_collector_admin
Procédure
-
Téléchargez les fichiers d'installation sur votre ordinateur local.
curl -L <download link from the Agent Downloads page on the instance>
-
Validez la signature du fichier d’installation.
pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg
Remarque : Assurez-vous que la chaîne de certificats pkg dispose du certificat d’installation de l’ID de ServiceNow développeur.
-
Installez le Agent Client Collector package.
sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /
-
Copiez les fichiers d’installation.
-
Exemple de fichier de configuration :
sudo cp -p /Bibliothèque/Application\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
-
Exemple de fichier de liste d’autorisation :
sudo cp -p /Bibliothèque/Application\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Bibliothèque/Application\ Support/servicenow/agent-client-collector/check-allow-list.json
- Facultatif :
Pour créer de nouvelles définitions de vérification à inclure dans la liste d’autorisation, désactivez d’abord la liste d’autorisation en commentant le allow-list paramètre dans le fichier acc.yml .
sudo -H -u _servicenow vi /Bibliothèque/Application\ Support/servicenow/agent-client-collector/acc.yml
Remarque : Cette action compromet la sécurité de votre système et n’est recommandée qu’à titre temporaire jusqu’à ce que vous ayez terminé de mettre à jour la liste d’autorisation. Une fois la mise à jour terminée, décommentez le paramètre de liste d’autorisation dans le fichier de configuration pour réactiver la liste d’autorisation.
Pour en savoir plus sur l'ajout de vérifications personnalisées à une liste d'autorisation, consultez la rubrique Générer une liste d’autorisation Agent Client Collector.
-
Enregistrez le fichier de configuration.
-
Dans le fichier de configuration, connectez l’agent avec le fichier Serveur MID.
-
Établissez la Serveur MID connexion.
"wss://<MID Server IP>:<Web Socket Port>/ws/events"
Le port de socket web a été configuré sur le Serveur MID moment où il a été défini comme Agent Client Collector écouteur.
-
Localisez le api-key paramètre et spécifiez la valeur de clé API entre guillemets doubles, comme suit :
api-key:"111111111"
La clé API spécifiée est chiffrée la première fois que l’agent s’exécute.
-
Pour vous assurer que le fichier de configuration pointe vers un point de terminaison valide, exécutez les commandes suivantes pour redémarrer :Agent Client Collector
sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist
Remarque : Par défaut, lorsque vous quittez le programme d’installation, le programme redémarre immédiatement. Pour vous assurer que le programme reste arrêté après l’avoir quitté, définissez la propriété KeepAlive dans le fichier /Library/LaunchDaemons/com.sn.acc.plist sur false.