Basculer ACC d'une instance à l'autre

  • Rversion finale: Australia
  • Mis à jour 17 juin 2026
  • 2 minutes de lecture

    • Basculez Agent Client Collector (ACC) vers une autre instance.

    Avant de commencer

    Vérifiez que vous avez installé Agent Client Collector (ACC) et configuré la clé d'inscription 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 ACC est déjà connecté à une instance, vous pouvez basculer l'agent vers 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.
      • Pour Windows, accédez aux services en tant qu'administrateur et arrêtez le service Agent Client Collector.
      • Pour MacOS, exécutez la commande : sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
    2. Ouvrez le fichier acc.yml.
      • Windows : C:\ProgramData\ServiceNow\agent-client-collector\config
      • MacOS : /Library/Application\ Support/servicenow/agent-client-collector/
    3. 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.

    4. Mettez à jour les 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.

    5. Enregistrez le fichier.
    6. Supprimez les fichiers en fonction de votre système d'exploitation.
      • Sur Windows, accédez à /agent-client-collector/config/cert/cnc et supprimez les fichiers suivants : cnc_chain.crt et priv_key.pem.go.
      • Sur MacOS, accédez à /Library/Application Support/servicenow/agent-client-collector/cert/cnc et supprimez les fichiers : cnc_chain.crt et priv_key.pem.
    7. Supprimez les dossiers suivants en fonction de votre système d'exploitation.
      • Sur Windows, supprimez le dossier : /agent-client-collector/cache.
      • Sur MacOS:
        • 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.
    8. Facultatif : Si vous avez déjà connecté cet ACC à une autre instance, procédez comme suit :
      1. Copiez le numéro de série de votre appareil.
      2. Dans la table Agent Client Collectors (sn_agent_cmdb_ci_agent), effectuez une recherche à l'aide du numéro de série de votre appareil.
        Remarque :
        ajoutez la colonne ID de l'agent à la vue de liste si elle n'est pas proposée.
      3. Si vous trouvez un enregistrement, copiez l'ID de l'agent correspondant.
      4. Dans la table Inscriptions d'agents (sn_agent_agent_registration), effectuez une recherche à l'aide de l'ID de l'agent d'enregistrement.
      5. Supprimez tous les enregistrements résultant de la recherche.
    9. Lancez le service ACC en suivant les étapes spécifiques à votre système d'exploitation.
      • Sur Windows, ouvrez Services en tant qu'administrateur, puis démarrez Agent Client Collector.
      • Sur MacOS, utilisez la commande : sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.