Einzeilige Agent Client Collector-Installation unter macOS durchführen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 1 Minute Lesedauer

    • Verwenden Sie ein effizientes einzeiliges Befehlsskript, um Agent Client Collector auf einem Computer mit macOS-Betriebssystem zu installieren. Nehmen Sie eine manuelle Installation vor, 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 übereinstimmen.
    • Stellen Sie sicher, dass Sie die pkgutil-Pakete zur Verfügung haben, die vom Installationsskript verwendet werden.
    • Stellen Sie sicher, dass die Ziel-Agents über Folgendes verfügen:
      • ServiceNow-Installationsserver [install.service-now.com]
      • ServiceNow instance
      • MID-Server, mit dem der Agent eine Verbindung herstellt

    Erforderliche Rolle: agent_client_collector_admin

    Prozedur

    1. Rufen Sie die Websocket-URL-Parameter des MID-Server ab.
      1. Navigieren zu Agent Client Collector > Websocket-Endpunkt.
      2. Wählen Sie den relevanten Websocket-Endpunkt aus.
      3. Kopieren Sie den Wert des Felds Endpunkt-URL, der im Installationsbefehl verwendet werden soll.
    2. Rufen Sie den API-Schlüssel ab.
      1. Navigieren zu Agent Client Collector > Bereitstellung > MID-Webserver API-Schlüssel.
      2. Kopieren Sie den API-Schlüssel-Wert, der im Installationsbefehl verwendet werden soll.
    3. Führen Sie den folgenden Befehl auf dem Server aus, auf dem Agent Client Collector installiert wird. 
      ACC_API_KEY=<api_key> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events bash -c "$(curl -L https://<instance URL>/api/sn_agent/agents/install_agent)"

      Geben Sie die folgenden Werte in die Befehlszeile ein:

      Tabelle : 1. Befehlszeilenparameter
      Parameter Wert
      ACC_API_KEY Ersetzen Sie die <api_key>-Zeichenfolge durch den API-Schlüssel, der für den Zugriff auf den MID-Server-Websocket verwendet wird. Wenn kein Wert angegeben ist, werden Sie während der Ausführung des Skripts aufgefordert, den API-Schlüsselwert einzugeben.
      ACC_MID Ersetzen Sie die <mid_ip>-Zeichenfolge durch die URL des MID-Server-Websockets. Wenn Sie mehrere MID Servers angeben, geben Sie die MID-Server als kommagetrennte Zeichenfolge ein.
      ACC_ALLOW_LIST (Optional) Fügen Sie die Zeichenfolge ACC_ALLOW_LIST=0 hinzu, um die Allow-Liste zu deaktivieren. Die Allow-Liste ist standardmäßig aktiviert.
      Hinweis:
      Wenn die Allow-Liste deaktiviert ist, beeinträchtigt dies die Sicherheit Ihres Systems und es wird nur als vorübergehende Maßnahme empfohlen, bis Sie die Aktualisierung der Allow-Liste abgeschlossen haben. Nach der Aktualisierung aktivieren Sie die Allow-Liste erneut, indem Sie ACC_ALLOW_LIST=0 aus der einzeiligen Befehlszeichenfolge entfernen.
      ACC_VALIDATE_SIG (Optional) Fügen Sie die Zeichenfolge ACC_VALIDATE_SIG=0 hinzu, um die Überprüfung der Validierung des Installationszertifikats zu deaktivieren. Die Validierung ist standardmäßig aktiviert.

      Standard: Validierung ist aktiviert.

      Hinweis:
      Deaktivieren Sie die Zertifizierungsvalidierung nur, wenn Sie nicht standardmäßige Signaturvalidierungstools verwenden.