XenServer VM Tools pour Windows

XenServer VM Tools pour Windows (anciennement Citrix VM Tools) fournit des services d’E/S hautes performances sans la surcharge de l’émulation de périphérique traditionnelle. XenServer VM Tools pour Windows se compose de pilotes d’E/S (également appelés pilotes paravirtualisés ou pilotes PV) et de l’agent de gestion.

XenServer VM Tools pour Windows doit être installé sur chaque VM Windows pour que la configuration de la VM soit entièrement prise en charge. Une machine virtuelle fonctionne sans eux, mais les performances sont entravées.

La version de XenServer VM Tools pour Windows est mise à jour indépendamment de la version de Citrix Hypervisor. Assurez-vous que vos outils de machine virtuelle XenServer pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos machines virtuelles et dans tous les modèles que vous utilisez pour créer vos machines virtuelles. Pour plus d’informations sur la dernière version des outils, consultez Mises à jour de XenServer VM Tools pour Windows ou Quoi de neuf.

Installer XenServer VM Tools

Remarque :

Pour installer XenServer VM Tools pour Windows sur une machine virtuelle Windows, celle-ci doit exécuter Microsoft .NET Framework version 4.0 ou ultérieure.

Avant d’installer les outils de machine virtuelle XenServer pour Windows, assurez-vous que votre machine virtuelle est configurée pour recevoir les pilotes d’E/S de Windows Update. Windows Update est la méthode recommandée pour recevoir les mises à jour des pilotes d’E/S. Toutefois, si Windows Update n’est pas une option disponible pour votre machine virtuelle, vous pouvez également recevoir des mises à jour des pilotes d’E/S via l’agent de gestion ou mettre à jour les pilotes manuellement. Pour plus d’informations, consultez Mettre à jour les pilotes d’E/S.

Pour installer XenServer VM Tools pour Windows :

1. Nous vous recommandons de créer un snapshot de votre machine virtuelle avant d’installer ou de mettre à jour les outils de machine virtuelle XenServer.

2. Téléchargez le fichier XenServer VM Tools pour Windows à partir du fichier Page de téléchargement de Citrix Hypervisor.

   1. Connectez-vous à votre compte Citrix pour accéder aux fichiers téléchargeables.
   2. Développez les sections de produit sur la page de téléchargement de Citrix Hypervisor et cliquez sur n’importe quelle version prise en charge de Citrix Hypervisor.

   3. Sur la page du produit, rendez-vous dans la section Composants principaux de l’hyperviseur Citrix section.

      Les outils XenServer VM pour Windows sont disponibles en version 32 bits et 64 bits.

   4. Téléchargez le fichier MSI et vérifiez votre téléchargement par rapport à la valeur SHA256 fournie.

3. Copiez le fichier sur votre machine virtuelle Windows ou sur un lecteur partagé auquel la machine virtuelle Windows peut accéder.

4. Exécutez le managementagentxXX.msi pour commencer l’installation de XenServer VM Tools.

    Msiexec.exe /package managementagentxXX.msi
   

5. Suivez les instructions du programme d’installation.

   • Suivez les instructions de l’assistant pour accepter le contrat de licence et choisir un dossier de destination.

   • Personnalisez les paramètres sur le Paramètres d’installation et de mise à jour page. Le Configuration de l’agent de gestion Windows de l’hyperviseur Citrix L’Assistant affiche les paramètres recommandés. Par défaut, l’Assistant affiche les paramètres suivants :

     • Installer les pilotes d’E/S maintenant
     • Autoriser les mises à jour automatiques de l’agent de gestion
     • Interdire la mise à jour automatique des pilotes d’E/S par l’agent de gestion
     • Envoyer des informations d’utilisation anonymes à Citrix

     Si vous ne souhaitez pas autoriser la mise à jour automatique de l’Agent de gestion, sélectionnez Interdire les mises à jour automatiques de l’agent de gestion dans la liste.

     Si vous souhaitez autoriser l’agent de gestion à mettre à jour automatiquement les pilotes d’E/S, sélectionnez Autoriser les mises à jour automatiques des pilotes d’E/S par l’agent de gestion. Toutefois, nous vous recommandons d’utiliser Windows Update pour mettre à jour les pilotes d’E/S, et non l’agent de gestion.

     Remarque :

     Si vous avez choisi de recevoir les mises à jour des pilotes d’E/S via le mécanisme Windows Update, n’autorisez pas l’agent de gestion à mettre à jour automatiquement les pilotes d’E/S.

     Si vous ne souhaitez pas partager d’informations d’utilisation anonymes avec Citrix, désactivez l’icône Envoyer des informations d’utilisation anonymes à Citrix case à cocher. Les informations transmises à Citrix contiennent l’UUID de la machine virtuelle qui demande la mise à jour. Aucune autre information relative à la machine virtuelle n’est collectée ou transmise à Citrix.

   • Cliquer Prochain Et puis Installer pour lancer le processus d’installation de XenServer VM Tools pour Windows.

6. Redémarrez la machine virtuelle lorsque vous êtes invité à terminer le processus d’installation.

Remarque :

Les outils XenServer VM pour Windows peuvent demander à redémarrer avec /quiet /norestart ou /quiet /forcerestart spécifié une fois que la machine virtuelle a déjà été redémarrée une fois dans le cadre de l’installation.

Les pilotes d’E/S sont automatiquement installés sur une machine virtuelle Windows qui peut recevoir des mises à jour de Windows Update. Toutefois, nous vous recommandons d’installer XenServer VM Tools pour Windows afin d’installer l’agent de gestion et de maintenir une configuration prise en charge.

