Résoudre les problèmes de machine virtuelle

Si vous constatez un comportement inhabituel de la machine virtuelle, cette section vise à vous aider à résoudre le problème. Cette section décrit l’emplacement des journaux d’application et d’autres informations qui peuvent aider votre fournisseur de solutions XenServer à suivre et à résoudre le problème.

Important :

Suivez les informations de dépannage de cette section uniquement sous la direction de votre fournisseur de solutions XenServer ou de l’équipe d’assistance.

Mises à jour du fournisseur : maintenez vos machines virtuelles à jour avec les mises à jour fournies par le fournisseur du système d’exploitation. Le fournisseur a peut-être fourni des correctifs pour les pannes de machine virtuelle et d’autres défaillances.

Blocages de la machine virtuelle

Si vous rencontrez des blocages de machine virtuelle, il est possible qu’un vidage sur incident du noyau puisse vous aider à identifier le problème. Reproduisez le plantage, si possible, et suivez cette procédure. Consultez le fournisseur de votre système d’exploitation invité pour en savoir plus sur ce problème.

Le comportement de vidage sur incident de vos machines virtuelles peut être contrôlé à l’aide de la commande actions-après-crash paramètre. Les valeurs possibles sont les suivantes :

Pour activer l’enregistrement des vidages sur incident de machine virtuelle :

1. Sur l’hôte XenServer, déterminez l’UUID de la machine virtuelle souhaitée en exécutant la commande suivante :

     xe vm-list name-label=<name> params=uuid --minimal
   <!--NeedCopy-->
   

2. Modifier l’icône actions-après-crash valeur en utilisant xe vm-param-set; Par exemple, exécutez la commande suivante sur dom0 :

     xe vm-param-set uuid=<vm_uuid> actions-after-crash=preserve
   <!--NeedCopy-->
   

3. Plantez la machine virtuelle.

   1. Déterminez l’ID de domaine de la machine virtuelle en exécutant la commande suivante sur dom0 :

        xe vm-param-get uuid=<vm_uuid> param-name=dom-id
      <!--NeedCopy-->
      

   2. Exécutez le Déclencheur XL commande dans dom0 pour déclencher le crash :

        xl trigger <dom_id> nmi
      <!--NeedCopy-->
      

Comportement du vidage sur incident de la machine virtuelle Windows

Par défaut, les vidages sur incident Windows sont placés dans %SystemRoot%\Minidump dans la machine virtuelle Windows elle-même. Vous pouvez configurer le niveau de vidage des machines virtuelles en suivant le chemin d’accès au menu Poste de travail > Propriétés > Avancé > Démarrage et reprise.

Collecter les diagnostics de XenServer VM Tools pour Windows

Les outils XenServer VM pour Windows incluent un outil de diagnostic appelé xtbugtool. Cet outil est disponible sous forme de script PowerShell, xtbugtool.ps1.

De plus, nous fournissons une version obsolète du script batch pour l’exécution sur les anciennes versions de Windows, xtbugtool.bat. Dans la mesure du possible, nous vous recommandons d’utiliser la version PowerShell.

Cet outil est pris en charge par les systèmes d’exploitation suivants :

• Windows 10
• Windows 11
• Windows Server 2016
• Windows Server 2019
• Windows Server 2022
• Windows Server 2025

Pour vous aider à diagnostiquer tout problème avec XenServer VM Tools pour Windows, le script rassemble les informations suivantes à partir de votre VM Windows :

• Clés de registre pertinentes pour les installations de XenServer VM Tools pour les installations Windows
• MSinfo en NFO et versions texte
• Journaux d’événements système, de sécurité et d’application
• Les fichiers et répertoires suivants :
  • C:\ProgramData\Citrix
  • C:\ProgramData\Citrix Systems, Inc.
  • C:\ProgramData\XenServer
  • C:\Windows\Inf\setupapi.dev.log
  • C:\Windows\Inf\setupapi.setup.log
• Sortie des commandes suivantes :
  • Infosystème
  • liste de tâches /NH
  • pnputil -e
  • pnputil /enum-drivers
  • winmgmt /verifyrepository
  • ipconfig /tout

