Effectuer une installation sur ligne unique d'Agent Client Collector sur MacOS

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture
  • Utilisez un script de commande sur ligne unique efficace pour installer Agent Client Collector sur un ordinateur doté d'un système d'exploitation MacOS. Utilisez la procédure d'installation manuelle si l'agent n'est pas connecté à l'instance ou si vous souhaitez utiliser des options de personnalisation améliorées.

    Avant de commencer

    • Assurez-vous d'avoir configuré le serveur Web d'Agent Client Collector.
    • 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 Installation d'Agent Client Collector.
    • Assurez-vous que les packages pkgutil sont disponibles afin que le script d'installation puisse les utiliser.
    • Vérifiez que les agents cibles sont connectés aux composants suivants :
      • Serveur d'installation ServiceNow [install.service-now.com]
      • Instance ServiceNow
      • Serveur MID auquel l'agent se connectera

    Rôle requis : agent_client_collector_admin

    Procédure

    1. Récupérez les paramètres d'URL du socket Web Serveur MID.
      1. Accédez à la Agent Client Collector > Point de terminaison Websocket.
      2. Sélectionnez le point de terminaison Websocket approprié.
      3. Copiez la valeur du champ URL de point de terminaison à utiliser dans la commande d'installation.
    2. Récupérez la clé API.
      1. Accédez à la Agent Client Collector > Déploiement > Clé API du serveur Web MID.
      2. Copiez la valeur Clé API à utiliser dans la commande d'installation.
    3. Exécutez la commande suivante sur le serveur sur lequel Agent Client Collector est installé.
      ACC_API_KEY=<api_key> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events bash -c "$(curl -L https://<instance URL>/api/sn_agent/agents/install_agent)"

      Saisissez les valeurs suivantes dans la ligne de commande :

      Tableau 1. Paramètres de ligne de commande
      Paramètre Valeur
      ACC_API_KEY Remplacez la chaîne <api_key> par la clé API utilisée pour accéder au socket Web du Serveur MID. Si aucune valeur n'est spécifiée, vous êtes invité à saisir la valeur de clé API pendant l'exécution du script.
      ACC_MID Remplacez la chaîne <mid_ip> par l'URL du socket Web du Serveur MID. Lorsque vous spécifiez plusieurs Serveurs MID, saisissez une chaîne séparée par des virgules pour chaque Serveur MID.
      ACC_ALLOW_LIST (Facultatif) Ajoutez la chaîne ACC_ALLOW_LIST=0 pour désactiver la liste d'autorisation. Par défaut la liste d'autorisation est activée.
      Remarque :
      dans la mesure où la désactivation de la liste d'autorisation 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, réactivez la liste d'autorisation en supprimant ACC_ALLOW_LIST=0 de la chaîne de commande sur ligne unique.
      ACC_VALIDATE_SIG (Facultatif) Ajoutez la chaîne ACC_VALIDATE_SIG=0 pour désactiver la vérification de la validation du certificat du programme d'installation. Par défaut, la validation est activée.

      Par défaut : la validation est activée.

      Remarque :
      Désactivez la validation de certification uniquement lors de l’utilisation d’outils de validation de signature non standard.