Les clients qui installent XenServer VM Tools pour Windows ou l’agent de gestion via RDP peuvent ne pas voir l’invite de redémarrage, car elle n’apparaît que sur la session de la console Windows. Pour vous assurer de redémarrer votre machine virtuelle (si nécessaire) et de la mettre dans un état optimisé, spécifiez l’option de redémarrage forcé dans RDP. L’option de redémarrage forcé redémarre la machine virtuelle uniquement si cela est nécessaire pour la ramener à un état optimisé.

Installation silencieuse

Pour installer XenServer VM Tools pour Windows en mode silencieux et pour empêcher le système de redémarrer, exécutez la commande suivante :

  Msiexec.exe /package managementagentx86.msi /quiet /norestart
  Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

Une installation non interactive, mais non silencieuse, peut être obtenue en exécutant :

  Msiexec.exe managementagentx86.msi /passive
  Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->

Pour personnaliser les paramètres d’installation, utilisez les paramètres suivants avec les commandes d’installation silencieuse :

Par exemple, pour effectuer une installation silencieuse des outils qui n’autorise pas les futures mises à jour automatiques de l’agent de gestion et n’envoie pas d’informations anonymes à Citrix, exécutez l’une des commandes suivantes :

  Msiexec.exe /package managementagentx86.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
  Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO IDENTIFYAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->

Pour les installations interactives, silencieuses et passives, après le prochain redémarrage du système, il peut y avoir plusieurs redémarrages automatisés avant que XenServer VM Tools pour Windows ne soit entièrement installé. Ce comportement est également le cas pour les installations avec le /norestart indicateur spécifié. Cependant, pour les installations où le /norestart est fourni, le redémarrage initial peut être lancé manuellement.

Les outils XenServer VM pour Windows sont installés par défaut dans le C :\Program Files\Citrix\XenOutils sur la machine virtuelle.

Remarques  :

• Pour installer XenServer VM Tools pour Windows sur une machine virtuelle Windows, celle-ci doit exécuter Microsoft .NET Framework version 4.0 ou ultérieure.
• Le /tranquille s’applique uniquement aux boîtes de dialogue d’installation, mais pas à l’installation du pilote de périphérique. Lorsque le /tranquille est spécifié, l’installation du pilote de périphérique demande l’autorisation de redémarrer si nécessaire.
  • Quand /quiet /norestart est spécifié, le système ne redémarre pas une fois l’installation complète des outils terminée. Ce comportement est indépendant de ce que l’utilisateur spécifie dans la boîte de dialogue de redémarrage.
  • Quand /quiet /forcerestart est spécifié, le système redémarre une fois l’installation complète des outils terminée. Ce comportement est indépendant de ce que l’utilisateur spécifie dans la boîte de dialogue de redémarrage.
  • Lorsque l’installation du pilote de périphérique demande l’autorisation de redémarrer, une installation d’outils avec le tranquille Le paramètre spécifié peut toujours être en cours. Utilisez le Gestionnaire des tâches pour vérifier si le programme d’installation est toujours en cours d’exécution.

Avertissement :

L’installation ou la mise à niveau de XenServer VM Tools pour Windows peut entraîner la modification du nom convivial et de l’identifiant de certaines cartes réseau. Tout logiciel configuré pour utiliser un adaptateur particulier peut devoir être reconfiguré après l’installation ou la mise à niveau de XenServer VM Tools for Windows.

Mettre à jour XenServer VM Tools pour Windows

Citrix Hypervisor dispose d’un mécanisme plus simple pour mettre à jour automatiquement les pilotes d’E/S (pilotes PV) et l’agent de gestion pour les machines virtuelles Windows. Ce mécanisme permet aux clients d’installer les mises à jour dès qu’elles sont disponibles.

Assurez-vous que vos outils de machine virtuelle XenServer pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos machines virtuelles et dans tous les modèles que vous utilisez pour créer vos machines virtuelles.

Nous vous recommandons de créer un snapshot de votre machine virtuelle avant d’installer ou de mettre à jour les outils de machine virtuelle XenServer.

Important :

Si vous utilisez actuellement les pilotes 8.2.x.x ou une version antérieure et que vous souhaitez utiliser le fichier MSI de l’agent de gestion pour mettre à jour vers la dernière version des pilotes, vous devez utiliser le Gestionnaire de périphériques pour désinstaller les pilotes 8.2.x.x de votre machine virtuelle avant d’installer ces pilotes. Si vous ne terminez pas cette étape, le processus d’installation de MSI échoue.

Nous vous recommandons d’utiliser les paramètres suivants pour mettre à jour les différents composants de XenServer VM Tools pour Windows :

1. Définissez la valeur de la clé de registre suivante sur une valeur REG_DWORD de « 3 » : HLKM\System\CurrentControlSet\services\xenbus_monitor\Paramètres\Redémarrage automatique
2. Assurez-vous que votre machine virtuelle est configurée pour recevoir les pilotes d’E/S de Windows Update.
3. Configurez l’agent de gestion pour qu’il se mette à jour automatiquement.

Le État de virtualisation sur la section Généralités dans XenCenter spécifie si la machine virtuelle peut recevoir des mises à jour de Windows Update. Vous pouvez activer les mises à jour du pilote d’E/S via Windows Update lors de la sélection d’un modèle de machine virtuelle dans le Nouvelle machine virtuelle dans XenCenter. Pour plus d’informations sur l’activation des mises à jour des pilotes d’E/S via Windows Update, consultez Vue d’ensemble des étapes de création de machine virtuelle. Si vous ne souhaitez pas recevoir de mises à jour de pilotes d’E/S à partir de Windows Update, désactivez Windows Update sur votre machine virtuelle ou spécifiez une stratégie de groupe.

