Vérification avant mise à niveau du Serveur MID

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture
  • Avant une mise à niveau, le MID Server exécute des tests pour identifier les problèmes susceptibles d’entraîner l’échec du processus de mise à niveau ou une panne du MID Server.

    Chaque MID Server dispose d’un moniteur de mise à niveau automatique qui compare la version du MID Server à celle de l’instance afin de déterminer si la mise à niveau du MID Server est nécessaire. Si le moniteur de mise à niveau automatique détecte que la version du MID Server n’est pas à jour, le moniteur exécute des tests de validation préalables à la mise à niveau pour ce MID Server. Si un problème est détecté, un message est consigné dans la table Problème de MID Server [ecc_agent_issue] et la mise à niveau est bloquée. Le moniteur de mise à niveau automatique continue de fonctionner toutes les heures jusqu’à ce que tous les tests réussissent. S’il n’y a aucun problème bloquant, le MID Server télécharge le package de mise à niveau approprié et commence le processus de mise à niveau. La vérification préalable à la mise à niveau du MID Server s’exécute également pour les mises à niveau déclenchées par l’instance lors de la mise à niveau de l’instance, ainsi que pour les mises à niveau manuelles.

    Tests préalables à la mise à niveau

    La pré-mise à niveau exécute deux ensembles de tests : les tests obligatoireset les tests d’alerte. Tous les tests obligatoires doivent être réussis pour démarrer la mise à niveau du MID Server. Si aucun test obligatoire n’a été réussi, le test est enregistré dans le journal de l’agent et un problème actif du MID Server est créé dans la table des problèmes du MID Server [ecc_agent_issue]. Ces erreurs sont publiées avant que la mise à niveau du MID Server réelle ne se produise et doivent être résolues pour que la mise à niveau puisse continuer. Serveur MID arrête le processus de mise à niveau et modifie l’état en fonction de États du MID Server. Si aucun test d’alerte n’a réussi, un message est ajouté au journal de l’agent et à la table des problèmes du MID Server, mais la vérification préalable à la mise à niveau se poursuit et la mise à niveau MID ne s’arrête pas.

    Les tests de validation préalables à la mise à niveau vérifient les tests obligatoires suivants :
    • Au moins 1 Go d’espace disque disponible
    • Accès au site de téléchargement à l’adresse install.service-now.com
    • Vérifier la signature numérique d’un exemple de fichier téléchargé
    • Autorisation d’exécution, qui implique les éléments suivants :
      • Extraire un archiveur Zip vers un dossier temporaire
      • Copier le fichier du dossier temporaire vers le dossier de l’agent
      • Lire un fichier texte et valider le contenu
      • Supprimer le contenu de la vérification préalable à la mise à niveau
    • La machine hôte du Serveur MID n’est pas un système 32 bits
    • Sur les MID Servers Linux, la version glibC est au moins 2.17
    Sur les MID Servers Windows, la validation préalable à la mise à niveau exécute les tests d’alerte suivants :
    • Tous les services de bloqueur de mise à niveau de Serveur MID sont en cours d’exécution sur l’ordinateur hôte
    • État de l’expérience d’application sur l’ordinateur hôte
    • Assurez-vous que l’utilisateur Ouvrir une session en tant que pour le service Windows est LocalSystem ou un utilisateur faisant partie du groupe d’administrateurs local. Par défaut, les administrateurs de domaine sont ajoutés au groupe d’administrateurs local lors de la jonction d’un ordinateur à un domaine.

    Erreurs qui bloquent la mise à niveau

    Ces messages décrivent l’échec d’un test obligatoire et sont publiés dans la table Problème de MID Server [ecc_agent_issue]. L’échec de l’un de ces tests bloque la mise à niveau.
    Pas assez d’espace disque libre. Le système signale <n> octets libres
    Ce message s’affiche lorsque moins de 1 Go d’espace disque libre est détecté sur l’hôte du MID Server. Cette erreur est également écrite dans le journal de l’agent du MID Server.
    Impossible de télécharger les mises à jour à partir du serveur d’installation
    Ce message indique que l’hôte du MID Server n’est pas autorisé à télécharger le package d’installation à partir de install.service-now.com ou que des problèmes réseau empêchent la connexion. Cette erreur est également écrite dans le journal de l’agent du MID Server.
    Échec de la vérification de la signature : <message>
    Ce message indique qu’une exception de vérification s’est produite lorsque la vérification préalable à la mise à niveau tente de vérifier la signature numérique du fichier de vérification téléchargé.
    Impossible de vérifier la signature numérique : <message>
    Ce message indique que le processus de signature de vérification a été interrompu par une exception.
    Impossible d’extraire le contenu du zip de vérification préalable à la mise à niveau
    Ce message indique que le compte de service sur l’hôte du Serveur MID n’a pas l’autorisation d’extraire l’archive ZIP antérieure à la mise à niveau vers le dossier temporaire.
    Impossible de créer un dossier <mettre à niveau vérifier le chemin d’accès du fichier>
    Ce message indique que le compte de service du MID Server n’est pas autorisé à créer le dossier upgradeCheck pour les fichiers de vérification de pré-mise à niveau dans le chemin d’accès de l’agent/package.
    Impossible de vérifier les droits d’accès aux fichiers : <message>
    Ce message indique qu’une exception s’est produite lors de la vérification des autorisations de fichier, par exemple un fichier qui n’existe pas ou un échec d’accès.
    Le service Windows du Serveur MID ne s’exécute pas en tant que LocalSystem ou en tant qu’administrateur local
    Ce message vous avertit que le service Windows ne s’exécute pas avec les autorisations souhaitées.
    Échec de la mise à niveau : l’ordinateur hôte ne répond pas à la configuration minimale requise pour mettre à niveau le MID Server.
    La mise à niveau MID n’est pas prise en charge sur l’hôte 32 bits. Veuillez vous référer à KB0863694 pour plus d’informations.
    Échec de la mise à niveau : l’hôte ne répond pas à la configuration minimale requise pour mettre à niveau le MID Server. Pour plus d’informations, reportez-vous à la documentation produit du MID Server sur la bibliothèque GlibC
    Cette erreur ne peut se produire que pour les MID Servers Linux. Reportez-vous à la section Prise en charge des versions Java pour plus d’informations.

    Avertissements non bloquants

    Ces avertissements s’affichent dans la table Problèmes de MID Server [ecc_agent_issue] et n’empêchent pas une mise à niveau vers un MID Server Windows :
    Impossible d’analyser $logOnAsUser
    Ce message avertit que la valeur Ouvrir une session en tant qu’utilisateur pour le service Windows n’est dans aucun de ces formats attendus :
    • user@domain.company.com
    • Domaine\utilisateur
    Impossible de rechercher la Connexion en tant que groupes d’utilisateurs

    Lorsque l’instance tente de rechercher les appartenances au groupe de l’utilisateur connecté, elle exécute la commande net user <username>  ;. L’instance attend une certaine structure de sortie du service Windows à partir de cette commande et émet cet avertissement si la sortie attendue ne correspond pas à la sortie réelle.

    Ces avertissements PowerShell sont écrits uniquement dans le journal de l’agent du MID Server. Étant donné que PowerShell n’est pas requis pour utiliser un MID Server, ces problèmes de configuration n’empêchent pas la mise à niveau d’un MID Server Windows. Toutefois, ces avertissements peuvent indiquer des problèmes dans votre environnement qui nécessitent une attention particulière.

    Ignorer les vérifications de mise à niveau de PowerShell, car PowerShell n’est pas utilisable
    PowerShell 3.0 (au minimum) n’est pas installé ou powershell.exe n’est pas disponible pour l’utilisateur du service MID Server.
    Ignorer le test Powershell : le dossier cible n’a pas été initialisé
    Ignorer le test Powershell : impossible de détecter le nom du service
    Le service CiscoAMP exécuté sur l’ordinateur hôte du Serveur MID est identifié comme un bloqueur de mise à niveau du Serveur MID
    Pour plus d’informations, référez-vous à KB0870329.
    Application Experience est désactivée sur l’hôte du MID Server, ce qui peut entraîner l’échec du processus de mise à niveau automatique et l’arrêt du MID Server. Activez le service sur l’hôte pour garantir la réussite de la mise à niveau automatique
    Pour plus d’informations, référez-vous à KB0597552.
    La mise à niveau se poursuit, mais le problème suivant s’est produit lors de la vérification de la mise à niveau : <message d’exception>
    Ce message indique qu’un problème s’est produit lors de l’exécution de la partie PowerShell des tests préalables à la mise à niveau.

    Désactivation de la vérification préalable à la mise à niveau

    Un paramètre de configuration du MID Server appelé mid.upgrade.run_precheck est défini sur vrai par défaut, ce qui permet au test automatique de pré-mise à niveau de s’exécuter. Pour désactiver ces tests pour un seul MID Server, ajoutez ce paramètre au fichier config.xml de ce MID Server et définissez-le sur false. Pour désactiver ces tests pour tous les MID Servers, ajoutez un nouvel enregistrement à la table Propriété du MID Server [ecc_agent_property] appelée mid.upgrade.run_precheck. Définissez la valeur de cette propriété sur faux et laissez le champ MID Server vide.