Paramètres requis

URL

Spécifie l’URL de l’instance associée. Normalement, l’URL est similaire à https://instance.service-now.com, où vous remplacez instance par le nom de l’instance. Si vous hébergez votre propre instance, utilisez l’URL définie par votre organisation.

• Type : chaîne
• Valeur par défaut : aucune

mid_sys_id

Enregistre l’identificateur unique de l’enregistrement du Serveur MID. Ce paramètre doit être vide lors de la configuration initiale d’un MID Server. Ne modifiez pas la valeur.

• Type : chaîne
• Valeur par défaut : défini automatiquement (GUID)

nom

Utilisez ce paramètre pour fournir un nom significatif pour vous. Si vous ne fournissez pas ce paramètre, le MID Server utilise la valeur par défaut. Un ensemble de règles métier synchronise le nom dans le fichier de configuration avec le nom dans l’enregistrement du MID Server. Les règles métier garantissent que la modification du nom d’un emplacement modifie également le nom de l’autre emplacement.

• Type : chaîne
• Valeur par défaut : YOUR_MIDSERVER_NAME_GOES_HERE

mid.instance.username ou glide.glidesoap.username

Si l’authentification est activée sur l’instance ServiceNow , comme c’est le cas par défaut, définissez ce paramètre pour définir le nom d’utilisateur que le MID Server doit utiliser pour se connecter à l’instance. Cet utilisateur doit avoir le rôle mid_server sur l’instance ServiceNow afin d’accéder aux tables et aux champs nécessaires. Vous pouvez utiliser ce paramètre pour définir les noms d’utilisateur avec des caractères spéciaux.

• Type : chaîne
• Valeur par défaut : aucune

mid.instance.password ou glide.glidesoap.password

Si l’authentification est activée sur votre instance ServiceNow, comme c’est le cas par défaut, définissez ce paramètre pour définir le mot de passe que le MID Server doit utiliser pour se connecter à l’instance. Vous pouvez utiliser ce paramètre pour définir des mots de passe avec des caractères spéciaux.

• Type : chaîne
• Valeur par défaut : aucune

Paramètres CIM

mid.cim.batch.size

Spécifie le nombre maximal de messages envoyés en une fois à un serveur CIM.

• Type : nombre entier
• Valeur par défaut : 1

mid.cim.request.interval

Spécifie le nombre de millisecondes à attendre entre les demandes adressées au même CIMOM (Common Information Model Object Manager).

• Type : nombre entier
• Valeur par défaut : 0

mid.cim.host.connection.limit

Spécifie le nombre maximal de connexions simultanées à chaque CIMOM. Une valeur de zéro désactive les connexions simultanées.

• Type : nombre entier
• Valeur par défaut : 0

Paramètres de connexion

glide.mid.réponses.rapides

Indique au MID Server d’essayer d’envoyer des messages à l’instance dès qu’ils sont prêts. Normalement, les MID Servers terminent les messages à l’instance ServiceNow en série (c’est-à-dire un message à la fois). Étant donné que de nombreuses sondes peuvent être exécutées en parallèle, plusieurs messages peuvent être transmis simultanément à l’instance. Définir ce paramètre sur vrai peut réduire le délai entre l’achèvement d’une sonde et l’obtention de sa réponse à l’instance. Toutefois, les multiples messages simultanés consomment des ressources, ce qui réduit la réactivité globale de l’instance. En cas de problèmes de communication, la valeur de ce paramètre peut également provoquer un embouteillage sur le MID Server, car les threads normalement utilisés pour l’exécution de sondes peuvent être utilisés pour l’envoi de messages. En règle générale, laissez ce paramètre en dehors de votre configuration. L’établir comme vrai n’a de sens que dans des circonstances très particulières.

• Type : true | false
• Valeur par défaut : false

glide.mid.max.sender.queue.size

Impose une limite supérieure à la taille autorisée de la file d’attente. Le MID Server commence à supprimer les messages de la file d’attente si cette limite est dépassée. Lorsque le MID Server génère des messages vers l’instance ServiceNow plus rapidement qu’il ne peut les envoyer, il les met temporairement en file d’attente sur le système de fichiers de l’hôte du MID Server. Cette file d’attente est normalement assez petite et est complètement vidée dès que le traitement du MID Server ralentit pendant une courte période. Toutefois, cette file d’attente peut augmenter en taille en cas de problèmes de communication entre le MID Server et l’instance, notamment si une intégration est en cours d’exécution sur le MID Server.

Le paramètre est de la forme {number}{multiplier}, où {number} est n’importe quel nombre décimal positif, y compris les nombres non entiers, et le multiplicateur facultatif est n’importe quelle orthographe d’octets, de kilo-octets, de méga-octets, de gigaoctets ou de téraoctets (seul le premier caractère est testé et le test n’est pas sensible à la casse). Le multiplicateur par défaut est en octets. L’espace blanc est largement toléré. Les chaînes suivantes représentent toutes des paramètres valides : « 1000000000 », « 0.5m », « 5 GB », « 7.67gigas », « 145.69392 meg » et « 1.1 terra ».

• Type : chaîne
• Valeur par défaut : 0,5 Go

instance.date.format

Spécifie le format que l’instance utilise pour les dates et les heures. Le principal impact de la définition de ce paramètre est de permettre au MID Server d’actualiser correctement ses heures de début et de fin sur l’enregistrement du MID Server dans ServiceNow. Le format de cette chaîne de date/heure est identique à celui utilisé par la classe Java SimpleDateFormat.

• Type : chaîne (format Date)
• Valeur par défaut : aaaa-MM-jj HH :mm :ss

mid.disable_amb

Désactive les notifications AMB (Asynchronous Message Bus) pour les nouveaux messages de sortie de file d’attente ECC. Pour plus d’informations, consultez la section Bus de messages asynchrone dansBus de messages asynchrone. Lorsque AMB est activé, le MID Server utilise un intervalle d’interrogation par défaut différent de celui lorsque AMB est désactivé. Pour plus d’informations, consultez le paramètre mid.poll.time . Si vous définissez un intervalle d’interrogation avec le paramètre mid.poll.time , le MID Server utilise cette valeur, que le client AMB soit activé ou non.

• Type : true | false
• Valeur par défaut : false

