Installieren Sie Agent Client CollectorWindows ] manuell auf einem Computer .

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer
  • Installieren Sie Agent Client CollectorWindows manuell auf einem Computer [], wenn Sie den Agent auf einem einzelnen System testen möchten.

    Vorbereitungen

    1. Vergewissern Sie sich, dass der Webserver Agent Client Collector konfiguriert wurde. Details finden Sie unter Websocket-Server auf MID-Server installieren.
    2. Überprüfen Sie Betriebssystem und Version Ihres Servers.
    3. Wenn Sie Microsoft Internet Explorer verwenden, gehen Sie wie folgt vor, um die Agent Client Collector-Installationsdatei vorzubereiten:
      1. Navigieren zu Servermanager > Lokaler Server.
      2. Deaktivieren Sie Verstärkte Sicherheitskonfiguration für IE.
      3. Laden Sie die Installationsdatei herunter.
      4. Ändern Sie die Erweiterung der Installationsdatei von .man in .msi.

    Erforderliche Rolle: agent_client_collector_admin

    Prozedur

    1. Navigieren zu Agent Client Collector > Agent-Downloads.
    2. So führen Sie die Installation mit dem Assistenten durch:
      1. Laden Sie die .msi-Datei herunter, auf die über den Link in der Benutzeroberfläche zugegriffen werden kann.
        Der Installationsassistent wird geöffnet.
      2. Wählen Sie Weiter aus, bis Sie die Seite MID-Webserver-Verbindungseinstellungen erreichen.

        Seite „MID-Verbindungseinstellungen“.

      3. Geben Sie in die Felder des Dialogfelds die relevanten Parameter ein:
        Tabelle : 1. Felder für MID-Webserver-Verbindungseinstellungen
        Feldname Beschreibung
        MID Web Server Name/IP (Name/IP des MID-Webservers) IP-Adresse des MID-Webservers
        MID Web Server Port (Port des MID-Webservers) Portnummer des MID-Webservers. Verwenden Sie eine Zahl zwischen 1024 und 49151.
        MID Web Server API Key (API-Schlüssel des MID-Webservers) API-Schlüssel für den Zugriff auf den MID-Webserver
      4. Wählen Sie Weiter.
        Die Seite Create Local User Account (Lokales Benutzerkonto erstellen) wird angezeigt.

        Seite „Lokalen Benutzeraccount erstellen“.

      5. Wählen Sie im Dialogfeld die relevante Option aus.
        Tabelle : 2. Dialogfeld „Create Local User Account“ (Lokales Benutzerkonto erstellen)
        Optionen Beschreibung
        Use default user (servicenow) (Standardbenutzer (servicenow) verwenden) Standardbenutzer, mit dem Agent Client Collector auf einem Windows-Computer ausgeführt werden soll

        Wenn Sie diese Option auswählen, wird ein lokaler Anwender namens „ servicenow“ als Teil der Installation erstellt.

        Das ServiceNow-Anwenderpasswort wird nach dem Zufallsprinzip generiert und nicht im System gespeichert. Auf dem Hostcomputer wird ein Sicherheitsereignis erstellt, das bei Wiederholung das Öffnen eines Supportfalls erfordert. Weitere Informationen finden Sie im Artikel KB1649116 in der HI Knowledge Base.

        Select existing user (Vorhandenen Benutzer auswählen) Wenn Sie diese Option auswählen, konfigurieren Sie die folgenden Unterfelder:
        • User Name (Benutzername): Benutzername zum Anmelden bei der Windows-Umgebung
        • Password: (Passwort) Kennwort des ausgewählten Benutzers
        Der Benutzer kann einer der folgenden sein:
        • Lokaler Anwender (vom Besitzer der VM erstellt; bietet zusätzliche Resilienz).
        • Domänenbenutzer (von IT-Mitarbeitern erstellt).
        • Verwalteter Serviceaccount: Geben Sie den Namen des verwalteten Serviceaccounts in das Feld Anwendername ein, und lassen Sie das Feld Passwort leer.
        • Lokaler Serviceaccount: Geben Sie LOCALSERVICE im Feld Anwendername ein, und lassen Sie das Feld Passwort leer.
        • Lokales Systemkonto: Geben Sie SYSTEM im Feld Anwendername ein, und lassen Sie das Feld Passwort leer.
        Hinweis:
        Wenn Sie ein lokales Systemkonto verwenden, wird die lokale Gruppe ServiceNow Userserstellt und der erstellte Benutzer wird der Gruppe hinzugefügt. Die ServiceNow-Anwendergruppe hat Zugriff auf die Verzeichnisse Agent Client Collector und verfügt über die folgenden Berechtigungen:
        • Performance Monitor: Gehört zum Lieferumfang des Basissystems; ermöglicht die Anzeige aller Leistungszähler im System
        • Als Serviceanmelden: Ermöglicht das Starten von Netzwerkservices und Services, die kontinuierlich ausgeführt werden, auch wenn niemand bei der Konsole angemeldet ist.
      6. Wählen Sie Anwender erstellen aus.
        Im System wird ein Windows-Benutzer mit den angegebenen Anmeldeinformationen erstellt, und die Seite „Agent Client Collector Configuration“ (Agent Client Collector – Konfiguration) wird angezeigt.
      7. Um die Allow-Liste mit den aktivierten Prüfungen zur Ausführung nach der Einrichtung zu aktivieren, aktivieren Sie auf der daraufhin angezeigten Seite das Kontrollkästchen Enable executing command allow list (Ausführungsbefehl für Allow-Liste aktivieren).

        Kontrollkästchen „Liste zulassen“.

      8. Wählen Sie Weiter aus, um die Installationsseite zu öffnen.

        Wenn die Installation abgeschlossen ist, klicken Sie auf Weiter, um den Assistenten zu beenden und zu schließen.

        Nach einer erfolgreichen Installation startet der Service automatisch und generiert Folgendes:

        • Benutzer: Standard = servicenow (Zur Verwaltung des Service kann auch ein vorhandener Benutzer konfiguriert werden.) Der Benutzer servicenow gehört zur lokalen Benutzergruppe der ServiceNow-Benutzer.
        • Service: AgentClientCollector
        • Dateispeicherort:
          • Standard für Installation = C:\Programme\ServiceNow\agent-client-collector
          • Standard für Servicedateien = C:\ProgramData\ServiceNow\agent-client-collector mit Unterordnern cache, config und log.
    3. Wenn Sie die automatische Installation ausführen möchten, um Installationsberichte zu deaktivieren, führen Sie die Befehlszeile im Abschnitt Silent installation (Automatische Installation) des Verfahrens wie folgt aus:
      msiexec /i <msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events ACC_ALLOW_LIST=False

      Um die Allow-Liste der angegebenen Prüfungen beim Ausführen der automatische Installation zuzulassen, setzen Sie den Parameter ACC_ALLOW_LIST auf True.

    4. Um mehrere MID Servers mit der unbeaufsichtigten Installation zu konfigurieren, führen Sie die Befehlszeile, die im Abschnitt Unbeaufsichtigte Installation des Verfahrens angezeigt wird, mit durch Kommas getrennten Werten wie folgt aus:
      msiexec /i <msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID="wss://<mid1_ip>:<websocket1_port>/ws/events,wss://<mid2_ip>:<websocket2_port>/ws/events"

      Fügen Sie die folgenden Parameterwerte in den Befehl ein:

      Tabelle : 3. Befehlsparameter
      Parameter Wert
      ACC_API_KEY API-Schlüssel, der für den Zugriff auf den MID-Server-Websocket verwendet wird
      ACC_MID URL des MID-Server-Websocket
      DENY_LOCAL_LOGON Wenn dies auf Truefestgelegt ist, wird verhindert, dass sich andere Anwender als der standardmäßige ServiceNow-Anwender beim Service anmelden.

      Standardwert: False

      PASSWORD_NEVER_expires Wenn es auf Truefestgelegt ist, läuft das Passwort für den ServiceNow-Standardanwender nie ab.

      Standardwert: False

      START_SERVICE Wenn dies auf Truefestgelegt ist, wird der Service Agent Client Collector nach der Installation automatisch gestartet.

      Standardwert: True

      LOKALER ANWENDERNAME Account, der Agent Client Collector als Service Windows ausführt. Mögliche Werte:
      • SYSTEM
      • LOCAL SERVICE
      • DOMÄNE\gMSA$
      • Zeichenfolge (lokaler Anwendername)

      Standard = servicenow

      Wenn Sie die Konten SYSTEM, LOCALSERVICE oder DOMAIN\gMSA$verwenden, müssen Sie kein Passwort konfigurieren.

      LOCALPASSWORD Passwort für den im Parameter LOCALUSERNAME angegebenen Anwender.

      Die konfigurierten MID-Server-Werte werden automatisch der Datei acc.yml hinzugefügt. Der Agent stellt eine Verbindung zum ersten verfügbaren MID-Server in der Liste her.

      Um einen sekundären MID Server zu konfigurieren, geben Sie im Abschnitt backend-url der Datei acc.yml die folgende Syntax gemäß .yml-Standard ein: - "wss://<MID IP>:<Web socket port>/ws/events" (mit Anführungszeichen).