Important :

Assurez-vous que tous les redémarrages de machine virtuelle demandés sont terminés dans le cadre de la mise à jour. Plusieurs redémarrages peuvent être nécessaires. Si tous les redémarrages demandés ne sont pas terminés, cela peut entraîner un comportement inattendu.

Les sections suivantes contiennent des informations sur la mise à jour automatique de l’agent de gestion et des pilotes d’E/S.

Mettre à jour l’agent de gestion

Citrix Hypervisor vous permet de mettre à jour automatiquement l’agent de gestion sur les machines virtuelles Windows nouvelles et existantes. Par défaut, Citrix Hypervisor permet la mise à jour automatique de l’agent de gestion. Cependant, il ne permet pas à l’agent de gestion de mettre à jour automatiquement les pilotes d’E/S. Vous pouvez personnaliser les paramètres de mise à jour de l’agent de gestion lors de l’installation de XenServer VM Tools pour Windows. La mise à jour automatique de l’agent de gestion s’effectue de manière transparente et ne redémarre pas votre machine virtuelle. Dans les scénarios où un redémarrage de la machine virtuelle est requis, un message s’affiche dans l’onglet Console de la machine virtuelle pour informer les utilisateurs de l’action requise.

Vous pouvez obtenir les mises à jour automatiques de l’agent de gestion, à condition que :

• Vous exécutez Citrix Hypervisor 8.2 Premium Edition ou avez accès à Citrix Hypervisor via les droits Citrix Virtual Apps and Desktops ou Citrix DaaS.

• Vous avez installé XenServer VM Tools pour Windows fourni avec Citrix Hypervisor 7.0 ou supérieur

• La machine virtuelle Windows a accès à Internet

Gérer les mises à jour automatiques à l’aide de l’interface de ligne de commande

Citrix Hypervisor vous permet d’utiliser la ligne de commande pour gérer la mise à jour automatique des pilotes d’E/S et de l’agent de gestion. Vous pouvez exécuter msiexec.exe avec les arguments listés dans le tableau suivant pour spécifier si les pilotes d’E/S et l’Agent de gestion sont automatiquement mis à jour. Pour plus d’informations sur l’installation de XenServer VM Tools pour Windows à l’aide de msiexec.exevoir Installation silencieuse.

Remarque :

Pour les machines virtuelles gérées à l’aide de PVS ou MCS, les mises à jour automatiques sont désactivées automatiquement lorsque le VDA Citrix Virtual Desktops est présent et qu’il signale que la machine n’est pas persistante.

Par exemple :

  msiexec.exe /i managementagentx64.msi ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
      ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

Activer les mises à jour de l’agent de gestion

Pour activer la mise à jour automatique de l’agent de gestion par machine virtuelle :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécutez la commande suivante :

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_DWORD /v DisableAutoUpdate /d 0
   <!--NeedCopy-->
   

Pour activer la mise à jour automatique de l’agent de gestion par pool, exécutez la commande suivante dans la console hôte :

  xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=true
<!--NeedCopy-->

Désactiver les mises à jour de l’agent de gestion

Pour désactiver la mise à jour automatique de l’agent de gestion pour chaque machine virtuelle :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécutez la commande suivante :

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_DWORD /v DisableAutoUpdate /d 1
   <!--NeedCopy-->
   

Pour désactiver la mise à jour automatique de l’agent de gestion pour chaque pool, exécutez la commande suivante dans la console hôte :

  xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->

Rediriger les mises à jour de l’agent de gestion

Citrix Hypervisor permet aux clients de rediriger les mises à jour de l’agent de gestion vers un serveur Web interne avant qu’elles ne soient installées. Cette redirection permet aux clients d’examiner les mises à jour avant qu’elles ne soient automatiquement installées sur la machine virtuelle.

Pour rediriger les mises à jour de l’Agent de gestion :

L’agent de gestion utilise un fichier de mises à jour pour obtenir des informations sur les mises à jour disponibles. Le nom de ce fichier de mises à jour dépend de la version de l’agent de gestion que vous utilisez :

• Pour Management Agent 9.2.1.35 et versions ultérieures, utilisez https://pvupdates.vmd.citrix.com/autoupdate.v1.json.
• Pour Management Agent 9.0.0.0 à 9.2.0.27 https://pvupdates.vmd.citrix.com/updates.v9.json.

Procédez comme suit pour rediriger les mises à jour de l’agent de gestion :

1. Téléchargez le fichier de mises à jour.

2. Téléchargez les fichiers MSI de l’agent de gestion référencés dans le fichier de mises à jour.

3. Chargez les fichiers MSI sur un serveur Web interne auquel vos machines virtuelles peuvent accéder.

4. Mettez à jour le fichier de mises à jour pour qu’il pointe vers les fichiers MSI sur le serveur Web interne.

5. Téléchargez le fichier de mises à jour sur le serveur Web.

Les mises à jour automatiques peuvent également être redirigées par machine virtuelle ou par pool. Pour rediriger les mises à jour par machine virtuelle :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécuter la commande

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools /t REG_SZ /v update_url /d \
         url of the update file on the web server
   <!--NeedCopy-->
   

Pour rediriger la mise à jour automatique de l’agent de gestion par pool, exécutez la commande suivante :

  xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->

Mettre à jour les pilotes d’E/S