Exécution du script Powershell

Pour exécuter le script PowerShell, procédez comme suit :

1. Sur votre machine virtuelle Windows, ouvrez un terminal PowerShell en tant qu’administrateur.
2. À la Commencer Type de menu PowerShell et sélectionnez, Exécuter en tant qu’administrateur.
3. Changez le répertoire en C :\Fichiers programme\XenServer\XenOutils\diagnostics

4. Exécutez le script avec la commande suivante : xtbugtool.ps1 <path_to_output_directory>

   Si vous ne fournissez pas de valeur pour le chemin de sortie, le script est renvoyé dans le répertoire courant.

Le script crée un fichier compressé avec un nom au format xtbugtool-yyyyMMddHHmmss.zip dans le répertoire de sortie que vous spécifiez.

Exécution du script batch (obsolète)

Pour exécuter le script de traitement par lots, procédez comme suit :

1. Sur votre machine virtuelle Windows, ouvrez une invite de commande en tant qu’administrateur.
2. À la Commencer Type de menu Cmd et sélectionnez, Exécuter en tant qu’administrateur.
3. Changez le répertoire en C :\Fichiers programme\XenServer\XenOutils\diagnostics

4. Exécutez le script avec la commande suivante :

   xtbugtool.bat <path_to_output_directory>

Le script crée un fichier compressé avec un nom au format xt-bugtool-YYYY.MM.DD-xxxx.zip dans le répertoire de sortie que vous spécifiez.

Problèmes UEFI et Secure Boot

Comment modifier la résolution d’écran de la console XenCenter sur une machine virtuelle compatible UEFI ?

Pour modifier la résolution d’écran de la console XenCenter sur une machine virtuelle compatible UEFI :

1. Ouvrez le Paramètres Windows
2. Cliquez sur l’icône Mettre à jour & Sécurité bouton
3. Sous l’onglet de récupération, appuyez sur le Redémarrer maintenant bouton.
4. Accédez à Dépanner > Options avancées > Paramètres du micrologiciel UEFI.
5. Presser Redémarrer. Au redémarrage, le menu des paramètres UEFI se charge.
6. Accédez à Gestionnaire de périphériques > Configuration de la plate-forme OVMF. Cela affiche la résolution actuelle de l’écran.
7. Presser Entrer pour afficher les options de résolution d’écran.
8. Utilisez les touches fléchées pour sélectionner la résolution d’écran souhaitée et appuyez sur Entrer.
9. Presser F10 pour enregistrer les modifications et confirmer votre choix.
10. Redémarrez la machine virtuelle pour afficher la console XenCenter dans une résolution d’écran mise à jour.

Pourquoi ne puis-je pas créer une machine virtuelle de démarrage sécurisé UEFI ?

Vérifiez que le système d’exploitation de votre machine virtuelle prend en charge le mode de démarrage sécurisé UEFI. Les systèmes d’exploitation suivants prennent en charge le démarrage sécurisé :

• Windows 10 (64 bits)
• Windows 11 (64 bits)
• Windows Server 2016 (64 bits)
• Windows Server 2019 (64 bits)
• Windows Server 2022 (64 bits)
• Windows Server 2025 (64 bits) (préversion)

Pourquoi ma machine virtuelle UEFI Secure Boot ne démarre-t-elle pas ?

Si vous voyez les messages suivants sur la console de votre machine virtuelle UEFI Secure Boot et une alerte dans XenCenter, cela signifie que le processus de démarrage sécurisé a échoué et que votre machine virtuelle ne démarre pas.

Cela est généralement dû à l’installation de pilotes non signés dans la machine virtuelle. Examinez les pilotes qui ont été mis à jour ou installés depuis le dernier démarrage sécurisé.

Vous pouvez désactiver le démarrage sécurisé et démarrer la machine virtuelle en mode de configuration pour supprimer les pilotes non signés.

Important :

Avant de faire cela, sauvegardez votre machine virtuelle en prenant un instantané.

