Le logiciel d'installation et de mise à niveau vous permet d'identifier sur la machine hôte les problèmes susceptibles de provoquer l'échec d'une installation, d'une mise à niveau ou d'une migration.

Pour les installations, les mises à niveau et les migrations interactives, les erreurs ou les avertissements s'affichent dans le dernier panneau du programme d'installation dans lequel vous devez confirmer ou annuler l'installation ou la mise à niveau. Pour les installations, les mises à niveau ou les migrations à l'aide d'un script, les erreurs ou les avertissements sont consignés dans le fichier journal d'installation. Vous pouvez également consulter les notes de mise à jour du produit pour consulter les problèmes connus.

vSphere Update Manager fournit des messages personnalisés pour ces erreurs ou avertissements. Pour afficher les erreurs et les avertissements d'origine retournés par le script de précontrôle au cours d'une analyse de mise à niveau d'hôte Update Manager, consultez le fichier journal vmware-vum-server-log4cpp.log.

Le guide Mise à niveau vSphere explique comment utiliser les produits VMware et leurs fonctions. Si vous rencontrez des problèmes ou des erreurs qui ne sont pas décrits dans ce guide, vous pourrez trouver une solution dans la base de connaissances VMware. Vous pouvez également utiliser les forums communautaires de VMware pour échanger avec d'autres personnes ayant rencontré le même problème et pour demander de l'aide, ou vous pouvez ouvrir une demande de support pour obtenir de l'aide de professionnels du service VMware.

Collecter les journaux d'installation de vCenter Server Appliance

Vous pouvez collecter les fichiers journaux d'installation et vérifier ces fichiers pour identifier la source d'une panne si vCenter Server Appliance ne répond plus lors du démarrage initial.

Procédure

  1. Accédez au shell de vCenter Server Appliance.
    Option Description
    Si vous disposez d'un accès direct au dispositif Appuyez sur Alt+F1.
    Pour vous connecter à distance Utilisez SSH ou une autre connexion de console à distance pour démarrer une session sur le dispositif.
  2. Entrez un nom d'utilisateur et un mot de passe que le dispositif reconnaît.
  3. Dans le shell du dispositif, exécutez la commande pi shell pour accéder au shell de dépistage du dispositif.
  4. Dans le shell de dépistage, exécutez le script vc-support.sh pour générer un bundle de support.
    Cette commande génère un fichier .tgz dans /storage/log.
  5. Exportez le bundle de support généré dans le dossier [email protected]:/tmp. 
    scp /var/tmp/vc-etco-vm-vlan11-dhcp-63-151.eng.vmware.com-2014-02-28--21.11.tgz [email protected]:/tmp
  6. Déterminez quel script firstboot a échoué. 
    cat /var/log/firstboot/firstbootStatus.json

Que faire ensuite

Pour identifier les causes potentielles de l'échec, examinez le fichier journal du script firstboot qui a échoué.

Erreurs et avertissements renvoyés par le script de précontrôle d'installation et de mise à niveau

Le script de précontrôle d'installation et de mise à niveau effectue des tests pour identifier sur la machine hôte les problèmes susceptibles de provoquer l'échec d'une installation, d'une mise à niveau ou d'une migration.

Pour les installations, les mises à niveau et les migrations interactives, les erreurs ou les avertissements s'affichent dans le dernier écran du programme d'installation de l'IUG dans lequel vous devez confirmer ou annuler l'installation ou la mise à niveau. Pour les installations, les mises à niveau ou les migrations à l'aide d'un script, les erreurs et les avertissements sont consignés dans le fichier journal d'installation.

vSphere Update Manager fournit des messages personnalisés pour ces erreurs ou avertissements. Pour afficher les erreurs et les avertissements d'origine renvoyés par le script de prévérification au cours d'une analyse de mise à niveau d'hôte Update Manager, consultez le fichier journal d'Update Manager vmware-vum-server-log4cpp.log.

