Installer un serveur MID sur Linux

Options de la ServiceNow AI Platform en Australie

Release

australia

ft:locale

fr-FR

ft:publication_title

Options de la ServiceNow AI Platform en Australie

ft:clusterId

platcap

bundleId

platcap

workflow

Platform

Installer un serveur MID sur Linux

Rversion finale: Australia

Mis à jour 12 mars 2026

11 minutes de lecture

Installez les serveurs MID avec le programme d’installation du serveur MID et vérifiez que celui-ci est actif. Le package inclut un programme d’installation qui configure automatiquement JRE pour qu’il s’exécute dans l’environnement. Le serveur MID peut utiliser un JRE existant plutôt que le JRE fourni. Désinstallez le serveur MID pour le redéployer.

Avant de commencer

Vérifiez que l’ordinateur hôte satisfait à la norme Configuration système requise pour le serveur MID.

Rôle requis : admin, mid_server

Pourquoi et quand exécuter cette tâche

Pour installer Linux sur un serveur MID, les systèmes RedHat/CentOS nécessitent RPM tandis que les systèmes Debian (Ubuntu) nécessitent DEB. L’emplacement d’installation par défaut est /opt/servicenow/mid. L’installation de DEB dans les répertoires définis par l’utilisateur n’est pas prise en charge.

Pour améliorer la sécurité, cette procédure installe et exécute le service Serveur MID en tant qu’utilisateur non racine. Le privilège root est requis pour déployer et configurer un serveur MID sur un serveur Linux. Un utilisateur non racine ne peut gérer un service que s’il possède les autorisations requises. Pour plus d’informations, consultez Problèmes PolicyKit avec les serveurs MID Linux utilisant des comptes non-administrateurs [KB0815542].

Remarque :

ServiceNow ne prend plus en charge les nouvelles installations de serveurs MID 32 bits ou les mises à niveau vers la version Rome. L’installation des nouveaux serveurs MID est bloquée via le programme d’installation RPM et MSI sur les systèmes d’exploitation suivants :

CentOS 7
Serveur Windows 2008
Serveur Windows 2008 R2
Windows 8
Windows 10

Les serveurs MID peuvent être installés manuellement sur n’importe quel système d’exploitation avec le fichier ZIP, mais Windows 10 n’est pas pris en charge. La mise à niveau automatique des serveurs MID non pris en charge vers Rome crée un enregistrement de problème dans MID Server Issues (ecc_agent_issue). Pour plus d’informations, consultez Modifications de plateforme prises en charge pour le serveur MID [KB0863694].

Java 21.0.7 est fourni avec le package d’installation Serveur MID et est installé sur l’hôte pour tous les nouveaux Serveurs MID. Le programme d’installation configure automatiquement Java 21.0.7 pour qu’il s’exécute dans votre environnement. Aucune configuration supplémentaire n’est requise. Cette version prend en charge les formats 64 bits Windows Serveurs MID et 64 bits Linux Serveurs MID. Cela Serveur MID nécessite au minimum la version 17.0.10 du JRE et la version recommandée 21.0.7. Si vous utilisez une version antérieure à la 17.0.10, vous pouvez rencontrer des problèmes de chiffrement.

Remarque :

Les serveurs MID Linux nécessitent la version 2.17 de GlibC. La bibliothèque doit être mise à jour pour JRE 11. Sur les systèmes Linux 64 bits, vous devez installer la bibliothèque GNU C 32 bits (glibc). La commande d’installation pour CentOS est : yum install glibc.i686

Les tests ont montré que le Serveur MID fonctionne comme prévu avec Oracle Java 11 version 17.0.10. Si vous devez mettre à niveau le JRE vers une version différente, contactez le représentant de compte approprié pour obtenir une assistance.

Procédure

Sur l’instance, accédez à Serveur MID > Téléchargements et téléchargez le fichier RPM du programme d’installation du serveur MID pour RedHat/CentOS ou le fichier DEB pour les systèmes Debian (Ubuntu).
Remarque :
Utilisez le bouton Copier le lien pour copier le lien de téléchargement et utilisez la commande wget suivante pour télécharger directement les programmes d’installation sur les machines Linux.
```
wget <copied link of the installer>
```
Facultatif : Vérifiez manuellement l’authenticité et l’intégrité du fichier téléchargé.
1. Téléchargez les fichiers ZIP de signature pour RPM/DEB.
2. Exécutez les commandes suivantes pour RPM ou DEB.
  RPM
  - Extrayez la clé publique, ServiceNow_Digicert_DGST.pem et le fichier de signature du fichier zip de signature téléchargé.
  - Exécutez la commande suivante pour vérifier la signature du fichier RPM.
