Vérification préalable à la mise à niveau du serveur MID

  • Rversion finale: Australia
  • Mis à jour 27 avr. 2026
  • 7 minutes de lecture

    • Avant une mise à niveau, le serveur MID exécute des tests pour identifier les problèmes susceptibles d’entraîner l’échec du processus de mise à niveau ou une panne du serveur MID.

    Chaque serveur MID contient un moniteur AutoUpgrade qui compare la version du serveur MID avec celle de l’instance pour déterminer si le serveur MID doit être mis à niveau. Si le moniteur de mise à niveau automatique détecte que la version du serveur MID est obsolète, il exécute des tests de validation préalables à la mise à niveau pour ce serveur MID. Si un problème est détecté, un message est consigné dans la table Problème de serveur MID [ecc_agent_issue] et la mise à niveau est bloquée. Le moniteur de mise à niveau automatique continue de s’exécuter toutes les heures, jusqu’à ce que tous les tests réussissent. S’il n’y a pas de problème de blocage, le serveur MID 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 serveur MID 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 mise à niveau préalable 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 serveur MID. Si un test obligatoire n’a pas réussi, le test est enregistré dans le journal de l’agent et un problème de serveur MID actif est créé dans la table des problèmes de serveur MID [ecc_agent_issue]. Ces erreurs sont publiées avant la mise à niveau effective du serveur MID et doivent être résolues pour que la mise à niveau puisse se poursuivre. Le serveur MID arrête le processus de mise à niveau et modifie l’état en fonction de États de serveur MID. Si un test d’alerte n’a pas réussi, un message est ajouté dans le journal de l’agent et dans la table des problèmes de serveur MID, 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 2 Go d’espace disque libre
    • Accès au site de téléchargement à 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 :
      • Extrayez un archiveur Zip vers le dossier temporaire de mise à niveau : agent/work/upgrade_temp
      • Copier les fichiers du dossier temporaire de mise à niveau 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
    • L’ordinateur hôte du serveur MID n’est pas un système 32 bits
    • Sur les serveurs MID Linux, la version glibC est au minimum la version 2.17
    Sur Windows MID Servers, la validation préalable à la mise à niveau exécute les tests d’alerte suivants :
    • Tous les services de blocage de mise à niveau du serveur MID sont en cours d’exécution sur l’ordinateur hôte
    • État de l’expérience de l’application sur l’ordinateur hôte
    • Pour une bonne pratique de sécurité, exécutez le serveur MID en tant qu’utilisateur non administrateur. Si le compte d’utilisateur Log On As actuel du serveur MID est LocalSystem ou s’il s’agit d’un utilisateur faisant partie du groupe Administrateurs, la mise à niveau n’échoue pas, mais cette configuration n’est pas recommandée.

    Erreurs qui bloquent la mise à niveau

    Ces messages décrivent l’échec d’un test obligatoire et sont publiés dans la table MID Server Issue [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 2 Go d’espace disque libre sont détectés sur l’hôte du serveur MID. Cette erreur est également écrite dans le journal de l’agent de serveur MID.
    Impossible de télécharger les mises à jour à partir du serveur d’installation
    Ce message indique que l’hôte du serveur MID n’a pas l’autorisation de 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 de serveur MID.
    Échec de la vérification de 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 <mise à niveau, vérifiez le chemin d’accès du fichier>
    Ce message indique que le compte de service Serveur MID n’a pas l’autorisation de créer le dossier upgradeCheck pour les fichiers de vérification préalable à la mise à niveau dans le chemin d’accès de l’agent/du package.
    Impossible de vérifier les autorisations de fichier : <message>
    Ce message indique qu’une exception s’est produite lors de la vérification des autorisations de fichier, comme 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 système local ou en tant qu’administrateur local
    Ce message 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 serveur MID.
    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 serveur MID. Pour plus d’informations, consultez la documentation produit du serveur MID sur la bibliothèque GlibC
    Cette erreur ne peut se produire que pour les serveurs MID Linux. Reportez-vous à la section Prise en charge de la version Java pour plus d’informations.

    Avertissements non bloquants

    Ces avertissements sont affichés dans la table MID Server Issue (Problème de serveur MID) [ecc_agent_issue] et n’empêchent pas la mise à niveau d’un serveur MID Windows :
    Impossible d’analyser $logOnAsUser
    Ce message avertit que la valeur Log On As User (Ouvrir une session en tant qu’utilisateur) pour le service Windows n’est pas dans l’un de ces formats attendus :
    • user@domain.company.com
    • domaine\utilisateur
    Impossible de rechercher les groupes d’utilisateurs de Log On As

    Lorsque l’instance tente de rechercher les appartenances à des groupes de l’utilisateur connecté, elle exécute la commande net user <nom d’utilisateur> . 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 de serveur MID. Étant donné que PowerShell n’est pas requis pour utiliser un serveur MID, ces problèmes de configuration n’empêchent pas la mise à niveau d’un serveur MID 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 Serveur MID.
    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 s’exécutant sur la machine hôte du serveur MID est identifié comme un bloqueur de mise à niveau du serveur MID
    Pour plus d’informations, consultez KB0870329.
    L’expérience d’application est désactivée sur l’hôte du serveur MID, ce qui peut entraîner l’échec du processus de mise à niveau automatique et l’arrêt du serveur MID. 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.
    Poursuite de la mise à niveau, mais le problème suivant s’est produit lors de upgradeCheck : <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 serveur MID appelé mid.upgrade.run_precheck est défini sur vrai par défaut, ce qui permet l’exécution automatique du test préalable à la mise à niveau. Pour désactiver ces tests pour un serveur MID unique, ajoutez ce paramètre au fichier config.xml de ce serveur MID et définissez-le sur false. Pour désactiver ces tests pour tous les serveurs MID, ajoutez un nouvel enregistrement à la table Propriété du serveur MID [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 (Serveur MID ) vide.