mid.https.truststore.password

Définit le mot de passe TrustStore requis pour les connexions HTTPS avec le client AMB (Asynchronous Message Bus).

• Type : chaîne
• Valeur par défaut : aucune

mid.https.truststore.path

Chemin d’accès au trustStore à utiliser par le MID Server pour les transactions TLS (client AMB) Asynchronous Message Bus). Ajoutez ce paramètre uniquement si vous souhaitez modifier le chemin d’accès par défaut.

• Type : chaîne
• Par défaut : chemin d’accès au trustStore JRE groupé avec le MID Server

mid.instance.skip_basic_auth

Permet au MID Server de se connecter à une instance à l’aide de cookies au lieu d’informations d’identification d’authentification de base. Lorsqu’elle est définie sur vrai, elle utilise d’abord des cookies. Toutefois, en cas d’échec de la connexion, le MID Server tentera de se connecter à nouveau à l’aide des informations d’identification d’authentification de base.

• Type : true | false
• Valeur par défaut : true

mid.jmx.enabled

Active un serveur JMX sur le MID Server, ce qui expose certaines informations de gestion aux consoles JMX. L’implémentation de JMX nécessite une configuration supplémentaire de l’environnement d’exécution Java. La définition de ce paramètre sur true est uniquement recommandée pour les utilisateurs ayant une connaissance approfondie de l’architecture de sécurité Java et ayant un besoin spécifique de JMX.

• Type : true | false
• Valeur par défaut : false

heure.sondage.moyenne

Définit l’intervalle d’interrogation par défaut du MID Server (en secondes). L’intervalle d’interrogation est la durée pendant laquelle le MID Server attend avant de vérifier si la file d’attente ECC a du travail lorsqu’il n’est pas occupé. Pour plus d’informations, consultez la section Bus de messages asynchrone dans.

Lorsque mid.disable.amb est défini sur false (le paramètre par défaut), consultez la section Bus de messages asynchrones dans Bus de messages asynchrone pour plus d’informations sur l’utilisation de mid.poll.time .

Lorsque mid.disable.amb est défini sur vrai, l’interrogation se produit selon un intervalle mid.poll.time fixe, mais l’interrogation bascule sur mid.poll.time.standard (5 secondes par défaut) lorsque le MID Server est occupé.

• Type : nombre entier (secondes)
• Valeur par défaut : 40 lorsque mid.disable.amb est faux ou 5 lorsque mid.disable.amb est vrai.

mid.sonde.attendre.ressources

Indique si l’exécution de la sonde est retardée jusqu’à ce que les ressources soient disponibles. Utilisé pour activer la réservation de ressources du Serveur MID.

Remarque :

Nécessite le redémarrage du MID Server.

• Type : true | false
• Valeur par défaut : true

mid.property.long_runner

Identifie le nom d’un script include qui gère les commandes de longue durée.

Remarque :

Cette propriété est applicable jusqu’à la Rome version uniquement. Si votre instance dispose d’une version ultérieure, vous devez configurer la propriété système, glide.eccprobe.longrunner.class.

• Type : chaîne
• Valeur par défaut : LongRunner

threads.interactive.max

Définit le nombre maximal de threads d’agent interactif qui peuvent s’exécuter simultanément dans le pool de threads interactifs. Reportez-vous à la section Définir l’utilisation des threads du MID Server.

• Type : nombre entier
• Valeur par défaut : 10

threads.expedited.max

Définit le nombre maximal de threads de travail accélérés qui peuvent s’exécuter simultanément dans le pool de threads accéléré. Reportez-vous à la section Définir l’utilisation des threads du MID Server.

• Type : nombre entier
• Valeur par défaut : 20

threads.max

Définit le nombre maximal de threads de travail standard qui peuvent s’exécuter simultanément dans le pool de threads standard. Ce paramètre fournit un contrôle direct sur les ressources de processeur consommées par le MID Server sur l’ordinateur qui l’héberge. Reportez-vous à la section Définir l’utilisation des threads du MID Server.

• Type : nombre entier
• Valeur par défaut : 25

Important :

Vous pouvez définir le paramètre threads.max jusqu'à 200, cependant, le système d'exploitation peut exiger sa modification. Par exemple, les MID Servers basés sur Windows exécutant Discovery utilisent Powershell, qui nécessite beaucoup de ressources. Dans ce cas, vous pourriez épuiser la puissance du processeur de l'ordinateur hôte avec seulement 50 threads.

Paramètres d’informations d’identification

mid.aws.instance_profile_name

Nom du rôle AWS IAM configuré sur l’instance EC2. Lorsqu’il est configuré, le MID Server utilise les informations d’identification temporaires accordées à ce rôle par le profil d’instance AWS pour détecter les ressources dans le cloud.

• Type : chaîne
• Valeur par défaut : aucune (l’utilisateur doit fournir une valeur non vide)

mid.informations d’identification.fournisseur

Spécifie le nom de classe Java du fournisseur d’informations d’identification.

• Type : chaîne
• Valeur par défaut : com.service_now.mid.creds.standard.StandardCredentialsProvider

mid.secure_credentials.key pairs.provider

Classe que le MID Server utilise pour générer des paires de clés sécurisées.

• Type : chaîne
• Valeur par défaut : com.service_now.mid.keypairs.provider.standard.StandardKeyPairsProvider

Paramètres de débogage

debug.logging

[Déconseillé] Spécifie s’il faut activer la consignation des événements et des messages du Serveur MID (envoyés et reçus). Normalement, ce paramètre n’est utilisé que par les développeurs, mais il est parfois utile lors du dépannage d’un problème. Sachez que la définition de ce paramètre sur true entraîne une journalisation intensive sur le MID Server et peut utiliser un espace disque considérable.

• Type : true | false
• Valeur par défaut : false

Ce paramètre a été remplacé par le mid.log.level paramètre.

déboguer

[Déconseillé] Spécifie s’il faut activer la journalisation de débogage sur le MID Server. Normalement, ce paramètre n’est utilisé que par les développeurs, mais il est parfois utile lors du dépannage d’un problème. Sachez que la définition de ce paramètre sur true entraîne une journalisation intensive sur le MID Server et peut utiliser un espace disque considérable.