```
openssl dgst -sha256 -verify <Extracted .pem file> -signature <Extracted bin file path> <RPM file path> 
```
  DEB
  - Extrayez la clé publique, ServiceNow_Digicert_Public.gpg, des fichiers zip de signature téléchargés.
  - Importez la clé publique et vérifiez la signature du fichier DEB à l’aide des commandes suivantes.
```
gpg --import <public key> 
dpkg-sig --verify <DEB file path>
```
Utilisez les commandes suivantes pour installer le programme d’installation RPM ou DEB :
RPM
- Installez le package RPM pour les systèmes RedHat à l’aide de la commande suivante :
```
sudo rpm -ivh --nodeps package_name.rpm.
```
- Installez le package RPM pour les systèmes RedHat à un emplacement défini par l’utilisateur avec la commande suivante :
```
sudo rpm -ivh --nodeps package_name.rpm --prefix=/path/to/user/directory.
```
DEB
Installez le paquet DEB pour les systèmes Debian avec la commande suivante :
```
sudo dpkg -i package_name.deb.
```
Pour configurer le service Serveur MID, exécutez la commande suivante à partir du dossier de l’agent en tant qu’utilisateur disposant du privilège root et fournissez les entrées requises.
```
./installer.sh
```
Le script installer.sh prend les entrées suivantes.

URL de l'instance

Saisissez l’URL complète de votre instance, par exemple : https://mycompanyinstace.service-now.com

Nom d’utilisateur du serveur MID

Entrez le nom d’utilisateur de l’utilisateur du serveur MID que vous avez déjà créé. L’utilisateur MID Server (Serveur MID) doit avoir le rôle mid_server.

Mot de passe de serveur MID

Définissez le mot de passe de l’utilisateur actuel du serveur MID.

Nom du serveur MID

Définissez le nom du serveur MID.

Informations sur le serveur proxy (facultatif).

mid.proxy.use_proxy

Permet au Serveur MID d’utiliser un proxy web pour accéder à l’instance ServiceNow.

mid.proxy.host

Définissez ce paramètre pour définir l’hôte du proxy web.

mid.proxy.port

Définissez ce paramètre pour définir le port du proxy web.

mid.proxy.nom d’utilisateur

Si le proxy web nécessite un nom d’utilisateur, définissez ce paramètre pour définir ce nom d’utilisateur.

mid.proxy.mot de passe

Si le proxy web nécessite un mot de passe, définissez ce paramètre pour définir ce mot de passe.

Le serveur MID peut contourner les serveurs proxy dont l’adresse DNS/IP est répertoriée dans le paramètre de configuration mid.cloud.discovery.proxy.exclusion.list. Consultez la propriété du serveur MID pour plus d’informations.

Pour exécuter un serveur MID en tant que service démon, les propriétés suivantes sont également requises.

app_name

Définir un nom unique pour le serveur MID actuel

app_long_name

Définissez un nom long unique pour le serveur MID.

run_as_user

Définissez le nom d’utilisateur pour exécuter le service en tant qu’utilisateur non racine.

Résultats

Une fois toutes les entrées entrées, le serveur MID s’exécute automatiquement en tant que service démon et démarre le service.

Installation silencieuse du serveur MID Linux

L’installation silencieuse du serveur MID utilise des paramètres prédéfinis et ne nécessite aucune entrée de l’utilisateur après son lancement. Vous pouvez utiliser l’installation silencieuse sur plusieurs ordinateurs à la fois pour configurer rapidement un réseau et vous assurer que tous les serveurs MID ont les mêmes paramètres d’installation.

Pour effectuer une installation silencieuse avec le programme d’installation de Linux, exécutez la commande suivante :

