Installer manuellement sans MID Agent Client Collector dans un MacOS environnement

Installez manuellement MID-less Agent Client Collector sur un MacOS ordinateur pour permettre l’envoi de données de l’agent à l’instance via le cloud. L’envoi d’informations via le cloud permet Serveur MID de les utiliser pour des ressources plus persistantes.

Avant de commencer

• Installez le module d’extension ITOM Cloud Services Core (sn_itom_cloud_svc).
• Intégrez votre instance pour utiliser les ITOM services dans le cloud. Pour en savoir plus, contactez le service clientèle.
• Configurez une clé d’inscription d’agent. Pour plus de détails, voir Configurer une clé d’inscription d’agent.
• Rôle requis : agent_client_collector_admin

Pourquoi et quand exécuter cette tâche

Pour plus d’informations sur l’envoi de données via le cloud dans un déploiement sans MID, reportez-vous à la section DEX Architecture.

Procédure

1. Téléchargez les fichiers d'installation sur votre ordinateur local.

   curl -L <download link from the Agent Downloads page on the instance>

2. 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 certification pkg possède le certificat du programme d'installation de l'ID de développement ServiceNow.
3. Installez le package Agent Client Collector.

   sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. Copiez les fichiers d'installation.
   1. Exemple de fichier de configuration :
      sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
   2. Exemple de fichier de liste d'autorisation :
      sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json
5. Facultatif : pour créer de nouvelles définitions de vérification à inclure dans la liste d'autorisation, désactivez au préalable la liste d'autorisation en commentant le paramètre allow-list dans le fichier acc.yml.

   sudo -H -u _servicenow vi /Library/Application\ Support/servicenow/agent-client-collector/acc.yml

   Remarque :

   dans la mesure où cette action compromet la sécurité de votre système, elle est recommandée uniquement comme mesure temporaire jusqu'à ce que vous terminiez la mise à jour de la liste d'autorisation. Une fois la mise à jour terminée, annulez le commentaire du 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.

6. Dans le fichier de configuration acc.yml :
   1. Définissez les paramètres suivants :

      Paramètre	Valeur
      URL back-end	« <URL de la passerelle> »
      connecter sans MID	vrai
      URL d’instance	« <URL d’instance> »
      clé_inscription	« <clé-régulation> »
      non sécurisé-ignorer-tls-vérifier	Faux

   2. Commentez le api-key paramètre.
7. Enregistrez le fichier de configuration.
8. 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, quitter le programme d'installation entraîne le redémarrage immédiat du programme. Pour vous assurer que le programme ne redémarre pas après l'avoir quitté, définissez la propriété KeepAlive dans le fichier /Library/LaunchDaemons/com.sn.acc.plist sur faux.