Vous pouvez mettre à jour les pilotes d’E/S via Windows Update ou à l’aide de l’agent de gestion. Le État de virtualisation sur la section Généralités dans XenCenter indique si la machine virtuelle est éligible pour recevoir des mises à jour de Windows Update. Vous pouvez également désactiver les mises à jour automatiques et gérer manuellement les mises à jour des pilotes d’E/S.

Chaque pilote d’E/S (tel que xennet, xenvif, xenvbd, xeniface et xenbus) possède sa propre version. Pour plus de détails sur les dernières versions, consultez Quoi de neuf.

Activer les mises à jour des pilotes d’E/S via Windows Update

Pour obtenir automatiquement les mises à jour du pilote d’E/S à partir de Microsoft Windows Update, les conditions suivantes doivent être remplies :

• Vous exécutez Citrix Hypervisor 8.2 Premium Edition ou avez accès à Citrix Hypervisor via les droits Citrix Virtual Apps and Desktops ou Citrix DaaS.

• Vous avez créé une machine virtuelle Windows à l’aide de XenCenter fourni avec Citrix Hypervisor 8.2

• Windows Update est activé sur la machine virtuelle.

• La machine virtuelle a accès à Internet ou peut se connecter à un serveur proxy WSUS.

• Vous n’exécutez pas la version principale de Windows Server, car Windows Server Core ne prend pas en charge l’utilisation de Windows Update pour installer ou mettre à jour les pilotes d’E/S.

Vous pouvez activer les mises à jour du pilote d’E/S via Windows Update lors de la sélection d’un modèle de machine virtuelle dans le Nouvelle machine virtuelle dans XenCenter. Pour plus d’informations sur l’activation des mises à jour des pilotes d’E/S via Windows Update, consultez Vue d’ensemble des étapes de création de machine virtuelle.

Si vous ne souhaitez pas recevoir de mises à jour de pilotes d’E/S à partir de Windows Update, désactivez Windows Update sur votre machine virtuelle ou spécifiez une stratégie de groupe.

Désactiver les mises à jour des pilotes d’E/S via Windows Update

Vous pouvez désactiver les mises à jour des pilotes d’E/S via Windows Update pour les machines virtuelles nouvelles et existantes :

• Pour les nouvelles machines virtuelles : lors de la création d’une nouvelle machine virtuelle à l’aide de la commande Nouvelle machine virtuelle dans XenCenter, vous pouvez désactiver les mises à jour automatiques des pilotes d’E/S en définissant un indicateur. Ceci est particulièrement important pour les cibles Citrix Provisioning ou les machines de réinitialisation au démarrage, où la désactivation des mises à jour automatiques garantit la stabilité. Pour plus d’informations, consultez Vue d’ensemble des étapes de création de machine virtuelle. Pour les utilisateurs avancés qui préfèrent gérer ces paramètres à l’aide de la ligne de commande, reportez-vous à la section Créer une machine virtuelle Windows à l’aide de l’interface de ligne de commande.

• Pour les machines virtuelles existantes : si la machine virtuelle est déjà déployée, vous pouvez désactiver les mises à jour du pilote d’E/S en configurant une stratégie de groupe. Cela garantit que la machine virtuelle ne reçoit pas de mises à jour automatiques de Windows Update.

Configurer l’agent de gestion pour mettre à jour les pilotes d’E/S

Lors de l’installation de XenServer VM Tools pour Windows, vous pouvez configurer l’agent de gestion pour qu’il mette à jour automatiquement les pilotes d’E/S. Pour plus d’informations, consultez Installer XenServer VM Tools pour Windows.

Si vous souhaitez activer ce paramètre après avoir terminé l’installation, procédez comme suit :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécutez la commande suivante pour autoriser les mises à jour automatiques des pilotes d’E/S :

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
         InstallDrivers /d YES
   <!--NeedCopy-->
   

Empêcher l’agent de gestion de mettre à jour les pilotes d’E/S

Pour empêcher l’agent de gestion de mettre à jour les pilotes d’E/S, effectuez les opérations suivantes :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécutez la commande suivante :

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
         InstallDrivers /d NO
   <!--NeedCopy-->
   

Redémarrages automatiques

Assurez-vous que tous les redémarrages de machine virtuelle demandés sont terminés dans le cadre de la mise à jour. Plusieurs redémarrages peuvent être nécessaires. Si tous les redémarrages demandés ne sont pas terminés, vous pouvez constater un comportement inattendu.

Vous pouvez définir une clé de registre qui spécifie le nombre maximal de redémarrages automatiques effectués lorsque vous installez les pilotes via le Gestionnaire de périphériques ou Windows Update. Une fois que vous avez installé le pilote xenbus version 9.1.1.8 ou ultérieure, les outils VM XenServer pour Windows utilisent les instructions fournies par cette clé de registre. Si vous disposez d’une version antérieure de xenbus, il se peut que vous rencontriez un comportement inattendu. Si cela se produit, redémarrez la machine virtuelle à partir de XenCenter.

Pour utiliser cette fonctionnalité, nous vous recommandons de définir la clé de registre suivante dès que possible : HLKM\System\CurrentControlSet\services\xenbus_monitor\Paramètres\Redémarrage automatique. La valeur de la clé de registre doit être un entier positif. Nous vous recommandons de définir le nombre de redémarrages dans la clé de registre sur 3.

Lorsque cette clé de registre est définie, les outils de machine virtuelle XenServer pour Windows effectuent autant de redémarrages que nécessaire pour terminer les mises à jour ou le nombre de redémarrages spécifié par la clé de registre, selon la valeur la plus basse.