• Type : true | false
• Valeur par défaut : false

Ce paramètre a été remplacé par le mid.log.level paramètre.

fichier.sonde.modèle.debug

Spécifie s’il faut déboguer les modèles de sonde de fichier.

• Type : true | false
• Valeur par défaut : false

mid.cim.debug

Spécifie s’il faut activer la journalisation de débogage pour CIM, WBEM, SLP ou SMI-S.

• Type : true | false
• Valeur par défaut : false

mid.ssh.debug

Active les informations de débogage SSH dans le fichier journal. Ce paramètre est utilisé selon que le client SSH ServiceNow est activé ou non.

Lorsque le ServiceNow client SSH est activé, le paramètre fonctionne comme suit :

• Type : chaîne
• Valeur par défaut : false

  Les valeurs de chaîne suivantes sont valides pour le client SSH ServiceNow :

  • vrai : active les informations de débogage SSH dans le fichier journal.
  • faux : désactive les informations de débogage SSH dans le fichier journal.
  • <Adresses IP> : spécifiez les plages IP pour activer les informations de débogage SSH dans le fichier journal. Vous pouvez saisir les adresses IP aux formats suivants :
    • Une plage d'adresses IP définie par une barre oblique et le nombre de bits dans le sous-réseau. Par exemple, la chaîne 10.10.10.0/24 analyse les adresses IP 24 bits de la plage comprise entre 10.10.10.0 et 10.10.10.254.
    • Une plage d'adresses IP définie par un tiret. Par exemple, la chaîne 10.10.11.0-10.10.11.165 analyse les adresses IP de la plage comprise entre 10.10.11.0 et 10.10.11.165.
    • Une liste d'adresses IP spécifiques, séparée par des virgules. Par exemple, la chaîne 10.10.11.200,10.10.11.235 analyse les adresses IP 10.10.11.200 et 10.10.11.235.
  • différé : consigne les informations de débogage SSH dans la mémoire, sauf en cas d’erreur ou d’avertissement. Si une erreur ou un avertissement se produit, la plateforme publie les informations de débogage dans le fichier journal. Ainsi, seule la partie du fichier journal relative à l'erreur ou à l'avertissement est enregistrée. Si aucune erreur ou aucun avertissement n'est détecté, la plateforme supprime les données de journal inutilisées de la mémoire lorsque la session se ferme. Chaque session stocke jusqu'à 1 000 messages de journal. Si la session dépasse 1 000 messages de journal, le journal différé ignore le message de journal le plus ancien pour faire place au message de journal le plus récent.

Lorsque le ServiceNow client SSH est désactivé, le paramètre active ou désactive les informations de débogage SSH dans le fichier journal :

• Type : true | false
• Valeur par défaut : false

Remarque :

Le paramètre mid.ssh.debug du MID Server affecte uniquement SNCSSH et J2SSH. Pour activer la journalisation de débogage du client Maverick, définissez le paramètre de configuration du MID Server mid.log.level sur debug, com.maverick=debug.

mid.log.level

Spécifie le niveau de journalisation du MID Server. Les valeurs possibles sont les suivantes :

• déboguer
• info
• avertir
• erreur

Remarque :

Les valeurs ne sont pas sensibles à la casse.

• Type : chaîne
• Valeur par défaut : info

mid.http.idle_connection_monitor.debug

Active la journalisation de débogage pour le moniteur de connexion inactif.

• Type : true | false
• Valeur par défaut : false

Paramètres DNS

mid.dns_scan.régulateur.intervalle_ms

Spécifie l’intervalle entre les analyses DNS, en millisecondes.

• Type : nombre entier
• Valeur par défaut : 10

mid.dns_scan.regulator.packets_per_interval

Spécifie le nombre de paquets de régulateur par analyse DNS.

• Type : nombre entier
• Valeur par défaut : 1

mid.dns_scan.serveurs_nom_défaut

Spécifie les noms d’hôte ou les adresses IP des serveurs de noms par défaut.

• Type : chaîne
• Valeur par défaut : aucune

mid.dns_scan.serveurs_nom_défaut

Spécifie les noms d’hôte ou les adresses IP des serveurs de noms par défaut.

• Type : chaîne
• Valeur par défaut : aucune

mid.dns_scan.serveurs_nom_supplémentaires

Spécifie les noms d’hôte ou les adresses IP de tous les serveurs de noms supplémentaires.

• Type : chaîne
• Valeur par défaut : aucune

mid.dns_scan.load_balancing_enable

Indique s’il faut activer l’équilibrage de charge des serveurs de noms.

• Type : true | false
• Valeur par défaut : false

mid.probe.use_legacy_forward_dns

Active la sonde DNSNameResolver héritée et désactive la sonde DNSNameResolver par défaut. Consultez Sondes utilisées par Orchestration pour plus d'informations.

• Type : true | false
• Valeur par défaut : false

mid.probe.use_legacy_reverse_dns

Active la sonde DNS héritée et désactive la sonde DNS par défaut. Si vous rencontrez des problèmes avec les fonctionnalités de la sonde DNS par défaut, utilisez ce paramètre pour les désactiver. Les caractéristiques de la sonde DNS par défaut incluent sa légèreté et sa rapidité en raison de l’exécution en parallèle, tandis que la sonde héritée est limitée par le MID Server, car elle s’exécute en série. La sonde par défaut utilise la recherche DNS par le système d’exploitation hôte du MID Server pour utiliser le cache DNS géré par le système d’exploitation, ce qui n’est pas le cas de la sonde héritée. Par conséquent, après l’échec d’une recherche DNS par la sonde par défaut dans les systèmes Windows, le système d’exploitation essaie également d’effectuer une recherche par nom NETBIOS.

• Type : true | false
• Valeur par défaut : false

Paramètres Event Management

mid.probe.event.bulk_size

Spécifie la taille maximale de la charge utile d’un événement, en Mo.

• Type : nombre entier
• Valeur par défaut : 120

mid.probe.event.wait_time

Période d’attente sur une file d’attente vide pour l’envoi d’événements.

• Type : nombre entier
• Valeur par défaut : 1 000

mid.probe.event.send.enabled

Active ou désactive l’envoi d’événements.

• Type : true | false
• Valeur par défaut : true

