Manuell installieren Agent Client Collector Ein macOS

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 2 Minuten Lesedauer
  • Installieren Agent Client Collector Manuell auf einem Computer, der verwendet macOS Wenn der Agent nicht mit der Instanz verbunden ist oder Sie erweiterte Anpassungsoptionen wünschen.

    Vorbereitungen

    • Stellen Sie sicher, dass Sie konfiguriert haben Agent Client Collector Webserver.
    • Vergewissern Sie sich, dass Betriebssystem und Version Ihres Servers mit der Liste der unterstützten Betriebssystemversionen in Agent Client Collector Installation übereinstimmen.
    • Aktivieren Sie den goldenen Image-Modus zum Klonen zusätzlicher Agenten, indem Sie die goldene Bildmarkierung festlegen, die sich unter befindet /Library/Preferences/acc.rc.plist .
    • Navigieren zu Agent Client Collector > Bereitstellung > Agenten-Downloads Und laden Sie die signierte herunter .Paket Relevant für Ihr Betriebssystem.
    • Speichern Sie .Paket Installationspaket auf einem Ihrer installierten Agenten.

    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 Paket Zertifikatkette hat ServiceNow Entwickler-ID-Installationszertifikat.
    3. Installieren Sie Agent Client Collector Paket.
      sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /
    4. Kopieren Sie die Installationsdateien.
      1. Beispielkonfigurationsdatei:
        Sudo cp -p /Bibliothek/Anwendung\ Support/servicenow/Agent-Client-Collector/ACC.yml.example /Library/Application\ Support/servicenow/Agent-Client-Collector/ACC.yml
      2. Beispiel für Allow-Listendatei:
        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
    5. Wahlweise: Um neue Prüfungsdefinitionen zu erstellen, die in die Allow-Liste aufgenommen werden sollen, deaktivieren Sie zuerst die Allow-Liste, indem Sie kommentieren allow-listParameter in acc.yml Datei.

      Sudo -H -u _servicenow VI /Bibliothek/Anwendung\ Support/servicenow/Agent-Client-Collector/ACC.yml

      Hinweis:
      Diese Aktion gefährdet die Sicherheit Ihres Systems und wird nur als temporäre Maßnahme empfohlen, bis Sie die Aktualisierung der Allow-Liste abgeschlossen haben. Nachdem Sie das Update abgeschlossen haben, heben Sie den Kommentar des Parameters „Allow-Liste“ in der Konfigurationsdatei auf, um die Allow-Liste erneut zu aktivieren.

      Weitere Informationen zum Hinzufügen benutzerdefinierter Prüfungen zu einer Allow-Liste finden Sie unter Generieren Sie einen Agent Client Collector Allow-Liste.

    6. Speichern Sie die Konfigurationsdatei.
    7. Verbinden Sie den Service Desk-Mitarbeiter in der Konfigurationsdatei mit MID-Server.
      1. Legen Sie fest MID-Server Verbindung.
        "wss://<MID Server IP>:<Web Socket Port>/ws/events"

        Der Web-Socket-Port wurde auf konfiguriert MID-Server Wann als festgelegt wurde Agent Client Collector Listener.

      2. Suchen Sie api-keyParameter 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 Agenten verschlüsselt.
    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. Um sicherzustellen, dass das Programm nach dem Beenden angehalten bleibt, legen Sie die Eigenschaft KeepAlive in fest /Library/LaunchDaemons/com.sn.acc.plist Datei in Falsch .