Avant chaque redémarrage, Windows peut afficher une alerte pendant 60 secondes qui avertit du redémarrage à venir. Vous pouvez ignorer l’alerte, mais cette action n’annule pas le redémarrage. En raison de ce délai entre les redémarrages, attendez quelques minutes après le redémarrage initial pour que le cycle de redémarrage se termine.

Remarques  :

Ce paramètre est requis pour les serveurs sans tête avec des adresses IP statiques.

Cette fonctionnalité de redémarrage automatique s’applique uniquement aux mises à jour des pilotes d’E/S Windows via le Gestionnaire de périphériques ou Windows Update. Si vous utilisez le programme d’installation de l’agent de gestion pour déployer vos pilotes, le programme d’installation ne tient pas compte de cette clé de registre et gère les redémarrages de la machine virtuelle en fonction de ses propres paramètres.

Si, après avoir attendu la fin de tous les redémarrages, vous rencontrez toujours un comportement inattendu, lancez un redémarrage de la machine virtuelle à partir de XenCenter pour tenter de restaurer la configuration.

Définition des redémarrages automatiques à l’aide de la ligne de commande

Sur votre machine virtuelle Windows, ouvrez une invite de commande en tant qu’administrateur et exécutez la commande suivante :

  reg add HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

Sinon, si votre machine virtuelle Windows est configurée pour autoriser l’accès à distance, vous pouvez exécuter la commande suivante à partir d’une invite de commande administrateur sur un autre système :

  reg add \\<windows-name>\HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

Pour plus d’informations, consultez la page reg add Commande Windows.

Définition des redémarrages automatiques à l’aide de l’Éditeur de registre

1. Dans le menu Démarrer de Windows, ouvrez l’Éditeur du Registre et accédez à la clé : HLKM\System\CurrentControlSet\services\xenbus_monitor\Paramètres.
2. Créez une nouvelle sous-clé du type REG_DWORD avec le nom : Redémarrage automatique.
3. Définir la valeur de Redémarrage automatique à un entier, par exemple, 3.

Autres configurations et requêtes

Recherchez la version du pilote d’E/S

Pour connaître la version des pilotes d’E/S installés sur la machine virtuelle :

1. Accédez à C :\Windows\System32\drivers.

2. Localisez le pilote dans la liste.

3. Cliquez avec le bouton droit de la souris sur le pilote et sélectionnez Propriétés Et puis Détails.

   Le Version du fichier affiche la version du pilote installé sur la machine virtuelle.

Rechercher la version de l’agent de gestion

Pour connaître la version de l’agent de gestion installée sur la machine virtuelle :

1. Accédez à C :\Program Files\Citrix\XenOutils.

2. Clic droit XenGuestAgent dans la liste et cliquez sur Propriétés Et puis Détails.

   Le Version du fichier affiche la version de l’agent de gestion installée sur la machine virtuelle.

Configurer les informations d’utilisation anonymes

Lors de l’installation de XenServer VM Tools pour Windows, vous pouvez spécifier si vous souhaitez envoyer des informations d’utilisation anonymes à Cloud Software Group, Inc. Si vous souhaitez mettre à jour ce paramètre après avoir terminé le processus d’installation de XenServer VM Tools pour Windows, procédez comme suit :

1. Sur la machine virtuelle, ouvrez une invite de commande en tant qu’administrateur.

2. Exécutez la commande suivante :

     reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate REG_SZ /v \
         IDENTIFYAUTOUPDATE /d YES/NO
   <!--NeedCopy-->
   

Dépannage de XenServer VM Tools pour Windows

Nous fournissons un outil, xtbugtool, qui capture les informations de diagnostic pour les outils de machine virtuelle XenServer. Pour plus d’informations, consultez Résoudre les problèmes de machine virtuelle.

Désinstaller XenServer VM Tools pour Windows

Nous vous déconseillons de supprimer les outils de machine virtuelle XenServer de vos machines virtuelles Windows. Ces outils sont nécessaires pour que vos machines virtuelles Windows soient entièrement prises en charge. Leur suppression peut entraîner un comportement inattendu. Désinstallez manuellement vos outils XenServer VM uniquement en dernier recours.

Désinstallation standard

Pour effectuer une désinstallation standard des outils XenServer VM, vous pouvez utiliser le bouton Windows Ajouter ou supprimer des programmes caractéristique:

1. Créez un instantané de la machine virtuelle avant de commencer.
2. Dans la machine virtuelle Windows, accédez à Ajouter ou supprimer des programmes.
3. Choisir Outils PV de l’hyperviseur Citrix et cliquez sur Désinstaller.
4. Redémarrez la VM.

Le uninstall.exe commander

Désinstallation des outils de machine virtuelle XenServer à l’aide de l’icône Windows Ajouter ou supprimer des programmes appelle la fonction <tools-install-directory>\uninstall.exe pour effectuer les actions de désinstallation. Vous pouvez choisir d’appeler cette commande à partir d’un terminal PowerShell ou d’une invite de commande avec des privilèges d’administrateur.

1. Créez un instantané de la machine virtuelle avant de commencer.
2. En tant qu’administrateur, ouvrez une invite de commande ou un terminal PowerShell.
3. Exécuter la commande <tools-install-directory>\uninstall.exe.
4. Redémarrez la VM.

Options de commande

Le uninstall.exe accepte les paramètres suivants :