Pour transformer une VM UEFI Secure Boot en VM de démarrage UEFI, exécutez la commande suivante sur l’hôte XenServer qui héberge la VM :

  varstore-sb-state <VM_UUID> setup

Une fois que vous avez réparé votre machine virtuelle, exécutez la commande suivante pour réactiver le démarrage sécurisé :

  varstore-sb-state <VM_UUID> user

Le démarrage sécurisé provoque-t-il un problème sur ma machine virtuelle ?

Pour déterminer si un problème sur votre machine virtuelle est causé par l’activation du démarrage sécurisé pour la machine virtuelle, désactivez le démarrage sécurisé et essayez de reproduire le problème.

Pour désactiver le démarrage sécurisé, exécutez la commande suivante sur l’hôte XenServer qui héberge la machine virtuelle :

  varstore-sb-state <VM_UUID> setup

Une fois que vous avez débogué le problème, vous pouvez exécuter la commande suivante pour réactiver le démarrage sécurisé :

  varstore-sb-state <VM_UUID> user

Comment exécuter le débogage Windows sur une machine virtuelle Windows à démarrage sécurisé ?

Vous ne pouvez pas exécuter le débogage Windows sur une machine virtuelle Windows à démarrage sécurisé. Pour exécuter le débogage Windows sur votre machine virtuelle, vous pouvez effectuer l’une des opérations suivantes :

• Basculez votre machine virtuelle en mode de démarrage UEFI en exécutant la commande suivante :

     xe vm-param-set uuid=<UUID> platform:secureboot=false
  

  Redémarrez la VM.

  Une fois que vous avez débogué le problème, vous pouvez exécuter la commande suivante pour réactiver le démarrage sécurisé :

     xe vm-param-set uuid=<UUID> platform:secureboot=auto
  

  Redémarrez la VM.

• Désactivez le démarrage sécurisé en exécutant la commande suivante sur l’hôte XenServer qui héberge la machine virtuelle :

     varstore-sb-state <VM_UUID> setup
  

  Une fois que vous avez débogué le problème, vous pouvez exécuter la commande suivante pour réactiver le démarrage sécurisé :

     varstore-sb-state <VM_UUID> user
  

Pourquoi seules deux cartes réseau s’affichent-elles pour ma machine virtuelle Windows compatible UEFI ?

Même si vous avez configuré plus de deux cartes réseau lors de la création de votre machine virtuelle compatible UEFI, lorsque la machine virtuelle démarre pour la première fois, vous ne voyez que deux cartes réseau. Une fois que les outils de machine virtuelle XenServer pour Windows ont été installés dans la machine virtuelle, ces informations s’affichent correctement.

Pourquoi mes appareils émulés s’affichent-ils sous des types différents de ceux attendus sur une machine virtuelle Windows UEFI ?

Les machines virtuelles UEFI Secure Boot utilisent NVME et E1000 pour les appareils émulés. Toutefois, lorsque la machine virtuelle démarre pour la première fois, les périphériques émulés s’affichent sous différents types. Une fois que les outils de machine virtuelle XenServer pour Windows ont été installés dans la machine virtuelle, ces informations s’affichent correctement.

Pourquoi ne puis-je pas convertir mes modèles du mode BIOS au mode UEFI ou UEFI Secure Boot ?

Vous ne pouvez créer un modèle de machine virtuelle compatible UEFI qu’à partir d’un modèle fourni avec XenServer.

N’utilisez pas le xe template-param-set pour les modèles sur lesquels un élément est installé ou les modèles que vous avez créés à partir d’un instantané. Le mode de démarrage de ces instantanés ne peut pas être modifié et, si vous tentez de modifier le mode de démarrage, la machine virtuelle ne démarre pas.

Comment vérifier les variables UEFI et UEFI Secure Boot ?

Sur l’hôte XenServer où la VM UEFI ou UEFI Secure Boot est hébergée, exécutez les commandes suivantes :

   varstore-ls

Cette commande répertorie les GUID et les noms des variables disponibles. Utilisez le GUID et le nom dans la commande suivante :

  varstore-get <VM\_ID> <GUID> <name> | hexdump -C