mid.probe.event.queue.max_taille

Spécifie la taille maximale autorisée pour la file d’attente d’événements avant le rejet des événements entrants.

• Type : nombre entier
• Valeur par défaut : 100 000

mid.probe.event.max.retry_time

Durée maximale en secondes pendant laquelle le MID tente à nouveau d’envoyer des événements.

• Type : nombre entier
• Par défaut : 1 800

mid.probe.event.queue.use_bulk

Spécifie si les événements sont envoyés au serveur individuellement ou en bloc. Si ce paramètre est défini sur true , les événements sont envoyés au serveur en bloc.

• Type : true | false
• Valeur par défaut : true

mid.probe.event.suppress.whitespaces

Autorise les sauts de ligne dans les champs de description pour les événements multilignes. Appliquez ce paramètre à chaque MID Server utilisé avec les instances de connecteur d’événement. Les choix possibles sont les suivants :

tous

Ce paramètre supprime tous les espaces.

leave_as_is

Ce paramètre conserve tous les espaces blancs.

keep_newline

Ce paramètre ne conserve que new_line et supprime tous les autres espaces.

• Type : chaîne
• Valeur par défaut : toutes

mid.em.metric.metric_to_ci_map_limit

Spécifie le nombre maximal de mesures actives autorisées par carte de CI.

• Type : nombre entier
• Valeur par défaut : 200 000

mid.em.metric_binding_timeout_seconds

Spécifie le nombre de secondes à attendre avant de renvoyer les événements non gérés

• Type : nombre entier
• Valeur par défaut : 300

mid.em.metric_binding_timeout_max_seconds

Spécifie le nombre maximal de secondes à attendre avant de renvoyer les événements non gérés.

• Type : nombre entier
• Valeur par défaut : 10 800

mid.em.metric_max_elapsed_time_before_refresh

Spécifie le nombre maximal de secondes avant que le cache du type de source de mesure ne soit actualisé en mémoire.

• Type : nombre entier
• Valeur par défaut : 60

mid.em.matric_max_sql_string_length_for_types

Spécifie la longueur maximale de la chaîne (composée de types) utilisée pour une commande SQL

• Type : nombre entier
• Valeur par défaut : 30 000

mid.em.statistics_report_perioon_sec

Spécifie la période, en secondes, entre les rapports statistiques sur l’instance. Utilisez la valeur 0 pour désactiver la génération de rapports. Ce paramètre nécessite un redémarrage.

• Type : nombre entier
• Valeur par défaut : 60

mid.em.metric_connector_max_run_time_seconds

Spécifie le nombre maximal de secondes pour collecter des mesures dans chaque cycle.

• Type : nombre entier
• Valeur par défaut : 300

mid.em.metric_connector_history_min

Spécifie le nombre de minutes à revenir en arrière dans l’historique pour récupérer les mesures.

• Type : nombre entier
• Valeur par défaut : 180

mid.em.metric_event_logging

Spécifie le niveau de journalisation des mesures et des événements. Les choix possibles sont les suivants :

• aucun
• tous
• Événements
• metrics
• mesures :<filtre>
• événements :<filtre>

• Type : chaîne
• Valeur par défaut : aucune

mid.em.metric_connector_late_arrivals_delay

Spécifie le nombre de secondes à retarder lors de la collecte des mesures.

• Type : nombre entier
• Valeur par défaut : 30

Paramètres de connexion FTP

mid.ftp.max_taille_pool

Spécifie la taille maximale du pool de connexions FTP, en mégaoctets.

• Type : nombre entier
• Valeur par défaut : 25

mid.ftp.max_par_cible

Spécifie le nombre maximal de connexions FTP par cible.

• Type : nombre entier
• Valeur par défaut : 5

mid.ftp.max_conn_idle_time

Spécifie la durée maximale, en millisecondes, pendant laquelle une connexion FTP peut rester inactive dans le pool.

• Type : nombre entier
• Valeur par défaut : 300 000

mid.filesystem.max.ls

Spécifie le nombre maximal de fichiers pouvant être renvoyés dans la commande répertoire de liste de systèmes de fichiers.

• Type : nombre entier
• Valeur par défaut : 10 000

Paramètres de journalisation

disable_monitors

Spécifie s’il faut désactiver la recherche active des moniteurs sur l’instance par le MID Server.

• Type : true | false
• Valeur par défaut : true

mid.show.queries

Indique au MID Server s’il doit consigner les détails de chaque requête qu’il effectue dans l’instance ServiceNow. En règle générale, ce paramètre n’est utilisé que par les développeurs, mais il est parfois utile lors du dépannage d’un problème. Sachez que la définition de ce paramètre sur true entraîne une journalisation intensive sur le MID Server et peut utiliser un espace disque considérable.

• Type : true | false
• Valeur par défaut : false

désactiver.remote.logging

Empêche le MID Server de consigner des informations dans le journal du MID Server sur l’instance. Dans tous les cas, relativement peu d’informations sont journalisées sur l’instance, mais la définition de ce paramètre sur vrai élimine toute journalisation dans l’instance.

• Type : true | false
• Valeur par défaut : false

Désactiver.État

Empêche le MID Server d’envoyer un rapport d’état à l’instance toutes les 10 minutes.

• Type : true | false
• Valeur par défaut : false

mid.file_cleaner.désactivé

Les fichiers et les dossiers vides dans les dossiers suivants peuvent être supprimés par ce nettoyeur de fichiers MID. Les fichiers ayant fait l’objet d’un dernier accès il y a plus de 30 jours sont supprimés. Il fonctionne au démarrage, puis toutes les 24 heures par la suite. Vous pouvez forcer l’exécution du nettoyeur de fichiers en redémarrant le service MID Server.

Dossiers/fichiers nettoyés :

• \agent\import
• \agent\export : utilisé par la fonctionnalité Exporter un jeu de données.
• \agent\work\monitors\ECCSender\output_error : utilisé pour les charges utiles d’entrée ECC qui ne peuvent pas être insérées pour une raison quelconque
• \agent\work\monitors\ECCSender\output_oversize : utilisé pour enregistrer des copies des charges utiles qui ne sont pas envoyées à l’instance, car elles sont supérieures à la limite définie par mid.eccq.max_payload_size, qui est de 20 00 000 octets par défaut.
• \agent\logs- Plus précisément les dumps JFR

