ACC von einer Instanz in eine andere konvertieren

Konvertieren Sie ACC-Instanzen (Agent Client Collector) für Überwachungszwecke, um die Datenerfassung, Transparenz und Tool-Kompatibilität zu verbessern oder bestimmte Überwachungsanforderungen zu erfüllen.

Vorbereitungen

Vergewissern Sie sich, dass der ACC-Registrierungsschlüssel eingerichtet wurde und ACC installiert ist. Informationen zur Einrichtung und Installation finden Sie unter:

• ACC-Registrierungsschlüssel erstellen.
• Install the Agent Client Collector on a Windows machine manually oder Manually install Agent Client Collector on macOS.

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 Agent Client Collector (ACC) bereits mit einer Instanz verbunden ist, können Sie den Agent in eine andere Instanz konvertieren, indem Sie die Konfiguration in acc.yml ändern.

Prozedur

1. Stoppen Sie ACC mit der in Ihrem Betriebssystem vorgesehenen Methode.
   • Greifen Sie unter Windows als Administrator auf „Services“ zu und stoppen Agent Client Collector.
   • Führen Sie unter Mac folgenden Befehl aus: sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
2. Öffnen Sie die Datei acc.yml.
3. Bearbeiten Sie die Instanz-URL für die neue Instanz.
4. 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.

5. Fügen Sie die folgenden neuen Parameter hinzu:
   • 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 ACC-Registrierungsschlüssel erstellen.

6. Kommentieren Sie den Parameter aus: api-key: "encrypted....”
7. Speichern Sie die Datei.
8. Löschen Sie Dateien mit der in Ihrem Betriebssystem vorgesehenen Methode.
   • Navigieren Sie unter Windows zu /agent-client-collector/config/cert/cnc, und löschen die folgenden Dateien: cnc_chain.crt und priv_key.pem.go.
   • Navigieren Sie unter Mac zu /Library/Application Support/servicenow/agent-client-collector/cert/cnc, und löschen die folgenden Dateien: cnc_chain.crt und priv_key.pem.
9. Löschen Sie je nach Betriebssystem die folgenden Ordner.
   • Löschen Sie unter Windows /agent-client-collector/cache.
   • Unter Mac:
     • 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.
10. Initiieren Sie den ACC-Service mit der in Ihrem Betriebssystem vorgesehenen Methode.
    • Öffnen Sie unter Windows „Services“ als Administrator, und starten Sie Agent Client Collector.
    • Führen Sie unter Mac folgenden Befehl aus: sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;.