MID-Server-Parameter

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 31 Minuten Lesedauer

    • Parameter steuern das Verhalten eines bestimmten MID-Servers und haben eine niedrigere Priorität als die MID-Server-Eigenschaften.

    Verknüpfung mit jedem der MID Server-AbschnitteSicherstellen, dass vom MID Server eine Verbindung zu Elementen inner- und außerhalb Ihres Netzwerks hergestellt werden kannMID Server auf einem Linux- oder Windows-Host herunterladen und installierenMID Server konfigurierenSicherheit des MID Servers konfigurierenSicherstellen, dass vom MID Server eine Verbindung zu Elementen inner- und außerhalb Ihres Netzwerks hergestellt werden kannMID Server auf einem Linux- oder Windows-Host herunterladen und installierenMID Server konfigurierenSicherheit des MID Servers konfigurieren
    Informationen zum Hinzufügen eines Parameters zu einem MID-Server finden Sie unter Fügen Sie einen MID-Server-Parameter hinzu.
    Wichtig:
    Änderungen an Parametern werden nur wirksam, wenn der MID-Server gestartet (oder neu gestartet) wird.
    Hinweis:
    Der Wert eines beliebigen Parameters MID-Server in der Datei config.xml kann verschlüsselt werden. Weitere Informationen finden Sie unter Werte der MID-Server-Konfigurationsdatei verschlüsseln oder entschlüsseln.

    Erforderliche Parameter

    Hinweis:
    Wenn Sie Sonderzeichen in einer XML-Konfigurationsdatei verwenden, müssen Sie diese kodieren.
    URL
    Gibt die URL zur zugeordneten Instanz an. Normalerweise ähnelt die URL „https://instance.service-now.com“, wobei Sie instance durch den Instanznamen ersetzen. Wenn Sie eine eigene Instanz hosten, verwenden Sie die von Ihrer Organisation festgelegte URL.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid_sys_id
    Zeichnet den eindeutigen Identifier des MID-Server-Datensatzes auf. Dieser Parameter sollte leer sein, wenn Sie einen MID-Server zum ersten Mal konfigurieren. Ändern Sie den Wert nicht.
    • Typ: Zeichenfolge
    • Standardwert: automatisch eingestellt (GUID)
    name
    Verwenden Sie diesen Parameter, um einen für Sie sinnvollen Namen anzugeben. Wenn Sie diesen Parameter nicht angeben, verwendet der MID-Server den Standardwert. Ein Satz von Business Rules synchronisiert den Namen in der Konfigurationsdatei mit dem Namen im MID-Server-Datensatz. Die Business Rules stellen sicher, dass das Ändern des Namens an einem Ort auch den Namen am anderen Ort ändert.
    • Typ: Zeichenfolge
    • Standardwert: HIER_IHREN_MID-SERVER-NAMEN_EINGEBEN
    mid.instance.username oder glide.glidesoap.username
    Wenn die Authentifizierung der ServiceNow-Instanz standardmäßig aktiviert ist, legen Sie diesen Parameter fest, um den Benutzernamen festzulegen, den der MID-Server zum Anmelden bei der Instanz verwenden soll. Dieser Benutzer sollte über die Rolle „mid_server“ in der ServiceNow-Instanz verfügen, um auf notwendige Tabellen und Felder zuzugreifen. Mit diesem Parameter können Sie Benutzernamen mit Sonderzeichen definieren.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.instance.password oder glide.glidesoap.password
    Wenn die Authentifizierung Ihrer ServiceNow-Instanz standardmäßig aktiviert ist, legen Sie diesen Parameter fest, um das Passwort festzulegen, das der MID-Server zum Anmelden bei der Instanz verwenden soll. Mit diesem Parameter können Sie Passwörter mit Sonderzeichen definieren.
    • Typ: Zeichenfolge
    • Standardwert: keiner

    CIM-Parameter

    mid.cim.batch.size
    Gibt die maximale Anzahl von Nachrichten an, die gleichzeitig an einen CIM-Server gesendet werden.
    • Typ: Ganzzahl
    • Standardwert: 1
    mid.cim.request.interval
    Gibt die Anzahl von Millisekunden an, die zwischen Anforderungen an denselben Common Information Model Object Manager (CIMOM) gewartet werden soll.
    • Typ: Ganzzahl
    • Standardwert: 0
    mid.cim.host.connection.limit
    Gibt die maximale Anzahl gleichzeitiger Verbindungen pro CMoM an. Ein Wert von Null deaktiviert gleichzeitige Verbindungen.
    • Typ: Ganzzahl
    • Standardwert: 0

    Verbindungsparameter

    glide.mid.fast.responses
    Weist den MID-Server an, zu versuchen, Nachrichten an die Instanz zu senden, sobald sie bereit sind. Normalerweise senden die MID-Server Nachrichten an die Instanz ServiceNow seriell (d. h. eine Nachricht nach der anderen). Da viele Probes parallel ausgeführt werden können, können mehrere Nachrichten gleichzeitig an die Instanz übertragen werden. Wenn Sie diesen Parameter auf true setzen, kann die Zeit zwischen der Beendigung eines Probes und der Ankunft seiner Antwort bei der Instanz verringert werden. Bei mehreren gleichzeitigen Nachrichten werden jedoch Ressourcen verbraucht, was die Reaktionsfähigkeit der Instanz insgesamt verringert. Wenn Kommunikationsprobleme auftreten, kann der Wert dieses Parameters auch einen Stau auf dem MID-Server verursachen, da Threads, die normalerweise zum Ausführen von Probes verwendet werden, unter Umständen zum Senden von Nachrichten verwendet werden. Lassen Sie diesen Parameter im Allgemeinen bei Ihrer Konfiguration aus. Ihn auf true zu setzen, ist nur unter ganz besonderen Umständen sinnvoll.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    glide.mid.max.sender.queue.size
    Setzt eine Obergrenze für die Größe der Warteschlange. Der MID-Server beginnt mit dem Löschen von Nachrichten in der Warteschlange, wenn dieser Grenzwert überschritten wird. Wenn der MID-Server Nachrichten an die ServiceNow-Instanz schneller generiert, als er sie senden kann, werden sie vorübergehend im Dateisystem des MID-Server-Hosts in eine Warteschlange gestellt. Diese Warteschlange ist normalerweise ziemlich klein und wird vollständig geleert, sobald die Verarbeitung des MID-Servers für einen kurzen Zeitraum verlangsamt wird. Diese Warteschlange kann jedoch größer werden, wenn es Kommunikationsprobleme zwischen dem MID-Server und der Instanz gibt, und insbesondere, wenn auf dem MID-Server eine Integration ausgeführt wird.
    Der Parameter hat die Form {Nummer}{Multiplikator}, wobei {Nummer} eine beliebige positive Dezimalzahl einschließlich nicht ganzer Zahlen ist, und der optionale Multiplikator eine beliebige Schreibweise von Bytes, Kilobytes, Megabytes, Gigabytes oder Terabytes (nur das erste Zeichen wird geprüft, und es wird nicht zwischen Groß- und Kleinschreibung unterschieden). Der Standardmultiplikator ist Byte. Leerzeichen werden großzügig toleriert. Die folgenden Zeichenfolgen stellen alle gültige Parameter dar: „1000000000“, „0,5 m“, „5 GB“, „7,67 Gigas“, „145,69392 Meg“ und „1,1 Terra“.
    • Typ: Zeichenfolge
    • Standardwert: 0,5 GB
    instance.date.format
    Gibt das Format an, das die Instanz für Datum und Uhrzeit verwendet. Das Festlegen dieses Parameters hat vor allem zufolge, dass der MID-Server seine Start- und Stoppzeiten für den MID-Server-Datensatz in ServiceNow aktualisiert. Das Format dieser Datums-/Zeitzeichenfolge ist identisch mit dem von der Java-Klasse SimpleDateFormat verwendeten Format.
    • Typ: Zeichenfolge (Datumsformat)
    • Standardwert: jjjj-MM-tt HH:mm:ss
    mid.disable_amb
    Deaktiviert die AMB-Benachrichtigungen (Asynchronous Message Bus) für neue Ausgabenachrichten der ECC-Warteschlange. Weitere Informationen finden Sie im Abschnitt „Asynchronous Message Bus“ inAsynchronous Message Bus. Wenn AMB aktiviert ist, verwendet der MID-Server ein anderes Standardabfrageintervall, als wenn AMB deaktiviert ist. Weitere Informationen finden Sie im Parameter „mid.poll.time“. Wenn Sie ein Abrufintervall mit dem Parameter mid.poll.time festlegen, verwendet der MID-Server diesen Wert unabhängig davon, ob der AMB-Client aktiviert ist oder nicht.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.https.truststore.passwort
    Legt das TrustStore-Passwort fest, das für HTTPS-Verbindungen mit dem AMB-Client (Asynchronous Message Bus) erforderlich ist.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.https.truststore.pfad
    Pfad zum TrustStore, der vom MID-Server für TLS-Transaktionen verwendet werden soll (AMB-Client (Asynchronous Message Bus)). Fügen Sie diesen Parameter nur hinzu, wenn Sie den Standardpfad ändern möchten.
    • Typ: Zeichenfolge
    • Standard: Pfad zum JRE-TrustStore, der mit dem MID-Server gebündelt wird
    mid.instanz.überspringen_basic_auth

    Ermöglicht dem MID-Server, eine Verbindung zu einer Instanz mithilfe von Cookies anstelle von Anmeldeinformationen für die Standardauthentifizierung herzustellen. Bei Festlegung auf truewerden zuerst Cookies verwendet. Wenn jedoch die Verbindung fehlschlägt, versucht der MID-Server erneut, eine Verbindung mit den Anmeldeinformationen der Standardauthentifizierung herzustellen.

    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.jmx.enabled
    Aktiviert einen JMX-Server auf dem MID-Server, der einige Verwaltungsinformationen für JMX-Konsolen verfügbar macht. Die Implementierung von JMX erfordert eine zusätzliche Konfiguration der Java-Laufzeitumgebung. Das Setzen dieses Parameters auf true ist nur für Personen mit detaillierten Kenntnissen der Java-Sicherheitsarchitektur und einem besonderen Bedarf an JMX zu empfehlen.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.poll.time

    Legt das standardmäßige MID-Server-Abfrageintervall (in Sekunden) fest. Das Abfrageintervall gibt an, wie lange der MID-Server wartet, bevor die ECC-Warteschlange auf Arbeit überprüft wird, wenn der MID-Server nicht ausgelastet ist. Weitere Informationen finden Sie im Abschnitt „Asynchronous Message Bus“ in.

    Wenn mid.disable.amb auf „false“ festgelegt ist (Standardeinstellung), finden Sie im Abschnitt „Asynchronous Message Bus“ in Asynchronous Message Bus weitere Informationen zur Verwendung von mid.poll.time.

    Wenn „mid.disable.amb“ auf „wahr“ festgelegt ist, erfolgt die Abfrage in einem festen Intervall von „mid.poll.time“. Die Abfrage wechselt jedoch zu „mid.poll.time.standard “ (standardmäßig 5 Sekunden), wenn der MID-Server ausgelastet ist.

    • Typ: Ganzzahl (Sekunden)
    • Standardwert: 40, wenn mid.disable.amb „ falsch“ ist, oder 5, wenn mid.disable.amb „ wahr“ ist.
    mid.probe.wait.resources
    Gibt an, ob die Probe-Ausführung verzögert wird, bis Ressourcen verfügbar sind. Wird verwendet, um die Ressourcenreservierung für den MID-Serverzu aktivieren.
    Hinweis:
    Erfordert einen Neustart des MID-Servers.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.property.long_runner
    Gibt den Namen eines Script Include an, die lange ausgeführte Befehle verwaltet.
    Hinweis:
    Diese Eigenschaft gilt nur bis zur Version Rome. Wenn es sich bei Ihrer Instanz um eine spätere Version handelt, müssen Sie die Systemeigenschaft glide.eccprobe.longrunner.classkonfigurieren.
    • Typ: Zeichenfolge
    • Standardwert: LongRunner
    threads.interactive.max
    Legt die maximale Anzahl interaktiver Worker-Threads fest, die gleichzeitig im interaktiven Thread-Pool ausgeführt werden können. Siehe Thread-Nutzung des MID-Servers festlegen.
    • Typ: Ganzzahl
    • Standardwert: 10
    threads.expedited.max
    Legt die maximale Anzahl von Expedited-Worker-Threads fest, die gleichzeitig im Expedited-Thread-Pool ausgeführt werden können. Siehe Thread-Nutzung des MID-Servers festlegen.
    • Typ: Ganzzahl
    • Standardwert: 20
    threads.max
    Legt die maximale Anzahl von Standard-Worker-Threads fest, die gleichzeitig im Standard-Thread-Pool ausgeführt werden können. Mit diesem Parameter können Sie direkt steuern, welche CPU-Ressourcen der MID-Server auf dem Computer verwendet, auf dem er gehostet wird. Siehe Thread-Nutzung des MID-Servers festlegen.
    • Typ: Ganzzahl
    • Standardwert: 25
    Wichtig:
    Sie können „Threads.max“ auf 200 festlegen. Diese Einstellung muss jedoch je nach Betriebssystem möglicherweise geändert werden. Beispielsweise wird bei Windows-basierten MID Servern, auf denen Discovery ausgeführt wird, Powershell verwendet, was ressourcenintensiv ist. In diesem Fall könnten Sie die CPU-Leistung des Hostcomputers mit nur 50 Threads ausschöpfen.

    Parameter für Anmeldeinformationen

    mid.aws.instance_profile_name
    Name der in der EC2-Instanz konfigurierten AWS IAM-Rolle. Bei entsprechender Konfiguration verwendet der MID-Server die temporären Anmeldeinformationen, die dieser Rolle vom AWS-Instanzprofil zur Erkennung von Cloud-Ressourcen gewährt werden.
    • Typ: Zeichenfolge
    • Standardwert: Keine (Anwender muss einen nicht leeren Wert angeben)
    mid.credentials.provider
    Gibt den Java-Klassennamen des Anmeldeinformationsanbieters an.
    • Typ: Zeichenfolge
    • Standardwert: com.service_now.mid.creds.standard.StandardCredentialsProvider
    mid.secure_credentials.key_pairs.provider
    Klasse, die vom MID-Server zum Generieren sicherer Schlüsselpaare verwendet wird.
    • Typ: Zeichenfolge
    • Standardwert: com.service_now.mid.keypairs.provider.standard.StandardKeyPairsProvider

    Debug-Parameter

    debug.logging

    [Veraltet] Gibt an, ob die Protokollierung von MID-Server-Ereignissen und -Nachrichten (sowohl gesendete als auch empfangene) aktiviert werden soll. Normalerweise wird dieser Parameter nur von Entwicklern verwendet, er ist jedoch gelegentlich bei der Problembehandlung hilfreich. Beachten Sie, dass das Einstellen dieses Parameters auf true zu intensiver Protokollierung auf dem MID-Server führt und möglicherweise erheblichen Speicherplatz belegt.

    • Typ: Wahr | Falsch
    • Standardwert: falsch

    Dieser Parameter wurde durch den Parameter mid.log.level ersetzt.

    debuggen

    [Veraltet] Gibt an, ob die Debug-Protokollierung auf dem MID-Server aktiviert werden soll. Normalerweise wird dieser Parameter nur von Entwicklern verwendet, er ist jedoch gelegentlich bei der Problembehandlung hilfreich. Beachten Sie, dass das Einstellen dieses Parameters auf true zu intensiver Protokollierung auf dem MID-Server führt und möglicherweise erheblichen Speicherplatz belegt.

    • Typ: Wahr | Falsch
    • Standardwert: falsch

    Dieser Parameter wurde durch den Parameter mid.log.level ersetzt.

    file.probe.template.debug
    Gibt an, ob Vorlagen für Datei-Probes debuggt werden sollen.
    • Typ: Wahr | Falsch
    • Standardwert: false
    mid.cim.debug
    Gibt an, ob die Debug-Protokollierung für CIM, WBEM, SLP oder SMI-S aktiviert werden soll.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.ssh.debug
    Aktiviert SSH-Debug-Informationen in der Protokolldatei. Die Parameterverwendung hängt davon ab, ob der ServiceNow-SSH-Client aktiviert ist.
    Wenn der ServiceNow-SSH-Client aktiviert ist, funktioniert der Parameter wie folgt:
    • Typ: Zeichenfolge
    • Standardwert: falsch

      Die folgenden Zeichenfolgenwerte sind für den ServiceNow-SSH-Client gültig:

      • true: Aktiviert SSH-Debug-Informationen in der Protokolldatei.
      • false: Deaktiviert SSH-Debug-Informationen in der Protokolldatei.
      • <IP-Adressen>: Geben Sie an, für welche IP-Bereiche SSH-Debug-Informationen in der Protokolldatei aktiviert werden sollen. Sie können IP-Adressen in den folgenden Formaten eingeben:
        • Ein IP-Bereich, der durch einen Schrägstrich und die Anzahl der Bits im Subnetz definiert ist. Beispielsweise durchsucht der String 10.10.10.0/24 24-Bit-IP-Adressen von 10.10.10.0 bis 10.10.10.254.
        • Ein IP-Bereich, der durch einen Bindestrich definiert wird. Der String 10.10.11.0-10.10.11.165 durchsucht beispielsweise die IP-Adressen von 10.10.11.0 bis 10.10.11.165.
        • Eine durch Kommas getrennte Liste bestimmter IP-Adressen. Zum Beispiel durchsucht die Zeichenfolge 10.10.11.200,10.10.11.235 die IP-Adressen 10.10.11.200 und 10.10.11.235.
      • verzögert: Protokolliert SSH-Debug-Informationen im Speicher, sofern keine Fehler oder Warnungen auftreten. Wenn ein Fehler oder eine Warnung auftritt, veröffentlicht die Plattform die Debug-Informationen in der Protokolldatei. Dadurch wird sichergestellt, dass nur der Teil der Protokolldatei aufgezeichnet wird, der sich auf den Fehler oder die Warnung bezieht. Wenn kein Fehler oder keine Warnung erkannt wird, löscht die Plattform die nicht verwendeten Protokolldaten aus dem Speicher, sobald die Sitzung geschlossen wird. In jeder Sitzung werden bis zu 1000 Protokollnachrichten gespeichert. Wenn die Sitzung 1000 Protokollnachrichten überschreitet, verwirft das verzögerte Protokoll die älteste Protokollnachricht, um Platz für die neueste Protokollnachricht zu schaffen.
    Wenn der ServiceNow-SSH-Client deaktiviert ist, aktiviert bzw. deaktiviert der Parameter SSH-Debug-Informationen in der Protokolldatei:
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    Hinweis:
    Der MID-Server-Parameter „mid.ssh.debug“ wirkt sich nur auf SNCSSH und J2SSH aus. Um die Debug-Protokollierung für den Maverick-Client zu aktivieren, legen Sie den MID-Server-Konfigurationsparameter mid.log.level auf debug, com.maverick=debugfest.
    mid.log.level
    Gibt die Protokollierungsebene für den MID-Server an. Mögliche Werte sind:
    • debuggen
    • info
    • warn
    • error
    Hinweis:
    Die Groß- und Kleinschreibung hat keinen Einfluss auf die Werte.
    • Typ: Zeichenfolge
    • Standardwert: info
    mid.http.idle_connection_monitor.debug
    Aktiviert die Debug-Protokollierung für den Idle Connection Monitor.
    • Typ: Wahr | Falsch
    • Standardwert: falsch

    DNS-Parameter

    mid.dns_scan.regulator.interval_ms
    Gibt das Intervall zwischen DNS-Scans in Millisekunden an.
    • Typ: Ganzzahl
    • Standardwert: 10
    mid.dns_scan.regulator.packets_per_interval
    Gibt die Anzahl der Reglerpakete pro DNS-Scan an.
    • Typ: Ganzzahl
    • Standardwert: 1
    mid.dns_scan.default_name_servers
    Gibt die Host-Namen oder IP-Adressen der Standardnamenserver an.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.dns_scan.default_name_servers
    Gibt die Host-Namen oder IP-Adressen der Standardnamenserver an.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.dns_scan.additional_name_servers
    Gibt die Host-Namen oder IP-Adressen von zusätzlichen Nameservern an.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.dns_scan.load_balancing_enable
    Gibt an, ob das Load Balancing von Namenservern aktiviert werden soll.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.probe.use_legacy_forward_dns
    Aktiviert die Legacy-DNSNameResolver-Probe und deaktiviert die Standard-DNSNameResolver-Probe. Weitere Informationen finden Sie unter Probes used by Orchestration.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.probe.use_legacy_reverse_dns
    Aktiviert die Legacy-DNS-Probe und deaktiviert die Standard-DNS-Probe. Wenn Probleme mit den Funktionen der Standard-DNS-Probe auftreten, können Sie diese Funktionen mit diesem Parameter deaktivieren. Zu den Funktionen der Standard-DNS-Probe gehören, dass sie durch die parallele Ausführung schlank und schneller ist, während die Legacy-Probe vom MID Server gedrosselt wird, da sie seriell ausgeführt wird. Die Standardprobe nutzt die DNS-Suche durch das MID-Server-Hostbetriebssystem, um den vom Betriebssystem verwalteten DNS-Cache zu verwenden, die Legacy-Probe hingegen nicht. Wenn eine DNS-Suche mit der Standardprobe in Windows-Systemen fehlschlägt, versucht das Betriebssystem daher auch, eine Suche anhand des NETBIOS-Namens durchzuführen.
    • Typ: Wahr | Falsch
    • Standardwert: falsch

    Event Management-Parameter

    mid.probe.event.bulk_size
    Gibt die maximale Größe einer Event-Payload in MB an.
    • Typ: Ganzzahl
    • Standardwert: 120
    mid.probe.event.wait_time
    Wartezeit in einer leeren Warteschlange zum Senden von Events.
    • Typ: Ganzzahl
    • Standardwert: 1000
    mid.probe.event.send.enabled
    Aktiviert oder deaktiviert das Senden von Events.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.probe.event.queue.max_size
    Gibt die maximal zulässige Größe für die Event-Warteschlange an, bevor eingehende Events abgelehnt werden.
    • Typ: Ganzzahl
    • Standardwert: 100.000
    mid.probe.event.max.retry_time
    Die maximale Anzahl von Sekunden, in denen MID das Senden von Ereignissen wiederholt.
    • Typ: Ganzzahl
    • Standard: 1800
    mid.probe.event.queue.use_bulk
    Gibt an, ob Events einzeln oder in einem Massenvorgang an den Server gesendet werden. Wenn dieser Parameter als „wahr“ ausgewertet wird, werden Ereignisse massenweise an den Server gesendet.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.probe.event.suppress.whitespaces
    Ermöglicht Zeilenumbrüche in Beschreibungsfeldern für mehrzeilige Ereignisse. Wenden Sie diesen Parameter auf jeden MID-Server an, der mit Ereignis-Connector-Instanzen verwendet wird. Die Auswahlmöglichkeiten lauten wie folgt:
    alle
    Mit dieser Einstellung werden alle Leerzeichen entfernt.
    „leave_as_is“
    Diese Einstellung behält alle Leerzeichen bei.
    „keep_newline“
    Diese Einstellung behält nur „new_line“ bei und entfernt alle anderen Leerzeichen.
    • Typ: Zeichenfolge
    • Standard: alle
    mid.em.metric.metric_to_ci_map_limit
    Gibt die maximale Anzahl aktiver Metriken an, die pro CI-Map zulässig sind.
    • Typ: Ganzzahl
    • Standardwert: 200.000
    mid.em.metric_binding_timeout_seconds
    Gibt die Anzahl Sekunden an, die gewartet werden muss, bevor nicht behandelte Events erneut gesendet werden
    • Typ: Ganzzahl
    • Standardwert: 300
    mid.em.metric_binding_timeout_max_seconds
    Gibt die maximale Anzahl Sekunden an, die gewartet werden muss, bevor nicht bearbeitete Events erneut gesendet werden.
    • Typ: Ganzzahl
    • Standardwert: 10800
    mid.em.metric_max_elapsed_time_before_refresh
    Gibt die maximale Anzahl an Sekunden an, bevor der Metrik-Quelltyp-Cache im Speicher aktualisiert wird.
    • Typ: Ganzzahl
    • Standardwert: 60
    mid.em.matric_max_sql_string_length_for_types
    Gibt die maximale Länge der Zeichenfolge (bestehend aus Typen) an, die für einen SQL-Befehl verwendet wird
    • Typ: Ganzzahl
    • Standardwert: 30000
    mid.em.statistics_report_perioon_sec
    Gibt den Zeitraum in Sekunden zwischen Statistikberichten an die Instanz an. Verwenden Sie 0, um die Berichterstellung zu deaktivieren. Dieser Parameter erfordert einen Neustart.
    • Typ: Ganzzahl
    • Standardwert: 60
    mid.em.metric_connector_max_run_time_seconds
    Gibt die maximale Anzahl von Sekunden an, um Metriken in jedem Zyklus zu erfassen.
    • Typ: Ganzzahl
    • Standardwert: 300
    mid.em.metric_connector_history_min
    Gibt die Anzahl der Minuten an, die zum Abrufen von Metriken im Verlauf zurückgegangen werden soll.
    • Typ: Ganzzahl
    • Standardwert: 180
    mid.em.metric_event_logging
    Gibt die Stufe der Metrik- und Event-Protokollierung an. Die Auswahlmöglichkeiten sind:
    • Keine
    • alle
    • events
    • metrics
    • metrics:<Filter>
    • events:<Filter>
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.em.metric_connector_late_arrivals_delay
    Gibt die Anzahl der Sekunden an, die beim Erfassen von Metriken verzögert werden soll.
    • Typ: Ganzzahl
    • Standardwert: 30

    FTP-Verbindungsparameter

    mid.ftp.max_pool_size
    Gibt die maximale Größe des FTP-Verbindungspools in Megabyte an.
    • Typ: Ganzzahl
    • Standardwert: 25
    mid.ftp.max_per_target
    Gibt die maximale Anzahl der FTP-Verbindungen pro Ziel an.
    • Typ: Ganzzahl
    • Standardwert: 5
    mid.ftp.max_conn_idle_time
    Gibt die maximale Zeit in Millisekunden an, die eine FTP-Verbindung im Pool inaktiv bleiben kann.
    • Typ: Ganzzahl
    • Standardwert: 300000
    mid.filesystem.max.ls
    Gibt die maximale Anzahl von Dateien an, die mit dem Befehl „filesystem list directory“ zurückgegeben werden können.
    • Typ: Ganzzahl
    • Standardwert: 10.000

    Protokollierungsparameter

    disable_monitors
    Gibt an, ob die aktive Suche nach Monitoren in der Instanz durch den MID-Server deaktiviert werden soll.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.show.queries
    Legt fest, ob der MID-Server Details zu jeder Abfrage an die ServiceNow-Instanz protokollieren soll. Normalerweise wird dieser Parameter nur von Entwicklern verwendet, er ist jedoch gelegentlich bei der Problembehandlung hilfreich. Beachten Sie, dass das Einstellen dieses Parameters auf true zu intensiver Protokollierung auf dem MID-Server führt und möglicherweise erheblichen Speicherplatz belegt.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    disable.remote.logging
    Verhindert, dass der MID-Server Informationen in dem MID-Serverprotokoll in der Instanz protokolliert. In der Instanz werden ohnedies relativ wenige Informationen protokolliert. Durch das Einstellen dieses Parameters auf true wird jedoch die gesamte Protokollierung in der Instanz ausgeschlossen.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    disable.status
    Verhindert, dass der MID-Server alle 10 Minuten einen Statusbericht an die Instanz sendet.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.file_cleaner.disabled

    Dateien und leere Ordner in den folgenden Ordnern können von dieser MID-Dateibereinigung gelöscht werden. Dateien, auf die zuletzt vor mehr als 30 Tagen zugegriffen wurde, werden gelöscht. Sie wird beim Start und danach alle 24 Stunden ausgeführt. Sie können die Ausführung der Dateibereinigung durch einen Neustart des MID-Server-Service erzwingen.

    Bereinigte Ordner/Dateien:
    • \agent\import
    • \agent\export: Wird von der Exportsatz-Funktion verwendet.
    • \agent\work\monitors\ECCSender\output_error : Wird für ECC-Eingabenutzlasten verwendet, die aus irgendeinem Grund nicht eingefügt werden können
    • \agent\work\monitors\ECCSender\output_oversize : Wird zum Speichern von Kopien von Nutzlasten verwendet, die nicht an die Instanz gesendet werden, da sie größer als der von mid.eccq.max_payload_sizefestgelegte Grenzwert sind, der standardmäßig 20000000 Byte beträgt
    • \agent\logs: Speziell JFR-Dumps
    • Typ: Wahr | Falsch
    • Standardwert: falsch

    mTLS-Protokollparameter

    Fügen Sie diese Parameter der Datei config.xml im Verzeichnis /agent im Installationsverzeichnis MID-Server hinzu.

    mid.httpclient.protocol.myprotocol.path

    Gibt den Pfad zum Schlüsselspeicher an. Der Pfad kann absolut oder relativ sein. Ersetzen Sie im Parameternamen „myprotocol“ durch den Namen Ihres Protokolls.

    Typ: Zeichenfolge

    mid.httpclient.protocol.myprotocol.port

    Gibt die Portnummer für das Protokoll an. Ersetzen Sie im Parameternamen „myprotocol“ durch den Namen Ihres Protokolls.

    Typ: Zeichenfolge

    mid.httpclient.protocol.myprotocol.password

    Gibt das Passwort für die mTLS-Anmeldeinformationen an. Ersetzen Sie im Parameternamen „myprotocol“ durch den Namen Ihres Protokolls. Fügen Sie das Verschlüsselungsattribut secure="true" hinzu, um das Passwort mit der Standardverschlüsselung MID-Server zu verschlüsseln.

    Typ: Zeichenfolge

    Musterparameter

    mid.parsing.max_field_size

    Legt die maximale Zeichenlänge von Zeichenfolgen fest, die während der Ausführung von Mustern als temporäre Variablen gespeichert werden. Zeichenfolgen, die länger als der Wert dieses Parameters sind, werden gekürzt, um dem Wert zu entsprechen. Verwenden Sie den Parameter, um den Grenzwert beim Analysieren längerer Zeichenfolgen zu erhöhen.

    Warnung:
    Das Überschreiten der maximalen Feldgröße der SQL-Datenbankimplementierung führt zu Fehlern.
    • Typ: Ganzzahl
    • Standardwert: 1024
    mid.sa.discovery.pattern_string_attributes.deduplizieren

    Reduziert den Arbeitsspeicherverbrauch für Musterausführungskontextattribute durch die Beseitigung doppelter Zeichenfolgen.

    • Typ: Wahr | Falsch
    • Standardwert: wahr

    Proxy-Server-Parameter

    mid.instance.use_proxy oder mid.proxy.use_proxy
    Wenn Ihr MID-Server für den Zugriff auf die Instanz ServiceNow einen Webproxy verwenden muss, legen Sie diesen Parameter auf „wahr“ fest, um den MID-Server zur Verwendung des Proxys anzuweisen. Sie müssen auch den Host und den Port des Proxy-Servers sowie möglicherweise den Benutzernamen und das Passwort festlegen.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.proxy.host
    Wenn Ihr MID-Server einen Web-Proxy für den Zugriff auf die ServiceNow-Instanz durchlaufen muss, stellen Sie diesen Parameter ein, um den Host des Proxys festzulegen.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.proxy.password
    Wenn Ihr MID-Server einen Web-Proxy durchlaufen muss, um auf die ServiceNow-Instanz zuzugreifen, und Ihr Proxy ein Passwort erfordert, legen Sie diesen Parameter fest, um dieses Passwort zu definieren.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.proxy.port
    Wenn Ihr MID-Server einen Web-Proxy für den Zugriff auf die ServiceNow-Instanz durchlaufen muss, stellen Sie diesen Parameter ein, um den Port des Proxys festzulegen.
    • Typ: Ganzzahl (0-65535)
    • Standardwert: 80
    mid.proxy.username
    Wenn der MID-Server einen Web-Proxy durchlaufen muss, um auf die ServiceNow-Instanz zuzugreifen, und der Proxy einen Benutzernamen erfordert, legen Sie diesen Parameter fest, um diesen Benutzernamen zu definieren.
    • Typ: Zeichenfolge
    • Standardwert: keiner

    Überschreibungsparameter für Zeitüberschreitung für Anforderungen

    mid.sa.cloud.request_timeout
    Legt die Zeitüberschreitung für Cloud-Anforderungen in Millisekunden fest. Dieser Parameter überschreibt die Systemeigenschaft glide.http.timeout, die die maximale Anzahl von Millisekunden angibt, die gewartet werden soll, bevor bei einer ausgehenden REST-Transaktion eine Zeitüberschreitung auftritt.
    • Typ: Ganzzahl
    • Standardwert: 30000
    mid.http_classy.request_timeout
    Legt die Zeitüberschreitung in Millisekunden für HTTP-Klassifizierungsanforderungen mit der Probe „HTTP – Klassifizieren“ fest. Dieser Parameter überschreibt die Systemeigenschaft glide.http.timeout, die die maximale Anzahl von Millisekunden angibt, die gewartet werden soll, bevor bei einer ausgehenden Transaktion eine Zeitüberschreitung auftritt.
    • Typ: Ganzzahl
    • Standardwert: 30000

    Sicherheitsparameter

    mid.windows_host.file_permissions.allow_list
    Legt eine Aufnahmeliste für die Erzwingung von Windows-Dateiberechtigungen fest, um die Sicherheit zu verbessern. Der Parameter akzeptiert eine Zeichenfolge von kommagetrennten Gruppennamen, Anwendernamen und SIDs. Gruppen- und Anwendernamen müssen den Benennungsanforderungen für SAM-Accounts entsprechen. Domänen-Accounts können mithilfe der SID angegeben werden.
    • Typ: Zeichenfolge (kommagetrennte Gruppen- und Anwendernamen)
    • Standardwert: keiner
    mid.windows_host.file_permissions.enforce
    Ermöglicht dem MID-Server die Verwendung der Erzwingung von Windows-Dateiberechtigungen, um die Sicherheit zu verbessern. Wenn Sie diesen Parameter auf „falsch“ setzen, kann der MID-Server die Liste der Dateiberechtigungen nicht aktualisieren, die Dateiberechtigungen werden jedoch nicht rückgängig gemacht.
    • Typ: Wahr | Falsch
    • Standardwert: wahr

    Shazzam-Parameter

    mid.shazzam.regulator.interval_ms
    Legt das Intervall in Millisekunden fest, in dem Shazzam Pakete starten kann. Dieser Parameter arbeitet mit dem Parameter mid.shazzam.regulator.packets_per_interval, um die Anzahl der in diesem Intervall zulässigen Pakete festzulegen. Standardmäßig startet Shazzam pro Millisekunde ein Paket.
    • Typ: Ganzzahl
    • Standardwert: 1
    mid.shazzam.regulator.packets_per_interval
    Legt die Anzahl der Pakete fest, die Shazzam im konfigurierten Zeitintervall starten kann. Dieser Parameter arbeitet mit dem Parameter mid.shazzam.regulator.interval_ms, der dieses Intervall festlegt. Standardmäßig startet Shazzam pro Millisekunde ein Paket.
    • Typ: Ganzzahl
    • Standardwert: 1
    mid.shazzam.chunk_size
    Gibt die maximale Anzahl von IP-Adressen an, die Shazzam parallel durchsucht. Dieser Parameter steuert hauptsächlich die ausgehende Port-Nutzung.
    • Typ: Ganzzahl
    • Standardwert: 100
    mid.shazzam.threads
    Gibt die Anzahl der gleichzeitigen Threads an, die von Shazzam verwendet werden. Wenn Sie diesen oder den Parameter „mid.shazzam.max_scanners_per_thread“ auf 0 setzen, wird die Shazzam-Multithread-Optimierung deaktiviert.
    • Typ: Ganzzahl
    • Standardwert: 5
    mid.shazzam.max_scanners_per_thread
    Gibt die Anzahl der gleichzeitigen Scanner an, die von jedem Shazzam-Thread verarbeitet werden. Wenn Sie diesen oder den Parameter „mid.shazzam.threads“ auf 0 setzen, wird die Shazzam-Multithread-Optimierung deaktiviert.
    • Typ: Ganzzahl
    • Standardwert: 500

    SNMP-Konfigurationsparameter

    mid.snmp.enable_auto_public
    Gibt an, ob die öffentliche SNMP-Community-Zeichenfolge automatisch verwendet werden soll, wenn keine anderen SNMP-Anmeldeinformationen erfolgreich waren.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.snmp.request.timeout
    Gibt den Wert für den Timeout der ersten OID-Anforderung in Millisekunden an. Für nachfolgende Anforderungen (z. B. Tabellen-OIDs) wird der Parameter mid.snmp.session.timeout configuration (siehe unten) wirksam.
    Hinweis:
    Sie können diesen Parameter mit dem SNMP-Probe-Parameter timeout überschreiben.
    • Typ: Ganzzahl
    • Standardwert: 1500
    mid.snmp.session.timeout
    Gibt den Timeout-Wert für die nachfolgende OID-Anforderung in Millisekunden an. Die SNMP-Kommunikation hat keinen Status und keine Sitzung oder Verbindung im normalen Sinne. Das System betrachtet eine positive Antwort von der ersten OID-Anforderung als ein Zeichen, dass auf nachfolgende Anfragen sofortige Antworten erwarten werden sollen. Der Standardwert ist zwar „short“, es kann jedoch nützlich sein, diesen Parameterwert auf den gleichen Wert zu erhöhen, der für mid.snmp.request.timeoutverwendet wird.
    Hinweis:
    Sie können diesen Parameter mit dem SNMP-Probe-Parameter establish_session_timeout überschreiben.
    • Typ: Ganzzahl
    • Standardwert: 500
    mid.snmp.use_getbulk
    Gibt an, ob GETBULK zum Empfangen einer großen Datenmenge in Batches verwendet werden soll. Dies kann zum Konfigurieren eines einzelnen MID Servers verwendet werden.
    • Typ: Wahr | Falsch
    • Standardwert: True
    GETBULK kann auch auf Probenebene oder global für alle MID-Server festgelegt werden. Einstellungen werden in ihrer Prioritätsfolge aufgelistet:
    mid.snmp.use_snmp4j
    Snmp4j-Bibliothek für die SNMP-Kommunikation verwenden. Dies ist eine strikte Anforderung für SNMPv3. Dieser Parameter sollte nur basierend auf dem Rat von Kundenservice und Supportauf „false“ festgelegt werden.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.snmp.use_snmp_v1_v2c
    Snmp4j-Bibliothek für die SNMP-Kommunikation verwenden. Dies ist eine strikte Anforderung für SNMPv3. Dieser Parameter sollte nur basierend auf dem Rat von Kundenservice und Supportauf „false“ festgelegt werden.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.snmp.use_snmp_v3
    Versucht die Kommunikation mit der SNMPv3-Protokollversion. Erfordert die Konfiguration von SNMPv3-Anmeldeinformationen.
    • Typ: Wahr | Falsch
    • Standardwert: wahr

    SSH-Discovery-Parameter

    Standardmäßig ist der MID-Server für die Suche nach SSH-Befehlen in den folgenden Pfaden und den Standardpfaden des angemeldeten Benutzers konfiguriert:
    • /usr/sbin
    • /usr/bin
    • /bin
    • /sbin
    mid.connection_cache
    Gibt an, ob Verbindungen zwischengespeichert werden sollen. Setzen Sie den Parameter auf false, um Verbindungs-Caching deaktivieren. Dieser Parameter gilt nur für SSH-Verbindungen.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.ssh.set_path
    Gibt an, ob die Umgebungsvariable PATH für SSH-Befehle festgelegt werden soll.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.ssh.local
    Gibt an, ob Befehle für den MID-Server-Host-Computer (localhost) über SSH und nicht über eine Konsole ausgeführt werden sollen. Dadurch können lang laufende Befehle ordnungsgemäß ausgeführt werden. Dieser Parameter gilt nur für den älteren SSH-Client.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.ssh_connections_per_host
    Steuert die Anzahl der gleichzeitigen Probes, die der MID-Server auf einem bestimmten Host ausführen kann. Das Verringern der Anzahl gleichzeitiger Verbindungen kann Discovery verlangsamen.
    • Typ: Ganzzahl
    • Standardwert:

      7 für den ServiceNow-Client

      3 für den Legacy-SSH-Client.

    mid.ssh.sudo_preserve_environment
    Gibt an, ob Sudo verwendet werden soll, um die Umwelt für SSH zu erhalten.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.ssh.terminal.width
    Steuert die maximalen Zeichen pro Zeile bei der Verarbeitung von sudo -l im Terminal. Wenn der Wert zu niedrig ist, kann die Ausgabe in mehrere Zeilen aufgeteilt werden, was sich auf den Parser auswirkt. Legen Sie den Wert auf eine ausreichende Größe fest, um Ausgaben nach Bedarf zu verarbeiten.
    • Typ: int
    • Standardwert: 255
    mid.ssh.path_override
    Überschreibt die Standardpfade, die vor der Ausführung eines Befehls festgelegt wurden. Geben Sie einen oder mehrere Überschreibungspfade durch einen Doppelpunkt (:) getrennt ein. Der Standardpfad ist /usr/sbin: /usr/bin:/bin:/sbin.
    • Typ: Zeichenfolge (eine durch Doppelpunkte getrennte Liste von Verzeichnissen)
    • Standardwert: keiner
    Der ServiceNow-SSH-Client akzeptiert die folgenden Präfixe vor dem Wert path_overide.
    • append: Hängt den Überschreibungspfad an das Ende des Hostpfads an. Dies ist das Standardverhalten.
    • replace: Ersetzt den Hostpfad durch den Wert „path_overide“.
    • prepend: Hängt den Überschreibungspfad an den Anfang des Hostpfads an.
    mid.ssh.use_snc
    Aktiviert den ServiceNow-SSH-Client (SNCSSH) auf einzelnen MID-Servern. SNCSSH ist eine ServiceNow-Implementierung eines SSH-Clients und standardmäßig für alle MID-Server auf neuen Instanzen über eine MID-Server-Eigenschaft aktiv. Das Aktivieren des ServiceNow-SSH-Clients deaktiviert den älteren J2SSH-Client.
    Wichtig:
    Das Mischen von SSH-Client-Typen für MID-Server, die mit derselben Instanz verbunden sind, ist nicht empfehlenswert.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.ssh.max_retries
    Gibt an, wie oft eine SSH-Operation nach einem Timeout maximal wiederholt werden darf. Zwischen den einzelnen Verbindungsversuchen geht das System für jeweils zwei Sekunden in den Ruhezustand. Standardmäßig wiederholt der MID-Server den Versuch nur einmal. Setzen Sie den Parameter auf 0, um Wiederholungen zu deaktivieren.
    • Typ: Ganzzahl
    • Standardwert: 1
    mid.ssh.alt_rm
    Legt einen anderen Befehl zum Entfernen der SSH-Datei fest.
    • Typ: Zeichenfolge
    • Standardwert: keiner
    mid.ssh.initial_delay_ms
    Verzögert das Senden von SSH-Probe-Befehlebefehlen an einen Server, nachdem die Verbindung zum Ziel für die angegebene Zeit (in Millisekunden) hergestellt wurde. Dieser Parameter gilt nur für den älteren SSH-Client.
    • Typ: Ganzzahl (Millisekunden)
    • Standardwert: 0
    mid.ssh.suppress_history
    Unterdrückt die Generierung der SSH-Verlaufsdatei. Dieser Parameter gilt nur für den älteren SSH-Client.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.ssh.socket_timeout
    Gibt den Timeout-Wert für den SSH-Socket an, um Probleme zu vermeiden, die durch ein Socket-Timeout verursacht werden. Einige Geräte, z. B. Systeme mit eingebetteten Controllern wie USVs und PDUs, für die SSH aktiviert ist, benötigen mehr Zeit, um auf eine Authentifizierungsanforderung zu antworten. Der Standardwert von 2 Minuten stellt sicher, dass bei solchen Anforderungen kein vorzeitiges Timeout auftritt.
    • Typ: Ganzzahl (Millisekunden)
    • Standardwert: 120000 (2 Minuten)
    mid.ssh.channel_timeout
    Gibt die Zeit an, die der MID-Server auf Aktivität auf dem SSH-Socket wartet, bevor die Verbindung geschlossen wird. Wenn auf dem SSH-Socket keine Aktivität für den angegebenen Timeout-Wert erfolgt ist, schließt der MID-Server die Verbindung. Einige Geräte, z. B. Systeme mit eingebetteten Controllern wie USVs und PDUs, für die SSH aktiviert ist, benötigen möglicherweise mehr Zeit, um auf eine Authentifizierungsanforderung zu antworten.
    • Typ: Ganzzahl (Millisekunden)
    • Standardwert: 120000 (2 Minuten)
    mid.ssh.session_timeout
    Gibt an, wie lange eine zwischengespeicherte Sitzung nach der letzten Verwendung im Speicher verbleibt. Zu kleine Werte können die Leistung beeinträchtigen. Dieser Parameter gilt nur für den ServiceNow-SSH-Client.
    • Typ: Ganzzahl (Millisekunden)
    • Standardwert: 300000 (5 Minuten)
    mid.ssh.command_timeout_ms
    Die Timeout-Dauer in Millisekunden für die Ausführung eines SSH-Befehls.
    • Typ: Ganzzahl (Millisekunden)
    • Standardwert: 300000 (5 Minuten)
    mid.ssh.use_keyboard_interactive
    Verwendet den interaktiven Tastatur-Authentifizierungsmodus in SSH-Daemons, auf denen er aktiviert ist.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    Warnung:
    In Mac OS X Sierra (und höher) tritt ein Problem mit der Authentifizierungsreihenfolge des Passwort- und des tastaturinteraktivenModus auf, das zum Fehlschlagen von Discovery führen kann. Einzelheiten zu diesem Problem und zur erforderlichen Konfiguration für die SSH-Authentifizierung finden Sie unter KB0623600.
    mid.ssh.dh_group_length_min
    Gibt die minimale Gruppenlänge in Bits an, die zum Generieren eines „gemeinsamen geheimen“ Schlüssels im Diffie-Hillman-Schlüsselaustausch verwendet wird. Je größer der Schlüssel, desto sicherer ist die SSH-Verbindung, jedoch auf Kosten der Leistung.
    • Typ: Ganzzahl (Bits)
    • Standardwert: 1024
    mid.ssh.dh_group_length_max
    Gibt die maximale Gruppenlänge in Bits an, die zum Generieren eines „gemeinsamen geheimen“ Schlüssels im Diffie-Hillman-Schlüsselaustausch verwendet wird. Je größer der Schlüssel, desto sicherer ist die SSH-Verbindung, jedoch auf Kosten der Leistung.
    • Typ: Ganzzahl (Bits)
    • Standardwert: 8192
    mid.ssh.shells_supported
    Definiert die vom MID-Server unterstützten Bourne-kompatiblen Shells. Dieser Wert ist eine durch Kommas getrennte Liste unterstützter Shells, z. B. ksh, dsh, bash und sh.
    • Typ: Zeichenfolge
    • Standardwert: ksh, bash, sh
    mid.ssh.discard_lrc_error
    Fehlerausgabe für lang laufende Befehle verwerfen und das Verhalten von älteren Versionen emulieren.
    • Typ: Zeichenfolge
    • Standardwert: j2ssh - true, sncssh - false
    mid.ssh.pool_thread_ratio
    Verhältnis der Kapazität des SSH-Sitzungspools zur konfigurierten MID-Server-Thread-Anzahl (max. Threads), ausgedrückt in Prozent. Die Anzahl der zulässigen Poolkapazitätssitzungen wird in diesem Parameter festgelegt. Unabhängig von dem in diesem Parameter eingestellten Wert lässt das System niemals zu, dass die Poolkapazität 25 Sitzungen unterschreitet.
    • Typ: Ganzzahl
    • Standardwert: 150
    mid.ssh.disable_privilege_check
    Dieser Parameter hat keine Auswirkungen, wenn das Ziel einen anderen privilegierten Befehl als „sudo“ verwendet. Weitere Informationen finden Sie unter Privilegierte Befehle für MID-Server.

    Der Rest dieses Abschnitts gilt nur für Ziele, die sudo ausführen. Wenn dieser Parameter auf „true“festgelegt ist, geht der MID-Server davon aus, dass der in den Anmeldeinformationen konfigurierte Anwender berechtigt ist, den angegebenen Befehl mit sudo auszuführen. Der MID Server geht davon aus, dass der Zielbenutzer eine beliebige Befehlszeichenfolge nach „sudo“ auf dem Ziel ausführen kann. Wenn dieser Parameter auf „false“festgelegt ist, führt der MID-Server „sudo -l“ auf dem Ziel aus, um zu überprüfen, ob der auf sudo folgende Befehl zur Ausführung auf dem Ziel berechtigt ist. Unabhängig vom Wert dieses Parameters validiert der MID-Server immer, dass „sudo“ für sich selbst auf dem Ziel ausgeführt werden kann.

    Bei einigen Releases wird dieser Parameter nicht in der Pulldown-Liste der MID-Konfigurationsparameter angezeigt. In diesem Fall können Sie diesen Parameter optional in den MID-Eigenschaften hinzufügen.

    • Typ: Wahr | Falsch
    • Standardwert: falsch

    Aktualisierungsparameter

    mid.pinned.version
    Name der Version, an die dieser MID-Server angeheftet ist.
    • Typ: Zeichenfolge
    • Standardwert: MID-Buildstamp
      Hinweis:
      Um den MID-Buildstamp für Ihre Instanz anzuzeigen, geben Sie stats.do in den Navigationsfilter ein. Ein Beispiel für das Format buildstamp ist london-06-27-2018__patch3-10-24-2018_11-11-2018_0542.
    mid.upgrade.use_proxy
    Wenn Ihr MID-Server einen Web-Proxy für den Zugriff auf die Upgrade-URL durchlaufen muss, setzen Sie diesen Parameter auf true, um den MID-Server anzuweisen, den Proxy zu verwenden. Sie müssen auch den Host und den Port des Proxyservers einstellen. Wenn der Benutzername und das Passwort des Instanz-Proxys festgelegt sind, werden sie auch für den Upgrade-Proxy verwendet.
    Hinweis:
    Dieser Parameter ist nicht zur Steuerung von Proxy-Details vorgesehen, die mit den Parametern „glide.mid.autoupgrade.proxy*“ konfiguriert sind.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    glide.mid.autoupgrade.proxy_host oder glide.glidesoap.proxy_host
    Wenn Ihr MID-Server einen Web-Proxy durchlaufen muss, um auf die Upgrade-URL zuzugreifen, definieren Sie hier den Host des Proxys.
    • Typ: Zeichenfolge (URL)
    • Standardwert: keiner
    glide.mid.autoupgrade.proxy_port oder glide.glidesoap.proxy_port
    Wenn Ihr MID-Server einen Web-Proxy für den Zugriff auf die Upgrade-URL durchlaufen muss, definieren Sie hier den Port des Proxys.
    • Typ: Ganzzahl (0-65535)
    • Standardwert: 80
    glide.mid.autoupgrade.proxy_user
    Wenn Ihr MID-Server einen Web-Proxy für den Zugriff auf die Upgrade-URL durchlaufen muss, definieren Sie hier den Benutzernamen des Proxys.
    • Typ: Zeichenfolge (URL)
    • Standardwert: keiner
    glide.mid.autoupgrade.proxy_password
    Wenn Ihr MID-Server einen Web-Proxy durchlaufen muss, um auf die Upgrade-URL zuzugreifen, definieren Sie hier das Passwort des Proxys.
    • Typ: Zeichenfolge
    • Standardwert: keiner

    Windows Discovery-Parameter

    mid.powershell_api.session_pool.max_size

    Gibt die maximale Anzahl von Sitzungen an, die im Sitzungspool zulässig sind.

    Hinweis:
    Das Einstellen oder Ändern dieses Parameters erfordert einen Neustart des MID Servers.
    • Typ: Ganzzahl
    • Standardwert: 25
    mid.powershell_api.session_pool.target.max_size

    Gibt die maximale Anzahl von Sitzungen an, die im Pool pro Zielhost zulässig sind.

    Hinweis:
    Das Einstellen oder Ändern dieses Parameters erfordert einen Neustart des MID Servers.
    • Typ: Ganzzahl
    • Standardwert: 2
    mid.sa.prefer_powershell
    Aktiviert MID-Server, um PowerShell-Remoting zu verwenden.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.powershell_api.winrm.use_ssl
    Erfordert die Verwendung von SSL-Zertifikaten für HTTPS-Verbindungen mit WinRM.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.powershell_api.winrm.additional_pssesion_options
    Steuert die erweiterten Optionen für eine PSSession. Weitere Informationen zu erweiterten Optionen für eine PSSession finden Sie unter https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/new-pssessionoption?view=powershell-6.
    mid.powershell_api.winrm.remote_https_port
    Konfiguriert den Port für das Verbinden zu Windows-Servern mit PowerShell über HTTPS.
    • Typ: Ganzzahl
    • Standardwert: 5986
    mid.powershell_api.winrm.remote_port
    Konfiguriert den Port für das Verbinden zu Windows-Servern mit PowerShell über HTTP.
    • Typ: Ganzzahl
    • Standardwert: 5985
    mid.powershell_api.winrm.skip_ssl_cert_check
    Überspringt die Prüfung für das SSL-Zertifikat, wenn WinRM für HTTPS-Verbindungen verwendet wird.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.powershell_api.winrm.skip_ssl_cert_check_options
    Überspringt spezifische Prüfungen für SSL-Zertifikate, wenn WinRM für HTTPS-Verbindungen verwendet wird. Konfigurieren Sie MID-Server, um Prüfungen für Zertfifikate aus einer Certification Authority (CA) zu überspringen, aus dem Common Name (CN), der den mit dem Zertifikat verknüpften Host festlegt, und für widerrufene Zertifikate.
    • Typ: Zeichenfolge
    • Standardwert: -SkipCACheck -SkipCNCheck -SkipRevocationCheck
    mid.powershell.use_credentials
    Legt die Anmeldeinformationen fest, die Discovery mit PowerShell verwendet werden sollen. Die Einstellung wahr lässt MID-Server Proben ausführen mit den Windows Anmeldeinformationen aus der entsprechenden Tabelle. Um Proben mit den Anmeldeinformationen des Benutzers für den Service MID-Server auszuführen, stellen Sie diesen Parameter auf falsch ein.
    • Typ: true | false
    • Standardwert: true
    mid.powershell.path
    Ermöglicht es einem Administrator, auf eine bestimmte PowerShell auf einem MID-Server zu verweisen, wenn mehr als eine PowerShell installiert ist. Geben Sie den Pfad zum Ordner an, das die ausführbare PowerShell-Datei enthält, zum Beispiel C:\mypowershell oder C:\mypowershell \. ServiceNow hängt automatisch die Zeichenfolge „powershell.exe“ an den Pfad an. Konfigurieren Sie diesen Parameter, wenn sowohl 32-Bit- als auch 64-Bit-PowerShells auf demselben MID-Server aktiv sind und die richtige PowerShell für den Kontext gestartet werden muss. 64-Bit Windows verwendet die Dateisystemumleitung und der MID-Server wird als 32-Bit-Anwendung ausgeführt. Wenn ein Pfad in %WinDir%\System32 festgelegt werden soll, leitet Windows automatisch auf %WinDir%\SysWOW64 um. Geben Sie den Pfad als %WinDir%\Sysnative an, um eine Umleitung zu vermeiden. Legen Sie statt C:\WINDOWS\system32\WindowsPowerShell\v1.0\ zum Beispiel C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\ fest.
    Hinweis:
    Bei einer 64-Bit-Version von Windows XP kann ein MicrosoftMicrosoft Azure Event Hubs-Hotfix erforderlich sein, um diese Funktion zu aktivieren.

    Um Anwendungen zu finden, die auf einem 64-Bit-Windows-Computer ausgeführt werden, muss MID-Server auf einem 64-Bit-Windows-Host-Computer ausgeführt werden.

    • Typ: Zeichenfolge (Pfad)
    • Standardwert: keiner
    mid.powershell.enforce_utf8
    Aktivieren Sie diesen Parameter, um Befehle auf einem Windows-Zielsystem zu zwingen, die UTF-8-codierte Ausgabe zurückzugeben. Bei Deaktivierung kann das Zielsystem seine Standardcodierung verwenden. Dieser Parameter ist nur gültig, wenn PowerShell aktiviert ist.

    Das Festlegen dieses Werts auf „falsch“ führt möglicherweise zu falschen Werten in der CMDB, wenn Nicht-ASCII-Zeichen von einer Probe zurückgegeben werden.

    • Typ: true | false
    • Standardwert: true
    mid.powershell.local_mid_service_credential_fallback
    Aktiviert das automatische Zurückgreifen auf die Service-Anmeldeinformationen MID-Server, wenn alle anderen Anmeldeinformationen fehlschlagen.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.powershell_api.idle_session_timeout

    Gibt den Wert für den Timeout von PowerShell-Sitzungen im Leerlauf in Sekunden an.

    Hinweis:
    Das Einstellen oder Ändern dieses Parameters erfordert einen Neustart des MID-Server.
    • Typ: Ganzzahl
    • Standardwert: 60
    mid.powershell.command.parameter_passing
    Aktivieren Sie diesen Parameter, um die Übergabe von PowerShell-Parametern von der Befehlszeile aus zuzulassen.
    • Typ: Wahr | Falsch
    • Standardwert: falsch
    mid.powershell.command.script.parameter_passing
    Aktivieren Sie diesen Parameter, um die Übergabe von PowerShell-Skripts von der Befehlszeile aus zuzulassen.
    • Typ: Wahr | Falsch
    • Standardwert: wahr
    mid.windows.management_protocol

    Ermöglicht Administratoren die Auswahl des für die Geräte- und Prozessklassifizierung verwendeten Windows-Verwaltungsprotokolls. Optionen sind: WMI und WinRM.

    • Typ: Zeichenfolge
    • Standardwert: WMI
    mid.windows.probe_timeout
    Legt das Timeout-Intervall für alle Windows-Probes auf einem bestimmten MID Server fest. Dieser Wert wird von den Werten überschrieben, die für einzelne Probes mit dem Probe-Parameter „wmi_timeout“ konfiguriert wurden.
    • Typ: Ganzzahl
    • Standardwert: 300
    mid.powershell.jea.append_username
    Gibt an, ob der Anwendername des aktuellen Anwenders an den JEA-Endpunkt angehängt wird.
    • Typ: Wahr | Falsch
    • Standardwert: False
    mid.powershell.jea.endpunkt
    JEA-Konfigurationsname (Endpunkt) auf Remoteservern, mit denen der MID-Server eine Verbindung herstellt. Auf JEA_DISCO_BASIC festlegen.
    • Typ: Zeichenfolge
    • Standardwert: „“

    Fügen Sie einen MID-Server-Parameter hinzu

    Verwenden Sie einen MID-Server-Parameter, um das Verhalten eines bestimmten MID-Servers zu steuern.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > MID-Server > Server.
    2. Wählen Sie aus der Liste der MID-Server einen zu konfigurierenden MID-Server aus.
    3. Wählen Sie die zugehörige Liste Konfigurationsparameter aus.

      Hier werden alle Parameter angezeigt, die derzeit in der Konfigurationsdatei des MID-Servers enthalten sind. Wenn Passwörter vorhanden sind, werden diese aus Sicherheitsgründen in Sternchen angezeigt. Eine Liste der verfügbaren Parameter finden Sie unter MID-Server-Parameter.

      Abbildung : 1. MID-Serverkonfigurationsparameter definieren

      MID-Serverkonfigurationsparameter definieren
    4. Klicken Sie zum Hinzufügen von Parametern auf Neu und füllen Sie dann das Formular aus.
      Nachdem das Formular gesendet wurde, wird die Konfigurationsdatei für diesen MID-Server geändert, um den neuen Parameter aufzunehmen. Änderungen an vorhandenen Parametern werden auch in der MID-Server-Konfigurationsdatei angezeigt. Änderungen an der MID-Server-Konfigurationsdatei werden nicht sofort ausgeführt, sondern beim nächsten Neustart des MID-Servers. Das MID-Server-Formular enthält einen Link zum Neustarten des MID-Servers.
      Hinweis:
      ServiceNow verhindert, dass Sie Änderungen speichern, z. B. das Ändern oder Löschen von Parametern, durch die der MID-Server die Kommunikation mit der Instanz verliert. Beispielsweise können Sie den URL-Parameter nicht ändern. Alle Änderungen an diesen geschützten Parametern müssen direkt in der Datei „config. xml“ für diesen MID-Server vorgenommen werden.
    5. Wahlweise: Legen Sie Parameter in der Datei config. xml fest.
      Die Konfiguration des MID-Servers wird durch eine XML-Datei mit dem Namen config.xml gesteuert. Diese Datei befindet sich im Verzeichnis „/agent“ im Installationsverzeichnis des MID-Servers. Sie können diese Datei direkt bearbeiten, um Konfigurationsänderungen an geschützten Parametern vorzunehmen. Viele Konfigurationsänderungen, z. B. solche, die die Kommunikation zwischen dem MID-Server und der Instanz ServiceNow nicht beeinträchtigen können auch aus der Instanz gemacht werden.
      Die Struktur der Datei config.xml ist einfach ein äußeres Parameter-Tag und eine Reihe innerer Parameter-Tags. Jedes Parameter-Tag hat den Namen und die Value-Attribute.
      • Um den Wert eines Parameters zu ändern, bearbeiten Sie das Value-Attribut.
      • Um einen Parameter hinzuzufügen, fügen Sie ein weiteres Parametertag mit seinem Namen und Wert hinzu.
      • Um einen Parameter zu löschen, löschen Sie den gesamten Parameter-Tag.
      Die Reihenfolge der Parameter innerhalb der Datei ist nicht wichtig. Beachten Sie die grünen Kommentarbereiche im Beispiel. Verwenden Sie diese Elemente, um der Konfigurationsdatei nützliche Kommentare hinzuzufügen.
      Hinweis:
      Wenn Sie den MID-Server für die Verwendung mit einem Proxyserver konfigurieren, müssen Sie die Kommentartags um die von Ihnen konfigurierten Proxy-Abschnitte entfernen.
      Abbildung : 2. config.xml-Datei des MID Servers

      config.xml-Datei des MID Servers
      Hinweis:
      Die Beispieldatei hier stammt aus einem Firefox-Browser. Herkömmliche Texteditoren wie Notepad, WordPad oder TextEdit zeigen keine Farben und variablen Schriftarten an.