• Type : true | false
• Valeur par défaut : false

Paramètres de modèle

mid.parsing.max_taille_champ

Définit la longueur maximale de caractères des chaînes stockées en tant que variables temporaires lors de l’exécution de modèles. Les chaînes supérieures à la valeur de ce paramètre sont tronquées pour correspondre à la valeur. Utilisez ce paramètre pour augmenter la limite lors de l’analyse de chaînes plus longues.

Avertissement :

Le dépassement des limites maximales de taille de champ de l’implémentation de la base de données SQL entraîne des erreurs.

• Type : nombre entier
• Valeur par défaut : 1 024

mid.sa.discovery.pattern_string_attributes.dédupliquer

Réduit la consommation de mémoire pour les attributs de contexte d’exécution de modèle en éliminant les chaînes en double.

• Type : true | false
• Valeur par défaut : true

Paramètres du serveur proxy

Paramètres de remplacement du délai d’expiration de la demande

mid.sa.cloud.request_timeout

Définit le délai d’expiration, en millisecondes, des demandes dans le cloud. Ce paramètre remplace la propriété système glide.http.timeout , qui spécifie le nombre maximal de millisecondes à attendre avant qu’une transaction REST sortante n’expire.

• Type : nombre entier
• Valeur par défaut : 30 000

mid.http_classy.request_timeout

Définit le délai d’expiration, en millisecondes, des demandes de classification HTTP avec la sonde HTTP : classifier. Ce paramètre remplace la propriété système glide.http.timeout , qui spécifie le nombre maximal de millisecondes à attendre avant qu’une transaction sortante n’expire.

• Type : nombre entier
• Valeur par défaut : 30 000

Paramètres de sécurité

mid.windows_host.file_permissions.allow_list

Définit une liste d’inclusion pour l’application des autorisations de fichiers Windows afin d’améliorer la sécurité. Le paramètre prend une chaîne de noms de groupe, de noms d’utilisateur et de SID séparés par des virgules. Les noms de groupe et d’utilisateur doivent respecter les exigences de dénomination des comptes SAM. Les comptes de domaine peuvent être spécifiés à l’aide du SID.

• Type : chaîne (noms de groupe et d’utilisateur séparés par des virgules)
• Valeur par défaut : Aucun

mid.windows_host.file_permissions.enforce

Permet au MID Server d’utiliser l’application des autorisations de fichiers Windows pour améliorer la sécurité. La définition de ce paramètre sur faux empêche le MID Server de mettre à jour la liste d’inclusion des autorisations de fichier, mais ne rétablit pas les autorisations de fichier.

• Type : true | false
• Valeur par défaut : true

Paramètres Shazzam

mid.shazzam.regulator.interval_ms

Définit l’intervalle, en millisecondes, pendant lequel Shazzam peut lancer des paquets. Ce paramètre fonctionne avec le mid.shazzam.regulator.packets_per_interval paramètre permettant de définir le nombre de paquets autorisés dans cet intervalle. Par défaut, Shazzam lance un paquet toutes les millisecondes.

• Type : nombre entier
• Valeur par défaut : 1

mid.shazzam.regulator.packets_per_interval

Définit le nombre de paquets que Shazzam peut lancer dans l’intervalle de temps configuré. Ce paramètre fonctionne avec le mid.shazzam.regulator.interval_ms paramètre, qui définit cet intervalle. Par défaut, Shazzam lance un paquet toutes les millisecondes.

• Type : nombre entier
• Valeur par défaut : 1

mid.shazzam.chunk_size

Spécifie le nombre maximal d’adresses IP que Shazzam analyse en parallèle. Ce paramètre contrôle principalement la consommation de ports sortants.

• Type : nombre entier
• Valeur par défaut : 100

mid.shazzam.threads

Spécifie le nombre de threads simultanés que Shazzam utilise. Définir ce paramètre ou le paramètre mid.shazzam.max_scanners_per_thread sur 0 désactive l’optimisation multithread Shazzam.

• Type : nombre entier
• Valeur par défaut : 5

mid.shazzam.max_scanners_per_thread

Spécifie le nombre d’analyseurs simultanés traités par chaque thread Shazzam. Définir ce paramètre ou le paramètre mid.shazzam.threads sur 0 désactive l’optimisation multithread Shazzam.

• Type : nombre entier
• Valeur par défaut : 500

Paramètres de configuration SNMP

mid.snmp.enable_auto_public

Spécifie s’il faut utiliser automatiquement la chaîne de communauté publique SNMP si aucune autre information d’identification SNMP n’a réussi.

• Type : true | false
• Valeur par défaut : true

mid.snmp.request.timeout

Spécifie la valeur du délai d’expiration de la première demande OID, en millisecondes. Pour les demandes suivantes (par exemple, les OID de table), le mid.snmp.session.timeout configuration paramètre (voir ci-dessous) prend effet.

Remarque :

Vous pouvez remplacer ce paramètre par le paramètre de timeout sonde SNMP.

• Type : nombre entier
• Valeur par défaut : 1 500

mid.snmp.session.timeout

Spécifie la valeur du délai d’expiration de la demande OID suivante, en millisecondes. La communication SNMP est sans état et n’a pas de session ou de connexion au sens normal du terme. Le système considère qu’une réponse positive à la première demande d’OID est un signe qu’il doit s’attendre à des réponses rapides aux demandes suivantes. Bien que la valeur par défaut soit courte, il peut être utile d’augmenter cette valeur de paramètre à la même valeur que celle utilisée pour mid.snmp.request.timeout.

Remarque :

Vous pouvez remplacer ce paramètre par le paramètre de establish_session_timeout sonde SNMP.

• Type : nombre entier
• Valeur par défaut : 500

mid.snmp.use_getbulk

Indique s’il faut utiliser GETBULK pour recevoir une grande quantité de données par lots. Cela peut être utilisé pour configurer un MID Server individuel.

• Type : true | false
• Valeur par défaut : true

La demande GETBULK peut également être définie au niveau de la sonde ou globalement pour tous les MID Servers. Les paramètres sont répertoriés par ordre de priorité :