./installer.sh -silent -INSTANCE_URL https://instance_name.service-now.com -MUTUAL_AUTH N -MID_USERNAME username -MID_PASSWORD password -USE_PROXY N -MID_NAME mid -APP_NAME mid -APP_LONG_NAME ServiceNow_MID_Server_Mid -NON_ROOT_USER nonrootuser

Les champs suivants peuvent être transmis par la ligne de commande :

INSTANCE_URL: Entrez l’URL de votre instance, par exemple : https://mycompanyinstance.service-now.com
MUTUAL_AUTH: Définissez cette valeur sur Y pour utiliser l’authentification réciproque au lieu de l’authentification de base. Sinon, définissez-le sur N.

Remarque :
Si MUTUAL_AUTH = Y, fournissez le chemin d’accès au certificat avec CERTIFICATE_PATH.
CERTIFICATE_PATH: Si l’authentification réciproque est activée, indiquez le chemin d’accès au certificat.
MID_USERNAME: Entrez le nom d’utilisateur de l’utilisateur du serveur MID que vous avez déjà créé. L’utilisateur MID Server (Serveur MID) doit avoir le rôle mid_server.
MID_PASSWORD: Entrez le mot de passe de l’utilisateur.
USE_PROXY: Définissez cette valeur sur Y si votre serveur MID communique via un proxy pour se connecter à l’instance.

Remarque :
Si USE_PROXY = N, ignorez les autres détails du proxy.
PROXY_HOST: Entrez le nom d’hôte ou l’adresse IP du serveur proxy. N’incluez pas le protocole dans le nom d’hôte. Par exemple : proxyserver.domain.com est correcte, mais https://proxyserver.domain.com est incorrecte.
PROXY_PORT: Entrez le port que le serveur proxy utilise pour communiquer. Si cette valeur est vide, le programme d’installation utilise le numéro de port par défaut du serveur proxy.
PROXY_USERNAME: Entrez le nom d’utilisateur disposant des droits d’administrateur sur le serveur proxy.
PROXY_PASSWORD: Entrez le mot de passe du nom d’utilisateur.
MID_NAME: Entrez le nom du serveur MID.
APP_NAME: Indiquez le nom du service. Il doit être unique pour le serveur MID actuel.
APP_LONG_NAME: Indiquez le nom long du service.
NON_ROOT_USER: Fournissez le nom d’utilisateur pour exécuter le service en tant qu’utilisateur non racine.

L’exemple de commande suivant est un exemple de commande pour un serveur MID qui utilise un proxy et une authentification réciproque :

./installer.sh -silent -INSTANCE_URL https://instance_name.service-now.com MUTUAL_AUTH Y –CERTIFICATE_PATH <path-to-certificate> -USE_PROXY Y -PROXY_HOST <ip> -PROXY_PORT <port> -PROXY_USERNAME <username> -PROXY_PASSWORD <password> -MID_NAME proxymid -APP_NAME proxymid -APP_LONG_NAME servicenow_proxy_mid -NON_ROOT_USER nonrootuser

Remarque :

Pour reconfigurer le serveur MID, exécutez à nouveau la commande installer.sh . La reconfiguration du serveur MID supprime l’ancienne configuration. La ligne de commande Linux après l’utilisation de la commande d’installation silencieuse.

La ligne de commande Linux après l’utilisation de la commande d’installation silencieuse.

Exécuter des serveurs MID Linux en tant qu’utilisateurs non racines

Exécutez des serveurs MID en tant qu’utilisateur non racine sur un ordinateur Linux pour améliorer la sécurité. Plusieurs serveurs MID peuvent être installés en tant que services afin qu’ils puissent démarrer d’eux-mêmes après le redémarrage du système.

Avant de commencer

Rôle requis : root

Ce processus est uniquement applicable si vous avez installé le serveur MID manuellement à l’aide du fichier ZIP. Si vous avez installé le serveur MID avec la procédure dans Installer un serveur MID sur Linux, le serveur MID s’exécute déjà en tant qu’utilisateur non racine.

Les versions prises en charge pour cette procédure sont Linux Red Hat 6 ou version ultérieure, Ubuntu 1404 ou version ultérieure et CentOS 6 ou version ultérieure.

Procédure