Tableau 1. Codes d'erreur et d'avertissement renvoyés par le script de précontrôle d'installation ou de mise à niveau
Erreur/Avertissement Description
64BIT_LONGMODESTATUS Le processeur hôte doit être de 64 bits.
COS_NETWORKING Avertissement. Une adresse IPv4 a été détectée dans une carte réseau virtuelle de console de service activée qui n'a aucune adresse correspondante dans le même sous-réseau de VMkernel. Un avertissement séparé s'affiche pour chaque occurrence de ce type.
CPU_CORES L'hôte doit disposer d'au moins deux cœurs.
DISTRIBUTED_VIRTUAL_SWITCH Si le logiciel VEM (Virtual Ethernet Module) de Cisco se trouve sur l'hôte, le test vérifie que la mise à niveau contient également le logiciel VEM. Le test détermine également si la mise à niveau prend en charge la même version de VSM (Virtual Supervisor Module) de Cisco que la version existante sur l'hôte. Si le logiciel est manquant ou est compatible avec une version différente de VSM, le test renvoie un avertissement. Le résultat indique quelle version du logiciel VEM était attendue sur l'image ISO de la mise à niveau et quelles versions, le cas échéant, ont été trouvées. Vous pouvez utiliser ESXi Image Builder CLI pour créer un fichier ISO d'installation personnalisée qui inclut la version appropriée du logiciel VEM.
HARDWARE_VIRTUALIZATION Avertissement. Si le processeur de l'hôte ne dispose pas d'une virtualisation matérielle ou si la virtualisation matérielle n'est pas activée dans le BIOS de l'hôte, les performances sont réduites. Vous pouvez activer la virtualisation matérielle dans le panneau d'options de démarrage de la machine hôte. Voir la documentation du fournisseur du matériel.
MD5_ROOT_PASSWORD Ce test vérifie si le mot de passe racine est codé au format MD5. Si un mot de passe n'est pas codé au format MD5, il pourrait être significatif uniquement jusqu'au huitième caractère. Dans ce cas, tous les caractères suivant le huitième caractère ne sont plus authentifiés après la mise à niveau, ce qui peut poser un problème de sécurité. Pour résoudre ce problème, consultez l'article 1024500 de la base de connaissances.
MEMORY_SIZE L'hôte nécessite la quantité de mémoire indiquée pour pouvoir effectuer la mise à niveau.
PACKAGE_COMPLIANCE Mise à niveau de vSphere Update Manager vers vSphere Lifecycle Manager uniquement. Ce test compare le logiciel existant sur l'hôte au logiciel contenu sur le fichier ISO de mise à niveau pour déterminer si la mise à niveau de l'hôte a réussi. Si un des modules est manquant ou si sa version est antérieure à celle du module sur l'ISO de mise à niveau, le test renvoie une erreur. Les résultats du test indiquent quel logiciel a été trouvé sur l'hôte et quel logiciel a été trouvé sur l'image ISO de mise à niveau.
PARTITION_LAYOUT Vous pouvez mettre à niveau ou migrer des logiciels uniquement si au moins une partition VMFS sur le disque est en cours de mise à niveau. La partition VMFS doit commencer après le secteur 1843200.
POWERPATH Le test recherche l'installation du logiciel EMC PowerPath qui est constitué d'un module CIM et d'un module de noyau. Si l'un de ces composants se trouve sur l'hôte, le test vérifie que les composants correspondants, tels que le module CIM ou VMkernel, existent également dans la mise à niveau. S'ils n'existent pas, le test renvoie un avertissement indiquant quels composants PowerPath était attendus dans le fichier ISO de mise à niveau et quels sont ceux qui ont été, le cas échéant, effectivement trouvés.
PRECHECK_INITIALIZE Ce test vérifie que le script de prévérification peut être exécuté.
SANE_ESX_CONF Le fichier /etc/vmware/esx.conf doit exister sur l'hôte.
SPACE_AVAIL_ISO vSphere Update Manager seulement. Le disque hôte doit disposer d'un espace libre suffisant pour pouvoir stocker le contenu du CD ou DVD du programme d'installation.
SPACE_AVAIL_CONFIG Mise à niveau de vSphere Update Manager vers vSphere Lifecycle Manager uniquement. Le disque hôte doit disposer d'un espace libre suffisant pour pouvoir stocker la configuration héritée entre les redémarrages.
SUPPORTED_ESX_VERSION Vous pouvez mettre à niveau ou migrer vers ESXi 8.0 seulement à partir d'hôtes ESXi version  6.0.
TBOOT_REQUIRED Ce message s'applique uniquement à la mise à niveau de vSphere Update Manager vers vSphere Lifecycle Manager. La mise à niveau échoue et renvoie ce message d'erreur lorsque le système hôte fonctionne en mode de démarrage approuvé (tboot), mais le fichier ISO de mise à niveau ESXi ne contient aucun VIB tboot. Ce test empêche l'exécution d'une mise à niveau susceptible de compromettre la sécurité de l'hôte.
UNSUPPORTED_DEVICES Avertissement. Le test recherche les périphériques non compatibles. Certains périphériques PCI ne sont pas compatibles avec ESXi 8.0.
UPDATE_PENDING

Ce test vérifie l'hôte pour les installations VIB qui nécessitent un redémarrage. Ce test échoue si un ou plusieurs VIB sont installés mais que l'hôte n'a pas encore été redémarré. Dans ces conditions, le script de vérification préalable ne parvient pas à déterminer de manière fiable quels modules sont actuellement installés sur l'hôte. Si le test échoue, il n'est pas prudent de se fier au reste des tests de vérification préalable pour déterminer si une mise à niveau est sûre.

Si vous rencontrez cette erreur, redémarrez l'hôte et retentez la mise à niveau.

Problèmes de mise à niveau d'une instance de vCenter Server contenant des profils d'hôte