• Paramètre de la sonde SNMP
• Paramètre de configuration du MID Server
• Propriétés du MID Server

mid.snmp.use_snmp4j

Utilisez la bibliothèque Snmp4j pour la communication SNMP. Il s’agit d’une exigence stricte pour SNMPv3. Ce paramètre ne doit être défini sur faux que sur la base des conseils de Service et assistance client.

• Type : true | false
• Valeur par défaut : true

mid.snmp.use_snmp_v1_v2c

Utilisez la bibliothèque Snmp4j pour la communication SNMP. Il s’agit d’une exigence stricte pour SNMPv3. Ce paramètre ne doit être défini sur faux que sur la base des conseils de Service et assistance client.

• Type : true | false
• Valeur par défaut : true

mid.snmp.use_snmp_v3

Tentative de communication à l’aide de la version du protocole SNMPv3. Nécessite la configuration des informations d’identification SNMPv3.

• Type : true | false
• Valeur par défaut : true

Paramètres SSH Discovery

mid.connection_cache

Spécifie si les connexions doivent être mises en cache. Définissez la valeur sur faux pour désactiver la mise en cache de la connexion. Ce paramètre s’applique uniquement aux connexions SSH.

• Type : true | false
• Valeur par défaut : true

mid.ssh.set_path

Indique s’il faut définir la variable d’environnement PATH pour les commandes SSH.

• Type : true | false
• Valeur par défaut : true

mid.ssh.local

Spécifie s’il faut exécuter des commandes pour l’ordinateur hôte du MID Server (localhost) via SSH plutôt qu’à partir d’une console. Cela permet aux commandes de longue durée de s’exécuter correctement. Ce paramètre s’applique uniquement au client SSH hérité.

• Type : true | false
• Valeur par défaut : false

mid.ssh_connections_per_host

Contrôle le nombre de sondes simultanées que le MID Server peut exécuter sur un hôte donné. La réduction du nombre de connexions simultanées peut ralentir Détection.

• Type : nombre entier
• Valeur par défaut :

  7 pour le ServiceNow client

  3 pour le client SSH hérité.

mid.ssh.sudo_preserve_environment

Indique s'il est nécessaire d'utiliser sudo pour préserver l'environnement pour SSH.

• Type : true | false
• Valeur par défaut : false

largeur mid.ssh.terminal.width

Contrôle le nombre maximal de caractères par ligne lors de la manipulation de sudo -l dans le terminal. Si la valeur est trop faible, la sortie peut être divisée en plusieurs lignes et affecter l’analyseur. Définissez la valeur sur une taille suffisante pour gérer les sorties selon les besoins.

• Type : int
• Valeur par défaut : 255

mid.ssh.path_override

Remplace les chemins d'accès par défaut définis avant d'exécuter une commande. Entrez un ou plusieurs chemins de remplacement délimités par un deux-points (:). Le chemin d'accès par défaut est le suivant : /usr/sbin: /usr/bin: /bin: /sbin.

• Type : chaîne (liste de répertoires séparés par deux points)
• Valeur par défaut : Aucun

Le ServiceNow client SSH accepte les préfixes suivants devant la valeur path_overide.

• append: ajoute le chemin de remplacement à la fin du chemin d’accès de l’hôte. Il s'agit du comportement par défaut.
• replace: remplace le chemin d’accès de l’hôte par la valeur path_overide.
• prepend: ajoute le chemin de remplacement devant le chemin d’accès de l’hôte.

mid.ssh.use_snc

Active le ServiceNow client SSH (SNCSSH) sur des MID Servers individuels. SNCSSH est une ServiceNow implémentation d’un client SSH et est actif par défaut pour tous les MID Servers sur les nouvelles instances, via une propriété de MID Server. L’activation du ServiceNow client SSH désactive le client J2SSH hérité.

Important :

Il n’est pas recommandé de mélanger les types de clients SSH pour les MID Servers connectés à la même instance.

• Type : true | false
• Valeur par défaut : false

mid.ssh.max_retries

Spécifie le nombre maximal de nouvelles tentatives d’une opération SSH après un délai d’expiration. Le système se met en veille pendant deux secondes entre chaque tentative de connexion. Par défaut, le MID Server effectue une seule tentative. Définissez le paramètre sur 0 pour désactiver les nouvelles tentatives.

• Type : nombre entier
• Valeur par défaut : 1

mid.ssh.alt_rm

Définit une autre commande SSH remove file.

• Type : chaîne
• Valeur par défaut : aucune

mid.ssh.initial_delay_ms

Retarde l’envoi de toute commande de sonde SSH à un serveur après la connexion à la cible pendant la durée spécifiée, en millisecondes. Ce paramètre s’applique uniquement au client SSH hérité.

• Type : nombre entier (millisecondes)
• Valeur par défaut : 0

mid.ssh.suppress_history

Supprime la génération du fichier d’historique SSH. Ce paramètre s’applique uniquement au client SSH hérité.

• Type : true | false
• Valeur par défaut : false

mid.ssh.socket_timeout

Spécifie la valeur de délai d’expiration du socket SSH pour éviter les problèmes créés par un délai d’expiration de socket. Certains appareils, tels que les systèmes dotés de contrôleurs intégrés tels que les onduleurs et les PDU, pour lesquels SSH est activé mettent plus de temps à répondre à une demande d’authentification. La valeur par défaut de 2 minutes garantit que ces demandes n’expirent pas prématurément.

• Type : nombre entier (millisecondes)
• Valeur par défaut : 120 000 (2 minutes)

mid.ssh.channel_timeout

Spécifie la durée pendant laquelle le MID Server attend l’activité sur le socket SSH avant de fermer la connexion. S’il n’y a eu aucune activité sur le socket SSH pour la valeur de délai spécifiée, le MID Server ferme la connexion. Certains appareils, tels que les systèmes dotés de contrôleurs intégrés tels que les onduleurs et les PDU, sur lesquels SSH est activé peuvent nécessiter plus de temps pour répondre à une demande d’authentification.

• Type : nombre entier (millisecondes)
• Valeur par défaut : 120 000 (2 minutes)

mid.ssh.session_timeout

Spécifie la durée pendant laquelle une session mise en cache reste en mémoire après la dernière utilisation. Des valeurs trop faibles ont tendance à diminuer les performances. Ce paramètre s’applique ServiceNow uniquement au client SSH.