Arrêtez tout serveur MID en cours d’exécution sur l’hôte à l’aide de la commande bin/mid.sh stop.
Supprimez tous les serveurs MID sur l’hôte à l’aide de la commande bin/mid.sh supprimer.
Modifiez le fichier mid.shconf_override.
Ajoutez le nom du serveur MID à l’aide des lignes APP_NAME= et APP_LONG_NAME= pour l’exécuter en tant que service.
Pour éviter les erreurs, la APP_NAME de chaque serveur MID doit être unique.
Facultatif : Pour exécuter plusieurs serveurs MID en tant que services sur le même hôte, ajoutez une APP_NAME et une APP_LONG_NAME pour chaque instance.
Ajoutez le nom de l’utilisateur non racine pour gérer le compte à l’aide de la ligne RUN_AS_USER=.
Facultatif : Ajoutez le nom du groupe pour posséder l’intégralité du répertoire de l’agent à l’aide de la ligne GROUP_NAME=.
Définissez la ligne PROMPT_BEFORE_OWNERSHIP_CHANGE = sur vrai pour inviter l’utilisateur à confirmer avant d’appliquer des modifications aux autorisations de fichiers.
Le changement d’autorisation du fichier est appliqué à l’ensemble du dossier de l’agent et à tout ce qui se trouve à l’intérieur, de façon récursive. Les modifications incluent le blocage de l’accès des autres utilisateurs à l’ensemble du dossier de l’agent, le changement du propriétaire en $RUN_AS_USER si spécifié et le changement du groupe en $GROUP_NAME si spécifié.
Réinstallez le serveur MID à l’aide de la commande bin/mid.sh installer.

Remarque :
Pour éviter les erreurs, assurez-vous d’arrêter et de supprimer tous les services de serveur MID existants avant d’en démarrer de nouveaux. Lors de la première installation, un utilisateur root est requis pour appeler bin/mid.sh install. La réinstallation du serveur MID applique les changements dans mid.shconf_override. L’utilisateur non racine spécifié dans mid.shconf_override est alors en mesure de démarrer/arrêter/redémarrer le service sans privilèges élevés.

Que faire ensuite

Pour plus d’informations sur la gestion de la liste d’autorisation et de l’application des autorisations de fichiers, reportez-vous à la section Application des autorisations de fichier pour les serveurs MID Windows. L’exécution d’un serveur MID Linux avec un compte non racine peut entraîner des problèmes avec PolicyKit sur certains systèmes. Pour plus d’informations, consultez la section Problèmes PolicyKit avec les serveurs MID Linux utilisant des comptes non racines .

Configurer un serveur MID Linux pour utiliser un JRE existant

Vous pouvez choisir d’utiliser un JRE existant pour votre serveur MID plutôt que l’OpenJDK fourni avec le programme d’installation du serveur MID.

Avant de commencer

Assurez-vous que votre version JRE est prise en charge. Voir Configuration système requise pour le serveur MID pour plus de détails.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

En choisissant d’utiliser votre propre JRE, vous êtes responsable de sa mise à niveau si nécessaire. Pour une procédure détaillée et des précautions concernant la modification de l’environnement JRE, consultez KB0778272.

Procédure

Accédez à ce fichier dans le répertoire d’installation du serveur MID :
agent/conf/wrapper-override.conf
Pour spécifier l’exécutable Java existant que vous souhaitez utiliser, ajoutez cette ligne au fichier :
wrapper.java.command={your_java_executable}
Pour plus d’informations, consultez la documentation relative aux propriétés de la couche de service Java.
Enregistrez le fichier.

Désinstaller un serveur MID Linux

Le Serveur MID s’exécute en tant que service autonome. Vous pouvez supprimer un service de serveur MID autonome pour prendre en charge des tâches telles que le redéploiement du serveur MID sur un autre ordinateur hôte ou la modification du nom unique d’un serveur MID lors du déploiement de plusieurs serveurs MID.

Avant de commencer

Rôle requis : admin

Procédure

Exécutez le script uninstall.sh dans le dossier de l’agent pour supprimer le service et désinstaller le RPM/DEB.

La ligne de commande Linux après l’exécution du script uninstall.sh.

Résultats

Le service Serveur MID est désinstallé.

Que faire ensuite

Validez le serveur MID pour le préparer à l’utilisation.