Installer un serveur MID sur Linux

Installez les Serveurs MID avec le programme d’installation du Serveur MID et vérifiez qu’il 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 commande Configuration requise pour le Serveur MID.

Rôle requis : admin, mid_server

Pourquoi et quand exécuter cette tâche

Pour installer Linux sur MID Server, 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 racine 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 MID Server 32 bits ou les mises à niveau vers la version Rome. L’installation du nouveau serveur 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 de MID Servers vers Rome crée un enregistrement de problème dans Problèmes de Serveur MID (ecc_agent_issue). Pour plus d’informations, consultez Modifications de plateforme prises en charge pour Serveur MID [KB0863694].

Java 17.0.12 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 17.0.12 pour qu’il s’exécute dans votre environnement. Aucune configuration supplémentaire n’est requise. Cette version prend en charge à la fois 64 bits Windows Serveurs MID et 64 bits Linux Serveurs MID. L’opération Serveur MID nécessite au moins la version JRE 17.0.10 et la version recommandée 17.0.12. Si vous utilisez une version antérieure à 17.0.10, vous pouvez voir des problèmes liés au chiffrement.

Remarque :

Les MID Servers 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 C GNU 32 bits (glibc). La commande d’installation de 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 l’environnement JRE vers une version différente, contactez le représentant de compte approprié pour obtenir de l’aide.

Procédure

1. Sur l’instance, accédez à Serveur MID > Téléchargements et téléchargez soit le fichier RPM du programme d’installation de MID Server pour RedHat/CentOS, soit 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 dans les machines Linux.

   wget <copied link of the installer>

2. 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.

      Tr / min

      • Extrayez la clé publique, le fichier 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>

3. Utilisez les commandes suivantes pour installer le programme d’installation RPM ou DEB :

   Tr / min

   • Installez le package RPM pour les systèmes RedHat avec la commande suivante :

     sudo rpm -ivh --nodeps package_name.rpm.

   • Installez le package RPM pour les systèmes RedHat dans un emplacement défini par l’utilisateur avec la commande suivante :

     sudo rpm -ivh --nodeps package_name.rmp --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.

4. 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 racine et fournissez les entrées requises.

   ./installer.sh

   
5. Le script installer.sh prend les entrées suivantes.

   URL d'instance

   Entrez 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 de Serveur MID que vous avez déjà créé. L’utilisateur de Serveur MID doit avoir le rôle mid_server.

   Mot de passe du Serveur MID

   Définissez le mot de passe de l’utilisateur actuel de 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. Voir 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

   Attribuez un nom unique au 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 de Linux MID Server

L’installation silencieuse du serveur MID utilise des paramètres prédéfinis et ne nécessite aucune intervention de l’utilisateur après son lancement. Vous pouvez utiliser l’installation silencieuse sur plusieurs machines à 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 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 via 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, indiquez 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 de Serveur MID que vous avez déjà créé. L’utilisateur de 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 qui dispose 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

Fournissez le nom long du service.

NON_ROOT_USER

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

Voici un exemple de commande pour un serveur MID qui utilise un proxy et l’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.

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

Exécutez des MID Servers en tant qu’utilisateur non racine sur un ordinateur Linux pour améliorer la sécurité. Plusieurs Serveur 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 ne s’applique que 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 est déjà en cours d’exécution 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

1. Arrêtez tout Serveur MID en cours d’exécution sur l’hôte avec la commande bin/mid.sh stop.
2. Supprimez tous les serveurs MID de l’hôte à l’aide de la commande bin/mid.sh supprimer.
3. Modifiez le fichier mid.shconf_override.
   
4. Ajoutez le nom du Serveur MID en suivant les 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.
5. Facultatif : Pour exécuter plusieurs MID Servers en tant que services sur le même hôte, ajoutez une APP_NAME et une APP_LONG_NAME pour chaque instance.
   
6. Ajoutez le nom de l’utilisateur non racine pour gérer le compte à l’aide de la ligne RUN_AS_USER=.
7. Facultatif : Ajoutez le nom du groupe pour posséder l’ensemble du répertoire d’agent à l’aide de la ligne GROUP_NAME=.
8. Définissez la ligne PROMPT_BEFORE_OWNERSHIP_CHANGE = sur vrai pour inviter l’utilisateur à confirmer avant que tout changement aux autorisations de fichier ne soit appliqué.
   Le changement d’autorisation de fichier est appliqué de façon récursive à l’ensemble du dossier de l’agent et à tout ce qui s’y trouve. Les modifications comprennent le blocage de l’accès des autres utilisateurs à l’ensemble du dossier d’agent, le changement du propriétaire en $RUN_AS_USER si spécifié et le changement du groupe en $GROUP_NAME si spécifié.
9. 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. Ensuite, l’utilisateur non racine spécifié dans mid.shconf_override est 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 Windows MID Servers. L’exécution d’un serveur MID Linux avec un compte non racine peut entraîner des problèmes avec PolicyKit dans certains systèmes. Pour plus d’informations, consultez 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. Consultez la section Configuration requise pour le Serveur MID pour en savoir plus.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

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

Procédure

1. Accédez à ce fichier dans le répertoire d’installation de Serveur MID :
   agent/conf/wrapper-override.conf
2. 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.

3. 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.

Résultats

Le service Serveur MID est désinstallé.

Que faire ensuite

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