• Type : nombre entier (millisecondes)
• Valeur par défaut : 300 000 (5 minutes)

mid.ssh.command_timeout_ms

Durée du délai d’expiration, en millisecondes, pour l’exécution d’une commande SSH.

• Type : nombre entier (millisecondes)
• Valeur par défaut : 300 000 (5 minutes)

mid.ssh.use_keyboard_interactive

Utilise le mode d’authentification interactif du clavier dans les démons SSH sur lesquels il est activé.

• Type : true | false
• Valeur par défaut : false

Avertissement :

Il existe un problème dans Mac OS X Sierra et versions ultérieures avec l’ordre d’authentification des modes mot de passe et clavier-interactifqui peut entraîner l’échec de la détection. Pour plus d’informations sur ce problème et la configuration requise pour une authentification SSH correcte, consultez KB0623600.

mid.ssh.dh_group_length_min

Spécifie la longueur minimale du groupe en bits utilisée pour générer une clé « secret partagé » dans l’échange de clés Diffie-Hillman. Plus la clé est grande, plus la connexion SSH est sécurisée, mais au détriment des performances.

• Type : nombre entier (bits)
• Valeur par défaut : 1 024

mid.ssh.dh_group_length_max

Spécifie la longueur maximale du groupe en bits utilisée pour générer une clé « secret partagé » dans l’échange de clés Diffie-Hillman. Plus la clé est grande, plus la connexion SSH est sécurisée, mais au détriment des performances.

• Type : nombre entier (bits)
• Valeur par défaut : 8192

mid.ssh.shells_supported

Définit les shells compatibles bourne pris en charge par le MID Server. Cette valeur est une liste séparée par des virgules des shells pris en charge, tels que ksh, dsh, bash et sh.

• Type : chaîne
• Valeur par défaut : ksh,bash,sh

mid.ssh.discard_lrc_error

Ignorer la sortie d’erreur de la commande à exécution longue, en émulant le comportement hérité.

• Type : chaîne
• Valeur par défaut : j2ssh - vrai, sncssh - faux

mid.ssh.pool_thread_ratio

Rapport entre la capacité du pool de sessions SSH et le nombre de threads configuré du MID Server (threads.max), exprimé en pourcentage. Le nombre de sessions de capacité de pool autorisées est défini dans ce paramètre. Quelle que soit la valeur définie dans ce paramètre, le système ne permet jamais que la capacité du pool descende en dessous de 25 sessions.

• Type : nombre entier
• Valeur par défaut : 150

mid.ssh.disable_privilege_check

Ce paramètre n’a aucun effet si la cible utilise une commande privilégiée autre que sudo. Pour plus d'informations, consultez Commandes privilégiées du MID Server.

Le reste de cette section s’applique uniquement aux cibles qui exécutent sudo. Lorsque ce paramètre est défini sur vrai, le MID Server suppose que l’utilisateur configuré dans les informations d’identification a le privilège d’exécuter la commande donnée à l’aide de sudo. Le MID Server part du principe que l’utilisateur cible peut exécuter n’importe quelle chaîne de commande après Sudo sur la cible. Lorsque ce paramètre est défini sur faux, le MID Server exécute « sudo -l » sur la cible pour vérifier que la commande qui suit sudo a l’autorisation de s’exécuter sur la cible. Quelle que soit la valeur de ce paramètre, le MID Server valide toujours que sudo seul peut être exécuté sur la cible.

Certaines versions n’affichent pas ce paramètre dans la liste déroulante Paramètres de configuration MID. Dans ce cas, vous pouvez éventuellement ajouter ce paramètre dans les propriétés MID.

• Type : true | false
• Valeur par défaut : false

Paramètres de mise à niveau

version épinglée.mid

Nom de la version à laquelle ce MID Server est épinglé.

• Type : chaîne
• Valeur par défaut : buildstamp MID
  Remarque :

  Pour voir le buildstamp MID pour votre instance, tapez stats.do dans le filtre de navigation. Un exemple du format buildstamp est london-06-27-2018__patch3-10-24-2018_11-11-2018_0542.

mid.upgrade.use_proxy

Si votre MID Server doit passer par un proxy Web pour accéder à l’URL de mise à niveau, définissez ce paramètre sur true pour demander au MID Server d’utiliser le proxy. Vous devez également définir l’hôte et le port du serveur proxy. Si le nom d’utilisateur et le mot de passe du proxy d’instance sont définis, ils sont également utilisés pour le proxy de mise à niveau.

Remarque :

Ce paramètre n’est pas destiné à contrôler les détails du proxy configurés avec les paramètres glide.mid.autoupgrade.proxy* .

• Type : true | false
• Valeur par défaut : true

glide.mid.autoupgrade.proxy_host ou glide.glidesoap.proxy_host

Si votre MID Server doit passer par un proxy Web pour accéder à l’URL de mise à niveau, définissez l’hôte du proxy ici.

• Type : chaîne (URL)
• Valeur par défaut : aucune

glide.mid.autoupgrade.proxy_port ou glide.glidesoap.proxy_port

Si votre MID Server doit passer par un proxy Web pour accéder à l’URL de mise à niveau, définissez le port du proxy ici.

• Type : nombre entier (0-65535)
• Valeur par défaut : 80

glide.mid.autoupgrade.proxy_user

Si votre MID Server doit passer par un proxy Web pour accéder à l’URL de mise à niveau, définissez le nom d’utilisateur du proxy ici.

• Type : chaîne (URL)
• Valeur par défaut : aucune

glide.mid.autoupgrade.proxy_password

Si votre MID Server doit passer par un proxy Web pour accéder à l’URL de mise à niveau, définissez le mot de passe du proxy ici.

• Type : chaîne
• Valeur par défaut : aucune

Paramètres de détection Windows

mid.powershell_api.session_pool.max_size

Spécifie le nombre maximal de sessions autorisées dans le pool de sessions.

Remarque :

Vous devez redémarrer le MID Server pour définir ou modifier ce paramètre.

• Type : nombre entier
• Valeur par défaut : 25

mid.powershell_api.session_pool.target.max_size

