---
sourceDocument: IT Operations Management Zürich
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/it-operations-management

 Release :

    - zurich

ft:locale :

    - de-DE

ft:publication_title :

    - IT Operations Management Zürich

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Agent Client Collector manuell unter macOS installieren

# Agent Client Collector manuell unter macOS installieren {#ariaid-title1}

* Freigeben Version: Zurich
* 
* Aktualisiert 31. Juli 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Installieren Sie Agent Client Collector manuell auf einem Computer, auf dem macOS verwendet wird, wenn der Agent nicht mit der Instanz verbunden ist oder Sie erweiterte Anpassungsoptionen wünschen.

## Vorbereitungen

* Stellen Sie sicher, dass Sie den Agent Client Collector-Webserver konfiguriert haben.
* Vergewissern Sie sich, dass Betriebssystem und Version Ihres Servers mit der Liste der unterstützten Betriebssystemversionen in [Installation von Agent Client Collector](https://www.servicenow.com/docs/OgAm3SMurfeHxydjazy9UQ "Sie können installieren Agent Client Collector Auf einem beliebigen unterstützten Hostcomputer. Die Agent Client Collector Stellt eine Verbindung zu her MID-Server Mithilfe des HTTP/S-Protokolls bleibt die Verbindung nach dem Herstellen aktiv. Eins MID-Server Kann mehrere Service Desk-Mitarbeiter gleichzeitig bearbeiten, während ein einzelner Service Desk-Mitarbeiter mit einem arbeitet MID-Server Und wechselt zu einem anderen MID-Server Wenn erforderlich, um Failover-Schutz bereitzustellen.") übereinstimmen.
* Navigieren zu Agent Client CollectorBereitstellungAgenten-Downloads Und laden Sie die signierte herunter .Paket Relevant für Ihr Betriebssystem.
* Speichern Sie das .pkg-Installationspaket auf einem Ihrer installierten Agents.

{#acc-install-macOS-manual__ul_m15_ygq_nqb}

Erforderliche Rolle: agent_client_collector_admin

## Prozedur

1. Laden Sie die Installationsdateien auf Ihren lokalen Computer herunter.  

       curl -L <download link from the Agent Downloads page on the instance>

2. Validieren Sie die Signatur der Installationsdatei.  

       pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg

   Hinweis:  
   Stellen Sie sicher, dass die .pkg-Zertifikatkette über das Installationszertifikat der ServiceNow-Entwickler-ID verfügt.
3. Installieren Sie das Agent Client Collector-Paket.  

       sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. Kopieren Sie die Installationsdateien.
   1. Beispiel-Konfigurationsdatei:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml
   2. Beispiel für eine Allow-Listen-Datei:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json
   {#acc-install-macOS-manual__substeps_lgw_fhq_nqb}
5. **Wahlweise:** Um neue Prüfdefinitionen für die Allow-Liste zu erstellen, deaktivieren Sie zuerst die Allow-Liste, indem Sie den allow-list-Parameter in der Datei acc.yml auskommentieren.  
   sudo -H -u _servicenow vi /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml  
   Hinweis:  
   Diese Aktion beeinträchtigt die Sicherheit Ihres Systems und wird nur als vorübergehende Maßnahme empfohlen, bis Sie die Aktualisierung der Allow-Liste abgeschlossen haben. Sobald das Update abgeschlossen ist, aktivieren Sie die Allow-Liste wieder, indem Sie den Kommentar des Allow-Listen-Parameters in der Konfigurationsdatei entfernen.

   Weitere Informationen zum Hinzufügen benutzerdefinierter Prüfungen zu einer Allow-Liste finden Sie unter [Agent Client Collector-Zulassungsliste generieren](https://www.servicenow.com/docs/SS9T_cP3X3AEmsGeivwNAg "Geben Sie die Prüfungen an, die in die Liste der Prüfungen aufgenommen werden sollen, die für den Service Desk-Mitarbeiter ausgeführt werden können.").
6. Speichern Sie die Konfigurationsdatei.
7. Verbinden Sie in der Konfigurationsdatei den Agent mit dem MID-Server.
   1. Legen Sie die MID-Server-Verbindung fest.  

          "wss://<MID Server IP>:<Web Socket Port>/ws/events"

      Der Websocket-Port wurde auf dem MID-Server konfiguriert, als er als Agent Client Collector-Listener festgelegt wurde.
   2. Suchen Sie den api-key-Parameter und geben Sie den API-Schlüsselwert in doppelten Anführungszeichen wie folgt an:  
      api-key:"111111111"  
      Der angegebene API-Schlüssel wird bei der ersten Ausführung des Agent verschlüsselt.
   {#acc-install-macOS-manual__substeps_sth_nhq_nqb}
8. Um sicherzustellen, dass die Konfigurationsdatei auf einen gültigen Endpunkt verweist, führen Sie die folgenden Befehle aus, um neu zu starten Agent Client Collector:  

       sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
       sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist

   Hinweis:  
   Standardmäßig führt das Beenden des Installationsprogramms dazu, dass das Programm sofort neu gestartet wird. Damit das Programm nach dem Beenden im angehaltenen Zustand bleibt, legen Sie die Keep Alive-Eigenschaft in der Datei /Library/LaunchDaemons/com.sn.acc.plist auf false fest.