Vérification préalable à la mise à niveau de Serveur MID

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 de mise à niveau automatique 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èmes 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 de Serveur MID s’exécute également pour les mises à niveau déclenchées par l’instance au moment 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 séries de tests : les tests obligatoireset les tests d’alerte. Tous les tests obligatoires doivent réussir pour démarrer la mise à niveau de 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 réelle du serveur MID et doivent être résolues pour que la mise à niveau puisse continuer. Serveur MID arrête le processus de mise à niveau et change l’état en fonction de États de Serveur MID. Si un test d’alerte n’a pas réussi, un message est ajouté au journal de l’agent et à 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 1 Go d’espace disque libre
    • Accès au site de téléchargement au 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
    • L’ordinateur hôte du Serveur MID n’est pas un système 32 bits
    • Sur les serveurs MID Linux, la version de glibC est au moins 2.17
    Sur Windows MID Server, 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
    • Le Serveur MID doit s’exécuter en tant qu’utilisateur non-administrateur. Si le compte d’utilisateur Connexion en tant que pour le Serveur MID est LocalSystem ou est un utilisateur qui fait partie du groupe Administrateurs, la mise à niveau échoue et génère un journal d’erreurs.

    Erreurs bloquant la mise à niveau

    Ces messages décrivent l’échec d’un test obligatoire et sont publiés dans la table Problème de Serveur MID [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 gratuits
    Ce message s’affiche lorsque moins de 1 Go d’espace disque libre est détecté 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 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 préalable à la mise à niveau vers le dossier temporaire.
    Impossible de créer un dossier <mise à niveau, vérifier 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 la vérification préalable à la mise à niveau des fichiers dans le chemin d’accès agent/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 une défaillance 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 de 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 s’affichent dans la table 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 Se connecter en tant qu’utilisateur pour le service Windows n’est pas dans l’un des formats attendus :
    • user@domain.company.com
    • domaine\utilisateur
    Impossible de rechercher les groupes d’utilisateurs de Connexion en tant que

    Lorsque l’instance tente de rechercher les appartenances au groupe de l’utilisateur connecté, elle exécute la commande net user <nom d’utilisateur> L’instance attend une certaine structure de sortie par le service Windows 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 en cours d’exécution sur la machine 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.
    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 de Serveur MID appelé mid.upgrade.run_precheck est défini sur true par défaut, ce qui permet l’exécution automatique du test de pré-mise à niveau. Pour désactiver ces tests pour un serveur MID unique, ajoutez ce paramètre au fichier de config.xml de ce serveur MID et définissez-le sur faux. 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é mid.upgrade.run_precheck. Définissez la valeur de cette propriété sur faux et laissez le champ Serveur MID vide.