Wechseln Sie ACC von einer Instanz zur anderen

  • Freigeben Version: Yokohama
  • Aktualisiert 8. Januar 2026
  • 2 Minuten Lesedauer

    • Wechseln Sie zu einer anderen Agent Client Collector -ACC-Instanz.

    Vorbereitungen

    Bestätigen Sie die Installation von Agent Client Collector (ACC), und richten Sie den ACC-Registrierungsschlüssel ein. Informationen zur Einrichtung und Installation finden Sie unter:

    Erforderliche Rolle: agent_admin oder agent_client_collector_admin

    Weitere Informationen zu Rollen finden Sie unter Agent Client Collector user roles.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn ACC bereits mit einer Instanz verbunden ist, können Sie den Agent zu einer anderen Instanz wechseln, indem Sie die Konfiguration in acc.ymländern.

    Prozedur

    1. Stoppen Sie ACC mit der in Ihrem Betriebssystem vorgesehenen Methode.
      • Für Windowsgreifen Sie als Administrator auf „Services“ zu und stoppen den Agent Client Collector -Service.
      • Führen Sie für macOSfolgenden Befehl aus: sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
    2. Öffnen Sie die Datei acc.yml.
      • Windows: C:\ProgramData\ServiceNow\agent-client-collector\config
      • macOS: /Library/Application\ Support/servicenow/agent-client-collector/
    3. Bearbeiten Sie den Parameter backend-url so, dass er auf das <ITOM Cloud-Services-Gateway> verweist.
      Verwenden Sie je nach Standort der Instanz eines der folgenden Gateways:
      • 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

      Weitere Informationen dazu, wie der Agent das ITOM Cloud-Services-Gateway verwendet, finden Sie unter DEX-Architektur.

    4. Aktualisieren Sie die folgenden Parameter:
      • connect-without-mid: true
      • instance-URL: <vollständige_instanz_url>, Beispiel: https://dex.servicenow.com
      • registration-key: <Wert_des_Registrierungsschlüssels>

        Weitere Informationen zum Erstellen von Registrierungsschlüsseln finden Sie unter Erstellen Sie einen ACC-Registrierungsschlüssel.

    5. Speichern Sie die Datei.
    6. Löschen Sie Dateien mit der in Ihrem Betriebssystem vorgesehenen Methode.
      • Navigieren Sie unter Windowszu /agent-client-collector/config/cert/cnc, und löschen Sie die folgenden Dateien: cnc_kette.crt und priv_key.pem.go.
      • Greifen Sie unter macOSauf /Library/Application Support/servicenow/agent-client-collector/cert/cnc zu, und löschen Sie die folgenden Dateien: cnc_kette.crt und priv_key.pem.
    7. Löschen Sie je nach Betriebssystem die folgenden Ordner.
      • Löschen Sie unter Windows/agent-client-collector/cache.
      • Am macOS:
        • Löschen Sie für Agent 3.4.1 oder höher /Library/Application Support/servicenow/agent-client-collector/cache.
        • Löschen Sie für Agent 3.4.0 oder niedriger /Library/Caches/servicenow/agent-client-collector.
    8. Wahlweise: Wenn Sie diesen ACC bereits zuvor mit einer anderen Instanz verbunden haben, gehen Sie wie folgt vor:
      1. Kopieren Sie die Seriennummer Ihres Geräts.
      2. Suchen Sie in der Tabelle „Agent Client Collectors“ (sn_agent_cmdb_ci_agent) anhand der Seriennummer Ihres Geräts.
        Hinweis:
        Fügen Sie der Listenansicht die Spalte „Agent ID“ hinzu, wenn sie nicht verfügbar ist.
      3. Wenn Sie einen Datensatz finden, kopieren Sie die Agent-ID des Datensatzes.
      4. Suchen Sie in der Tabelle „Agent-Registrierungen“ (sn_agent_agent_registration) anhand des Datensatzes „Agent ID“.
      5. Löschen Sie alle bei der Suche resultierenden Datensätze.
    9. Initiieren Sie den ACC-Service mit der in Ihrem Betriebssystem vorgesehenen Methode.
      • Öffnen Sie unter Windows„Services“ als Administrator, und starten Sie dann Agent Client Collector.
      • Führen Sie unter macOSfolgenden Befehl aus: sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.