• Aide - Affiche les informations d’utilisation de la commande.
• rapport - Génère un fichier journal qui indique ce que la commande a fait.
• verbeux - Imprime sur la console ce que la commande a fait.
• désactiver - Désactive les pilotes installés par le programme d’installation MSI.
• force-disable - Désactive les pilotes dans toutes les situations.
• caché - Supprime les appareils cachés. Ces appareils sont inutilisés et ont été remplacés, mais il se peut qu’ils aient laissé des entrées de registre obsolètes.
• nettoyage - Supprime les anciens désinstallateurs de Ajouter ou supprimer des programmes. Ces programmes de désinstallation peuvent inclure des entrées en double provenant d’anciennes versions des outils.
• purger - (9.3.1 et versions ultérieures) Réinitialise la VM à un état propre tel qu’il était avant l’installation de toute partie des outils VM XenServer. Pour plus d’informations, consultez Désinstallation complète de tous les composants XenServer VM Tools.
• installer - (9.3.1 et versions ultérieures) Installe l’ensemble actuel de pilotes d’E/S et demande un redémarrage de la machine virtuelle si nécessaire.
• redémarrer- Redémarre la machine virtuelle une fois toutes les autres opérations de commande terminées.

Désinstallation complète de tous les composants XenServer VM Tools

La dernière version de XenServer VM Tools pour Windows (9.3.1 et versions ultérieures) inclut la commande uninstall.exe purge. Le purger sur le uninstall.exe l’application réinitialise une machine virtuelle à l’état antérieur à l’installation des pilotes d’E/S. Si vous rencontrez des problèmes lors de la mise à niveau de vos outils vers une version plus récente ou si vous avez besoin d’un état propre pour installer un ensemble ultérieur d’outils sur votre machine virtuelle, utilisez cet utilitaire.

1. Créez un instantané de la machine virtuelle avant de commencer.
2. En tant qu’administrateur, ouvrez une invite de commande ou un terminal PowerShell.
3. Exécuter la commande <tools-install-directory>\uninstall.exe purge verbeux
4. Redémarrez la VM.

Après avoir utilisé cette commande, vous n’avez pas besoin d’effectuer d’étapes de nettoyage manuel comme vous auriez pu le faire avec les versions précédentes des outils VM XenServer. Toutes les modifications liées aux outils VM XenServer ont été supprimées.

Qu’est-ce que le purger option supprimer ?

Si vous utilisez la commande uninstall.exe purge, toutes les traces des outils XenServer VM sont supprimées de votre VM Windows. La liste des actions effectuées par cette commande est la suivante :

• Services:
  • Désactive tous les services XenServer VM Tools, ce qui empêche les pilotes et les services installés de démarrer au redémarrage.
  • Arrête tous les services XenServer VM Tools en cours d’exécution.
• Pilotes :
  • Désinstalle les pilotes d’E/S de tous les nœuds de périphérique.
  • Désinstalle les périphériques cachés. Cette action est la même que celle effectuée caché option de ligne de commande.
  • Désinstalle les packages de pilotes mis en cache, ce qui les supprime du magasin de pilotes. Par conséquent, les pilotes d’E/S ne sont pas réinstallés automatiquement.
• Registre :
  • Supprime les informations de registre obsolètes utilisées par les versions non prises en charge des pilotes.
  • Supprime les touches liées aux outils de HKLM\System\CurrentControlSet\Control\Class\...
  • Supprime les touches liées aux outils de HKLM\System\CurrentControlSet\Services.
  • Supprime les touches liées aux outils de HKLM\System\CurrentControlSet\Enum\...
• Fichiers:
  • Supprime tous les fichiers de pilote XenServer VM Tools de C :\Windows\System32 et C :\Windows\System32\drivers.
  • Supprime les outils de machine virtuelle XenServer INF fichiers de C :\Windows\INF.
  • Supprime tous les fichiers obsolètes laissés par les versions non prises en charge des outils de C :\Program Files\Citrix\XenOutils.
• Autre:
  • Supprime les anciennes entrées dans Ajouter ou supprimer des programmes. Cette action est la même que celle effectuée nettoyage option de ligne de commande.
  • Efface certaines des informations d’état obsolètes de l’InstallAgent.
  • Supprime xenfilt.sys des filtres supérieurs. Ce changement empêche xenfilt.sys de chargement sur n’importe quel nœud de pilote.
  • Supprime le débrancher clés, ce qui entraîne le retour de la machine virtuelle aux périphériques émulés au redémarrage.
  • Supprime le StartOverride de StorNvme. Ce changement force stornvme.sys pour démarrer au démarrage et permet aux périphériques de démarrage NVMe (UEFI) émulés de fonctionner.

Nouveautés

La version de XenServer VM Tools pour Windows est mise à jour indépendamment de la version de Citrix Hypervisor. Assurez-vous que vos outils de machine virtuelle XenServer pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos machines virtuelles et dans tous les modèles que vous utilisez pour créer vos machines virtuelles.

Outils XenServer VM pour Windows 9.4.0

Sortie 22 oct. 2024

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.4.0
• Agent de gestion : 9.3.0.65
• Xenbus : 9.1.9.105
• xeniface : 9.1.10.87
• xennet : 9.1.7.65
• xenvbd : 9.1.8.79
• xenvif : 9.1.12.101

Problèmes résolus dans la version 9.4.0

Cette version contient des correctifs pour les problèmes suivants :