Spécifie le nombre maximal de sessions autorisées dans le pool par hôte cible.

Remarque :

Vous devez redémarrer le MID Server pour définir ou modifier ce paramètre.

• Type : nombre entier
• Valeur par défaut : 2

mid.sa.prefer_powershell

Permet à Serveur MID d'utiliser l'exécution de commandes à distance PowerShell.

• Type : true | false
• Valeur par défaut : false

mid.powershell_api.winrm.use_ssl

Nécessite l'utilisation de certificats SSL pour les connexions HTTPS à l'aide de WinRM.

• Type : true | false
• Valeur par défaut : false

mid.powershell_api.winrm.additional_pssesion_options

Contrôle les options avancées pour une PSSession. Pour obtenir plus d'informations sur les options PSSession avancées, consultez https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/new-pssessionoption?view=powershell-6.

mid.powershell_api.winrm.remote_https_port

Configure le port pour la connexion aux serveurs Windows à l'aide de PowerShell sur HTTPS.

• Type : nombre entier
• Valeur par défaut : 5 986

mid.powershell_api.winrm.remote_port

Configure le port pour la connexion aux serveurs Windows à l'aide de PowerShell sur HTTP.

• Type : nombre entier
• Valeur par défaut : 5 985

mid.powershell_api.winrm.skip_ssl_cert_check

Ignore la vérification du certificat SSL lors de l'utilisation de WinRM pour les connexions HTTPS.

• Type : true | false
• Valeur par défaut : false

mid.powershell_api.winrm.skip_ssl_cert_check_options

Ignore les vérifications de certificat SSL spécifiques lors de l'utilisation de WinRM pour les connexions HTTPS. Configurez le Serveur MID pour qu'il ignore les vérifications pour les certificats d'une autorité de certification (CA), du nom commun (CN) qui identifie l'hôte associé au certificat, et pour les certificats révoqués.

• Type : chaîne
• Valeur par défaut : -SkipCACheck -SkipCNCheck -SkipRevocationCheck

mid.powershell.use_credentials

Détermine les informations d'identification à utiliser pour Détection avec PowerShell. Si la valeur est définie sur true, Serveur MID exécute les sondes avec les informations d'identification Windows de la table des informations d'identification. Pour exécuter des sondes avec les informations d'identification de l'utilisateur pour le service Serveur MID, définissez ce paramètre sur false.

• Type : true | false
• Valeur par défaut : vrai

mid.powershell.path

Permet à un administrateur de pointer vers un PowerShell spécifique sur un Serveur MID lorsque plusieurs PowerShell sont installés. Indiquez le chemin vers le dossier contenant l\'exécutable PowerShell, par exemple , C:\mypowershell ou C:\mypowershell\. ServiceNow ajoute automatiquement la chaîne powershell.exe au chemin d'accès. Configurez ce paramètre lorsqu'un PowerShell 32 bits et un autre 64 bits sont actifs sur le même Serveur MID et qu'il devient nécessaire de lancer le PowerShell adapté au contexte. 64 bits Windows utilise la redirection du système de fichiers et le Serveur MID s'exécute en tant qu'application 32 bits. Si vous essayez de spécifier un chemin dans %WinDir%\System32, Windows redirige automatiquement vers %WinDir%\SysWOW64. Pour éviter la redirection, spécifiez le chemin d'accès comme %WinDir%\Sysnative. Par exemple, au lieu de C:\WINDOWS\system32\WindowsPowerShell\v1.0\, spécifiez C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\.

Remarque :

Sur une version 64 bits de Windows XP, un correctif Microsoft peut être requis pour pouvoir le faire.

Pour détecter les applications en cours d'exécution sur un ordinateur Windows 64 bits, le Serveur MID doit s'exécuter sur un ordinateur hôte Windows 64 bits.

• Type : chaîne (chemin d'accès)
• Valeur par défaut : aucune

mid.powershell.enforce_utf8

Activez ce paramètre pour forcer les commandes sur un système Windows cible à renvoyer une sortie encodée UTF-8. Si vous le désactivez, le système cible peut utiliser son codage par défaut. Ce paramètre n'est valide que lorsque PowerShell est activé.

Si la valeur est définie sur false , des valeurs incorrectes peuvent apparaître dans la CMDB lorsque des caractères non ASCII sont renvoyés par une sonde.

• Type : true | false
• Valeur par défaut : vrai

mid.powershell.local_mid_service_credential_fallback

Permet de revenir automatiquement aux informations d’identification Serveur MID de service si toutes les autres informations d’identification échouent.

• Type : true | false
• Valeur par défaut : true

mid.powershell_api.idle_session_timeout

Spécifie la valeur du délai d'expiration des sessions PowerShell inactives, en secondes.

Remarque :

Vous devez redémarrer le Serveur MID pour définir ou modifier ce paramètre.

• Type : nombre entier
• Valeur par défaut : 60

mid.powershell.command.parameter_passing

Activez ce paramètre pour autoriser le passage de paramètres PowerShell à partir de la ligne de commande.

• Type : true | false
• Valeur par défaut : false

mid.powershell.command.script.parameter_passing

Activez ce paramètre pour autoriser le passage de scripts PowerShell à partir de la ligne de commande.

• Type : true | false
• Valeur par défaut : true

mid.windows.management_protocol

Permet aux administrateurs de sélectionner le protocole de gestion Windows utilisé pour la classification des appareils et des processus. Les options incluent : WMI et WinRM.

• Type : chaîne
• Valeur par défaut : WMI

mid.windows.probe_timeout

Définit l'intervalle de délai d'expiration de toutes les sondes Windows sur un MID Server spécifique. Cette valeur est remplacée par les valeurs configurées pour chaque sonde avec le paramètre de sonde wmi_timeout.

• Type : nombre entier
• Valeur par défaut : 300

mid.powershell.jea.append_username

Spécifie si le nom d’utilisateur de l’utilisateur actuel sera ajouté au point de terminaison JEA.

• Type : true | false
• Valeur par défaut : faux

point de terminaison mid.powershell.jea.endpoint

Nom de configuration JEA (point de terminaison) sur les serveurs distants auxquels le MID Server se connectera. Définir sur JEA_DISCO_BASIC.

• Type : chaîne
• Valeur par défaut : «  »