Résoudre les problèmes de machine virtuelle

Important :

La mise à jour cumulative 1 de Citrix Hypervisor 8.2 prend fin le 25 juin 2025. Planifiez votre mise à niveau vers XenServer 8 dès maintenant pour assurer une transition en douceur et un support continu. Pour plus d’informations, consultez Mise à niveau.

Si vous utilisez vos fichiers de licence Citrix Virtual Apps and Desktops pour obtenir une licence pour vos hôtes Citrix Hypervisor 8.2 Cumulative Update 1, ces fichiers de licence ne sont pas compatibles avec XenServer 8. Avant la mise à niveau, vous devez acquérir les fichiers de licence socket XenServer Premium Edition à utiliser avec XenServer 8. Ces fichiers de licence de socket sont disponibles en tant que droits des abonnements Citrix pour le cloud privé, Citrix Universal Hybrid Multi-Cloud, Citrix Universal MSP et Citrix Platform License pour l’exécution de vos charges de travail Citrix. Les clients Citrix qui n’ont pas encore migré vers ces nouveaux abonnements peuvent demander à participer à une promotion gratuite pour 10 000 licences de sockets XenServer Premium Edition. Pour plus d’informations, consultez XenServer.

Si vous n’obtenez pas de licence compatible pour XenServer 8 avant la mise à niveau, lorsque vous mettez à niveau vos hôtes, ils reviennent à l’édition d’essai de 90 jours. L’édition d’essai offre les mêmes fonctionnalités que l’édition Premium, avec quelques limitations. Pour plus d’informations, consultez Présentation des licences XenServer 8.

Citrix propose deux formes de support :

• Assistance gratuite et en libre-service sur le Site web de Citrix
• Services d’assistance payants, que vous pouvez acheter sur le site d’assistance.

Avec le support technique Citrix, vous pouvez ouvrir une demande de support en ligne ou contacter le centre de support par téléphone si vous rencontrez des difficultés techniques.

Le Prise en charge Citrix Le site héberge plusieurs ressources qui peuvent vous être utiles si vous rencontrez un comportement inhabituel, des plantages ou d’autres problèmes. Les ressources comprennent : les forums d’assistance, les articles de la base de connaissances et la documentation du produit.

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 d’hyperviseur Citrix à 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 d’hyperviseur Citrix 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 le serveur Citrix Hypervisor, 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

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. Dans Citrix Hypervisor 8.2, seuls les systèmes d’exploitation suivants prennent en charge le démarrage sécurisé : Windows 10 (64 bits), Windows Server 2016, Windows Server 2019, Windows Server 2022.

Vérifiez que votre serveur Citrix Hypervisor est démarré en mode UEFI. Vous ne pouvez créer des machines virtuelles UEFI Secure Boot que sur un serveur Citrix Hypervisor sur lequel les certificats Secure Boot sont présents. Les certificats de démarrage sécurisé ne sont présents que sur les serveurs démarrés en mode UEFI ou sur les serveurs du même pool qu’un serveur démarré en mode UEFI. Pour plus d’informations, consultez Démarrage réseau.

Vérifiez que le serveur Citrix Hypervisor démarré par UEFI est inclus dans le Liste de compatibilité matérielle. Les serveurs plus anciens peuvent ne pas inclure les certificats de démarrage sécurisé lorsqu’ils sont démarrés en mode UEFI.

Comment savoir si un serveur Citrix Hypervisor dispose des certificats Secure Boot ?

Si votre serveur Citrix Hypervisor est démarré en mode UEFI, les certificats Secure Boot sont disponibles sur le serveur. Les serveurs Citrix Hypervisor partagent leurs certificats avec d’autres serveurs du même pool de ressources. Si vous avez un serveur démarré UEFI dans votre pool de ressources, tous les serveurs de ce pool disposent des certificats Secure Boot.

Exécutez la commande suivante sur un serveur Citrix Hypervisor :

  xe pool-param-get param-name=uefi-certificates uuid=<pool-uuid> | wc -c

S’il renvoie une valeur supérieure à zéro, les certificats Secure Boot sont présents.

Pour vérifier que les certificats sont valides, exécutez la commande suivante sur votre serveur Citrix Hypervisor :

  xe pool-param-get uuid=$(xe pool-list --minimal)  param-name=uefi-certificates|base64 -d|tar tv
  -rw-r--r-- root/root      1600 2019-11-11 17:09 KEK.auth
  -rw-r--r-- root/root      3212 2019-11-11 17:09 db.auth
<!--NeedCopy-->

Si les certificats Secure Boot sont absents, exécutez la commande suivante sur votre serveur Citrix Hypervisor :

  ls /sys/firmware/efi/efivars | grep KEK

Si cette commande renvoie vide, les machines virtuelles de démarrage sécurisé ne peuvent pas être créées sur ce serveur, car les certificats requis ne figurent pas dans le microprogramme UEFI.

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 machine virtuelle UEFI Secure Boot en machine virtuelle de démarrage UEFI, exécutez la commande suivante sur le serveur Citrix Hypervisor qui héberge la machine virtuelle :

  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 le serveur Citrix Hypervisor 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 le serveur Citrix Hypervisor 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. Ces informations s’affichent correctement après l’installation de XenServer VM Tools pour Windows dans la VM.

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. Ces informations s’affichent correctement après l’installation de XenServer VM Tools pour Windows dans la VM.

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 Citrix Hypervisor.

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 le serveur Citrix Hypervisor sur lequel la machine virtuelle 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 d’hyperviseur Citrix 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 Citrix Hypervisor via SSH ou, dans XenCenter, accédez à l’icône Consoler de l’hôte.

2. Exécutez la commande suivante : xentop

   La console affiche des informations sur le serveur 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. « Domaine-0 » est le domaine de contrôle de l’hyperviseur Citrix. 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.