• La version de XenServer VM Tools pour Windows n’est pas correctement signalée à XenServer en raison de la vérification par l’agent de gestion de la valeur incorrecte InstallStatus dans le registre.
• En raison d’une gestion incomplète des clés de registre StartOverride de StorNvme, vous pouvez rencontrer un BSOD avec l’erreur « Périphérique de démarrage inaccessible » après le redémarrage de votre machine virtuelle Windows lors d’une mise à jour des outils de machine virtuelle XenServer via Windows Update.
• Parfois, lors de la mise à jour de XenServer VM Tools pour Windows, les paramètres IP statiques sont perdus et les paramètres réseau sont modifiés pour utiliser DHCP. Ce problème est résolu si vous effectuez une mise à jour à partir de la version 9.3.3 ou ultérieure (par exemple, de la version 9.4.0 vers une version plus récente). Toutefois, si vous effectuez une mise à jour à partir d’une version antérieure à la version 9.3.3 (par exemple, de la version 9.3.2 à la version 9.4.0), le problème se produira une fois pendant la mise à jour, mais il n’affectera pas les mises à jour futures. Pour plus d’informations, consultez l’article d’assistance Perte d’adresse IP statique lors de la mise à jour vers VM Tools pour Windows 9.3.3 ou version antérieure.

Problèmes connus dans la version 9.4.0

Cette version contient les problèmes connus suivants :

• Si vous utilisez l’agent de gestion pour les mises à jour automatiques, vous devez effectuer la mise à jour manuelle vers la version 9.4.0 ou ultérieure, car la version 9.3.3 ne se met pas automatiquement à jour vers la version 9.4.0 en raison de problèmes de vérification des certificats. Pour résoudre ce problème, installez manuellement XenServer VM Tools pour Windows 9.4.0 ou une version plus récente sur chaque machine virtuelle.

• Sur une machine virtuelle Windows, après avoir installé la version 9.x XenServer VM Tools pour Windows, vous pouvez voir la version précédente et la dernière version des outils ou de l’agent de gestion répertoriés dans votre Programmes installés:

  • (PRÉCÉDENT) Citrix XenServer Agent de gestion Windows
  • (DERNIER) Outils PV de l’hyperviseur Citrix

  La version précédente de l’agent de gestion n’est pas active et n’interfère pas avec le fonctionnement de la dernière version. Nous vous conseillons de ne pas désinstaller manuellement Citrix XenServer Agent de gestion Windows car cela peut désactiver le xenbus et faire revenir la machine virtuelle aux périphériques émulés.

Versions précédentes

9.3.3

Sortie 04 juin 2024

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.3.3
• Agent de gestion : 9.2.3.60
• Xenbus : 9.1.8.88
• xeniface : 9.1.9.78
• xennet : 9.1.6.60
• xenvbd : 9.1.7.66
• xenvif : 9.1.11.92

Cette version contient des correctifs pour les problèmes suivants :

• Parfois, l’agent de gestion peut se bloquer avec une ManagementException lorsque la machine virtuelle est soumise à une charge importante.
• Sur les serveurs Windows 2022, un seul vCPU peut consommer 100 % du CPU. En conséquence, le serveur ne répond plus.
• Les machines virtuelles Windows hébergées dans un pool qui utilise la mise en réseau OpenVSwitch et les trames Ethernet balisées VLAN peuvent avoir une connectivité réseau incohérente.

9.3.2

Sortie 27 nov. 2023

Cette version renomme Citrix VM Tools en XenServer VM Tools.

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.3.2
• Agent de gestion : 9.2.2.435
• xenbus : 9.1.7.80
• xeniface : 9.1.8.69
• xennet : 9.1.5.51
• xenvbd : 9.1.6.58
• xenvif : 9.1.10.83

Cette version inclut les améliorations suivantes :

• Améliorations apportées à la uninstall.exe commander.
• Modifications permettant à certaines machines virtuelles Windows d’utiliser jusqu’à 64 vCPU lorsque votre version de XenServer et le système d’exploitation Windows le prennent en charge.

Cette version contient des correctifs pour les problèmes suivants :

• Parfois, lors de l’installation de XenServer VM Tools, une erreur non fatale peut entraîner l’échec de l’installation.

9.3.1

Sortie 25 janv. 2023

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.3.1
• Agent de gestion : 9.2.1.35
• Xenbus : 9.1.5.54
• xeniface : 9.1.5.42
• xennet : 9.1.3.34
• xenvbd : 9.1.4.37
• xenvif : 9.1.8.58

Cette version inclut les améliorations suivantes :

• Améliorations apportées à la uninstall.exe utilitaire, y compris le purger paramètre. Pour plus d’informations, consultez Désinstaller XenServer VM Tools pour Windows.
• Améliorations générales apportées au programme d’installation de XenServer VM Tools.
• Améliorations générales de la gestion des chaînes de clés de registre.

Cette version contient des correctifs pour les problèmes suivants :

• Parfois, lorsque les outils de machine virtuelle XenServer sont mis à jour via Windows Update, les paramètres IP statiques sont perdus et les paramètres réseau sont modifiés pour utiliser DHCP.
• Sur les machines virtuelles Windows, les tables d’octroi peuvent facilement s’épuiser. Lorsque cela se produit, les demandes de lecture et d’écriture peuvent échouer ou les VIF supplémentaires ne sont pas activées correctement et ne démarrent pas.
• Dans de rares cas, lors de la mise à niveau de XenServer VM Tools pour Windows, l’agent de gestion existant peut ne pas s’arrêter et empêcher la mise à niveau de réussir.
• Sur une machine virtuelle Windows, vous pouvez voir la version précédente et la dernière version des outils ou de l’agent de gestion répertoriés dans vos programmes installés.
  • (PRÉCÉDENT) Citrix XenServer Agent de gestion Windows
  • (DERNIER) Outils PV de l’hyperviseur Citrix.

9.3.0