Voici les problèmes les plus courants pouvant se produire pendant une mise à niveau de vCenter Server vers la version 8.0 qui contient des profils d'hôte.

  • Pour les problèmes se produisant lors d'une mise à niveau de vCenter Server ou d'ESXi, reportez-vous à la section Dépannage d'une mise à niveau vSphere.
  • Si la mise à niveau de vCenter Server 6.7 ou 7.0 (qui contient des profils d'hôte avec une version antérieure à 6.7) échoue, reportez-vous à l'article KB 52932.
  • Si l'erreur There is no suitable host in the inventory as reference host for the profile Host Profile. The profile does not have any associated reference host se produit, reportez-vous à l'article KB 2150534.
  • Si une erreur se produit lors de l'importation d'un profil d'hôte dans un inventaire vide de vCenter Server, reportez-vous à la rubrique Profils d'hôte vSphere pour l'erreur L'hôte de référence n'est pas disponible.
  • Si une vérification de conformité du profil hôte échoue pour la banque de données NFS, reportez-vous à la section Profils d'hôte vSphere pour l'erreur Profil d'hôte sans banque de données NFS.
  • Si la vérification de conformité échoue avec une erreur pour l'option UserVars.ESXiVPsDisabledProtocols, lorsqu'un hôte ESXi mis à niveau vers la version 8.0 est attaché à un profil d'hôte avec la version 6.7, reportez-vous aux Notes de mise à jour de VMware vSphere 8.0.

Restaurer une instance de vCenter Server sous Windows lors de l'échec d'une mise à niveau de vCenter Server

Vous pouvez restaurer une instance de vCenter Server sous Windows lorsqu'une mise à niveau de vCenter Server avec une instance de Platform Services Controller échoue après l'étape d'exportation et que l'environnement hérité a été désinstallé.

Conditions préalables

La restauration de vCenter Server s'applique lorsque toutes les conditions suivantes sont réunies :

  • Vous devez avoir accès à vCenter Server pour la machine Windows.
  • L'instance de vCenter Server est attachée à une instance de Platform Services Controller externe.
  • La mise à niveau de l'instance de vCenter Server attachée à l'instance de Platform Services Controller prend un état d'échec après l'étape d'exportation et la désinstallation de l'instance de vCenter Server héritée.
  • Vérifiez que la restauration de vCenter Server s'est déroulée avec succès en cas d'échec de la mise à niveau et qu'aucune entrée périmée de journal d'échec de mise à niveau ne demeure.

Pour la méthode de restauration 1 :

  • Pour nettoyer les données de l'instance de vCenter Server Appliance 7.0 pour l'instance héritée de Platform Services Controller, reportez-vous à KB 2106736.
  • Utilisez un snapshot de la base de données vCenter Server effectué avant le démarrage de la mise à niveau de vCenter Server.

Pour la méthode de restauration 2 :

  • Utilisez un snapshot désactivé de vCenter Server avant la mise à niveau de vCenter Server.
  • Utilisez un snapshot Platform Services Controller effectué après la mise à niveau du nœud Platform Services Controller et avant le démarrage de la mise à niveau de vCenter Server.
  • Utilisez un snapshot vCenter Server effectué après la mise à niveau de l'instance de Platform Services Controller et avant le démarrage de la mise à niveau de vCenter Server.

Procédure

  • ♦ Vous pouvez restaurer une instance de vCenter Server héritée à l'aide la méthode de restauration 1 ou la méthode de restauration 2.
    • Utilisez la méthode de restauration 1.
      1. Nettoyez manuellement les données de l'instance de vCenter Server Appliance de Platform Services Controller.
      2. Restaurez la base de données vCenter Server héritée à partir d'une sauvegarde effectuée avant la mise à niveau.
      3. Faites pointer l'instance héritée de vCenter Server vers l'instance de Platform Services Controller, ainsi que vers la base de données contenant les données restaurées.
      4. Vérifiez que les services de vCenter Server sont en cours d'exécution.
    • Utilisez la méthode de restauration 2.
      1. Restaurez l'instance de Platform Services Controller à partir d'un snapshot au moment où vous vous apprêtiez à démarrer la mise à niveau de vCenter Server. Vous pouvez utiliser une sauvegarde de configuration Windows ou utiliser une autre approche de sauvegarde et de restauration pour revenir au snapshot.
      2. Restaurez l'instance de vCenter Server à partir d'un snapshot.
      3. Restaurez une base de données vCenter Server à partir d'un snapshot.
      4. Vérifiez que les services de vCenter Server sont en cours d'exécution.
    Pour la méthode de restauration 2, toutes les données écrites sur l'instance de Platform Services Controller seront perdues une fois la mise à niveau de vCenter Server démarrée, lorsque vous effectuerez la restauration à partir du snapshot Platform Services Controller effectué avant cet instant « T ».

Collecter les journaux pour dépanner les hôtes ESXi

Vous pouvez collecter des fichiers journaux d'installation ou de mise à niveau pour ESXi qui vous aident à identifier la cause de l'échec d'une installation ou d'une mise à niveau.

Solution

  1. Entrez la commande vm-support dans ESXi Shell ou via SSH.
  2. Accédez au répertoire /var/tmp/.
  3. Récupérez les fichiers journaux à partir du fichier .tgz.