Pourquoi ne puis-je pas utiliser un pilote « test » avec une machine virtuelle de démarrage sécurisé ?

Si vous travaillez également avec un tiers pour déboguer et résoudre les problèmes dans sa machine virtuelle de démarrage sécurisé UEFI, le tiers fourni peut fournir des pilotes non signés à des fins de test ou de vérification. Ces pilotes ne fonctionnent pas dans une machine virtuelle UEFI Secure Boot.

Demandez un pilote signé au tiers. Vous pouvez également basculer votre machine virtuelle UEFI Secure Boot en mode de configuration pour l’exécuter avec le pilote non signé.

Utilitaire Xentop

L’utilitaire xentop affiche des informations en temps réel sur un système XenServer et les domaines en cours d’exécution dans un format semi-graphique. Vous pouvez utiliser cet outil pour examiner l’état du domaine associé à une machine virtuelle.

Pour exécuter l’utilitaire xentop :

1. Connectez-vous à l’hôte XenServer via SSH ou, dans XenCenter, accédez à l’onglet Consoler de l’hôte.

2. Exécutez la commande suivante : xentop

   La console affiche des informations sur l’hôte dans un tableau. Les informations sont mises à jour périodiquement.

Colonnes de sortie

L’utilitaire xentop affiche les colonnes suivantes dans la console :

• NOM - Le nom du domaine. « Domain-0 » est le domaine de contrôle XenServer. D’autres domaines appartiennent aux machines virtuelles.

• ÉTAT - L’état du domaine. L’état peut avoir l’une des valeurs suivantes :

  • d - Le domaine se meurt
  • – le domaine est en train de fermer
  • B – Le domaine est bloqué
  • c – Le domaine a planté
  • p – le domaine est mis en pause
  • r – le domaine s’exécute activement sur l’un des processeurs
• Processeur (s) - L’utilisation du processeur du domaine en secondes
• Processeur (%) - L’utilisation du processeur du domaine en pourcentage
• MEM(k) - L’utilisation actuelle de la mémoire du domaine en KiB
• MEM(%) - L’utilisation actuelle de la mémoire du domaine en pourcentage
• MAXMEM(k) - L’utilisation maximale de la mémoire du domaine en Kio
• MAXMEM(%) - L’utilisation maximale de la mémoire du domaine en pourcentage
• VCPUS - Le nombre de processeurs virtuels attribués au domaine
• FILETS - Le nombre de réseaux virtuels utilisés par le domaine
• NETTX(k) - Le montant total du tx réseau en Kio
• NETRX(k) - Le montant total de rx réseau en Kio
• VBDS - Le nombre de périphériques de bloc virtuel
• VBD_OO - Le nombre total de fois où le VBD a rencontré une erreur de demandes épuisées. Lorsque cela se produit, les demandes d’E/S pour le VBD sont retardées.
• VBD_RD - Le nombre total de demandes de lecture VBD
• VBD_WR - Le nombre total de demandes d’écriture VBD
• VBD_RSECT - Les secteurs de lecture VBD
• VBD_WSECT - Les secteurs d’écriture VBD

Paramètres Xentop

Vous pouvez utiliser les paramètres suivants pour configurer la sortie de la commande xentop :

• -h - Affiche la commande help pour la commande xentop.
• -V - Affiche la version de la commande xentop.
• -d ou –delay=SECONDES - Définissez le nombre de secondes entre les mises à jour
• -n ou –réseau - Sortie des données pour chaque réseau VIF associé à un domaine
• -x ou –vbds - Sortie des données de chaque périphérique de bloc VBD associé à un domaine
• -r ou en-tête-répété - Répétez l’en-tête du tableau avant chaque domaine
• -v ou –vcpus - Sortie des données pour chaque vCPU associé à un domaine
• -Je ou –Itérations - Nombre d’itérations (mises à jour) à afficher avant la sortie de xentop
• -f ou –nom-complet - Sortie du nom de domaine complet au lieu d’un nom tronqué

Vous pouvez également configurer la plupart de ces paramètres à partir de l’utilitaire xentop.