Sortie 26 juil. 2022

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.3.0
• Agent de gestion : 9.2.0.27
• Xenbus : 9.1.4.49
• xeniface : 9.1.4.34
• xennet : 9.1.3.34
• xenvbd : 9.1.3.33
• xenvif : 9.1.6.52

Cette version inclut les améliorations suivantes :

• Améliorations générales apportées au programme d’installation de XenServer VM Tools.

Cette version contient des correctifs pour les problèmes suivants :

• Les logiciels de sécurité empêchaient les disques secondaires marqués comme amovibles d’être exposés au système d’exploitation, comme mesure de prévention de l’exfiltration de données. Cette mise à jour vous permet de marquer un VBD comme non amovible et de l’exposer correctement via le système d’exploitation.
• Sur une machine virtuelle Windows, il arrive que l’adresse IP d’une VIF SR-IOV ne soit pas visible dans XenCenter.

9.2.3

Sortie 28 avr. 2022

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.2.3
• Agent de gestion : 9.1.1.13
• xenbus : 9.1.3.30
• xeniface : 9.1.4.34
• Xennet :
  • 9.1.1.8 (pour Windows Server 2012 et Windows Server 2012 R2)
  • 9.1.2.23 (pour tous les autres systèmes d’exploitation Windows pris en charge)
• xenvbd : 9.1.2.20
• xenvif : 9.1.5.48

Cette version contient des correctifs pour les problèmes suivants :

• Dans XenServer VM Tools pour Windows version 9.2.2, les options de synchronisation de l’heure ne sont pas disponibles.
• Une condition de concurrence peut entraîner l’affichage d’une erreur d’écran bleu sur les machines virtuelles Windows après la migration en direct sur Citrix Hypervisor 8.2 Cumulative Update 1.
• Les machines virtuelles Windows sur lesquelles la version 9.2.1 ou 9.2.2 des outils de machine virtuelle XenServer est installée et qui sont des cibles PVS peuvent parfois se figer avec un écran noir. Le message « Guest Rx stalled » est présent dans les journaux du noyau dom0. Ce problème se produit plus souvent sur les maîtres de piscine que sur les autres membres de la piscine.
• Sur les machines virtuelles Windows avec plus de 8 vCPU, la mise à l’échelle côté réception peut ne pas fonctionner, car le pilote xenvif ne parvient pas à configurer la table d’indirection.

9.2.2

Sortie 14 janv. 2022

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.2.2
• Agent de gestion : 9.1.1.13
• xenbus : 9.1.3.30
• Xeniface : 9.1.2.22
• Xennet :
  • 9.1.1.8 (pour Windows Server 2012 et Windows Server 2012 R2)
  • 9.1.2.23 (pour tous les autres systèmes d’exploitation Windows pris en charge)
• xenvbd : 9.1.2.20
• xenvif : 9.1.3.31

Cette version contient des correctifs pour les problèmes suivants :

• Lors de la mise à jour des outils, le pilote xenbus peut demander un redémarrage avant la fin de l’installation du pilote. L’acceptation du redémarrage peut provoquer une erreur d’écran bleu dans votre machine virtuelle Windows.
• Lors de la compression des informations de diagnostic collectées, l’outil de diagnostic xt-bugtool expire au bout de 20 secondes. Ce comportement peut entraîner l’échec de la création incorrecte du fichier zip de diagnostic.
• Le partage du presse-papiers VNC ne fonctionne pas.
• Les versions précédentes des pilotes n’étaient pas publiées via Windows Update.

9.2.1

Sortie 24 juin 2021

Cet ensemble d’outils contient les versions de composants suivantes :

• Installateur : 9.2.1
• Agent de gestion : 9.1.0.10
• Xenbus : 9.1.2.14
• Xeniface : 9.1.1.11
• xennet : 9.1.1.8
• xenvbd : 9.1.1.8
• xenvif : 9.1.2.16

Remarque :

Cet ensemble de pilotes n’était pas fourni par Windows Update.

Cette version contient des correctifs pour les problèmes suivants :

• Dans certains cas, l’état Ordinateur portable/Ardoise de la machine virtuelle ne peut pas être modifié.
• Après le redémarrage d’une machine virtuelle, elle peut parfois commencer à envoyer des messages de journal excessifs au fichier daemon.log.
• Une condition de concurrence dans les dépendances de charge du pilote après une mise à niveau du système d’exploitation peut empêcher la mise à niveau des outils de machine virtuelle XenServer.
• Une erreur de stockage peut entraîner le blocage des machines virtuelles Windows.
• Parfois, l’adresse IP d’une VIF SR-IOV n’est pas visible dans XenCenter. Pour résoudre le problème, redémarrez l’agent de gestion à partir du Gestionnaire de services de la machine virtuelle.
• Dans des conditions de charge réseau et système élevée, et de faibles ressources, les machines virtuelles peuvent rencontrer des vérifications de bogues dans Citrix et les pilotes tiers, généralement avec du code IRQL_NOT_LESS_OR_EQUAL. Ce correctif améliore la mise en mémoire tampon du réseau pour éviter ces vérifications de bogues.
• La mise à niveau des pilotes d’E/S Windows peut entraîner l’échec du démarrage des machines virtuelles UEFI, signalant « 0xC000000E. Un appareil requis n’est pas connecté ou n’est pas accessible.
• Un problème peut se produire lors de l’installation de XenServer VM Tools après la désinstallation d’une version précédente de XenServer VM Tools qui renvoie le message d’erreur suivant : « Ce périphérique ne peut pas démarrer (code 10) (Échec de l’opération) L’opération demandée a échoué ».