Convertir ACC d'une instance à une autre

  • Rversion finale: Xanadu
  • Mis à jour 17 juin 2026
  • 1 minute de lecture

    • Convertissez les instances Agent Client Collector (ACC) pour la surveillance afin d'améliorer la collecte de données, la visibilité et la compatibilité des outils, ou de répondre à des besoins spécifiques de surveillance.

    Avant de commencer

    Assurez-vous d'avoir configuré la clé d'inscription ACC et d'avoir installé ACC. Pour en savoir plus sur la configuration et l'installation, consultez :

    Rôle requis : agent_admin et agent_client_collector_admin

    Pour en savoir plus sur les rôles, consultez Agent Client Collector user roles.

    Pourquoi et quand exécuter cette tâche

    Si Agent Client Collector (ACC) est déjà connecté à une instance, vous pouvez convertir l'agent en une autre instance en modifiant la configuration dans acc.yml.

    Procédure

    1. Arrêtez ACC en suivant les étapes appropriées à votre système d'exploitation.
      • Sous Windows, accédez aux services en tant qu'administrateur et arrêtez le service Agent Client Collector.
      • Sur Mac, exécutez la commande : sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
    2. Ouvrez le fichier acc.yml.
    3. Remplacez l'URL d'instance par la nouvelle instance.
    4. Modifiez le paramètre backend-url pour qu'il pointe vers <ITOM Cloud Services Gateway>.
      Utilisez l'une des passerelles suivantes en fonction de l'emplacement de l'instance :
      • AMER : itomcnc-prod-gateway-amer.sncapps.service-now.com:443
      • EMEA : itomcnc-prod-gateway-emea.sncapps.service-now.com:443
      • APAC : itomcnc-prod-gateway-apac.sncapps.service-now.com:443

      Pour en savoir plus sur la façon dont l'agent utilise la passerelle des services dans le cloud ITOM, consultez Architecture de l'application DEX.

    5. Ajoutez les nouveaux paramètres suivants :
      • connect-without-mid : true
      • instance-url : <url d'instance complète>, exemple : https://dex.servicenow.com
      • registration-key : <valeur de clé d'inscription>

        Pour en savoir plus sur la création d'une clé d'inscription, consultez Créer une clé d'inscription ACC.

    6. Commentez le paramètre : api-key: "encrypted....”
    7. Enregistrez le fichier.
    8. Supprimez les fichiers en fonction de votre système d'exploitation.
      • Sous Windows, accédez à /agent-client-collector/config/cert/cnc et supprimez les fichiers suivants : cnc_chain.crt et priv_key.pem.go.
      • Sur Mac, accédez à /Library/Application Support/servicenow/agent-client-collector/cert/cnc et supprimez les fichiers : cnc_chain.crt et priv_key.pem.
    9. Supprimez les dossiers suivants en fonction de votre système d’exploitation.
      • Sous Windows, supprimez le dossier : /agent-client-collector/cache.
      • Sur Mac :
        • Pour Agent 3.4.1 ou versions ultérieures, supprimez le dossier : /Library/Application Support/servicenow/agent-client-collector/cache.
        • Pour Agent 3.4.0 ou une version antérieure, supprimez le dossier : /Library/Caches/servicenow/agent-client-collector.
    10. Lancez le service ACC en suivant les étapes spécifiques à votre système d'exploitation.
      • Sous Windows, ouvrez Services en tant qu’administrateur, puis démarrez le service Agent Client Collector.
      • Sur Mac, utilisez la commande : sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.