XenServer VM Tools pour Windows

XenServer VM Tools (anciennement Citrix VM Tools ou XenServer PV Tools) pour Windows 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 XenServer. Pour bénéficier de l’assistance, 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 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.

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

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échargements de XenServer.

3. Vérifiez votre téléchargement par rapport à la valeur SHA256 fournie.

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

5. Exécutez le managementagentx64.msi pour commencer l’installation de XenServer VM Tools.

     Msiexec.exe /package managementagentx64.msi
   

6. 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.

     Par défaut, l’Assistant affiche les paramètres recommandés suivants :

     • Installer les pilotes d’E/S maintenant
       • Si la machine virtuelle a has-vendor-device=vrai défini, cette option n’est pas sélectionnée car les pilotes d’E/S ont déjà été installés par Windows Update.
       • Si la machine virtuelle a has-vendor-device=false set, cette option est sélectionnée.
     • Autoriser les mises à jour automatiques de l’agent de gestion
     • Interdire les mises à jour automatiques des pilotes d’E/S par l’agent de gestion
     • Envoi anonyme d’informations d’utilisation à Cloud Software Group, Inc.

     Pour certains cas d’utilisation, des paramètres de mise à jour différents sont recommandés. Pour plus d’informations, consultez Mettre à jour les outils de machine virtuelle XenServer.

     Pour configurer les paramètres de mise à jour, vous pouvez apporter les modifications suivantes :

     • 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. 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 nous, désactivez l’icône Envoi anonyme d’informations d’utilisation à Cloud Software Group, Inc. case à cocher. Les informations transmises à Cloud Software Group contiennent les quatre premiers caractères de l’UUID de la machine virtuelle demandant la mise à jour. Aucune autre information relative à la VM n’est collectée ou transmise.

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

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

   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é.

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.

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 managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

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

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

Remarques  :

• 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 processus de mise à niveau ou d’installation peut déclencher plusieurs redémarrages. 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.

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 à Cloud Software Group, Inc., exécutez l’une des commandes suivantes :

  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.

Mettre à jour les outils de machine virtuelle XenServer

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 capturer votre machine virtuelle avant de mettre à jour les outils de machine virtuelle XenServer. Pour plus d’informations sur la dernière version des outils, consultez Quoi de neuf.

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, la machine virtuelle peut présenter un comportement inattendu.

XenServer fournit des mécanismes de mise à jour automatique pour chacun de ses composants :

• L’agent de gestion peut se mettre à jour automatiquement

• Les pilotes d’E/S peuvent être mis à jour soit par l’agent de gestion, soit par 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.

Vous pouvez également mettre à jour l’un ou l’autre de ces composants ou les deux manuellement.

La méthode de mise à jour à choisir pour chaque composant des outils peut dépendre de votre environnement.

Paramètres de mise à jour recommandés

Pour la plupart des cas d’utilisation, nous vous recommandons d’utiliser les paramètres suivants pour mettre à jour les différents composants des outils VM XenServer pour Windows :

1. Activer les mises à jour de l’agent de gestion.

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

3. 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.

   Pour plus d’informations, consultez Redémarrages automatiques.

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

Pendant l’installation:

Les deux premiers paramètres sont définis par défaut lorsque vous exécutez le programme d’installation :

Paramètres pour les cibles Citrix Provisioning ou les machines de réinitialisation au démarrage

Si vous avez l’intention d’utiliser votre machine virtuelle Windows en tant que cible de provisionnement Citrix ou avec l’indicateur de réinitialisation au démarrage activé, vous ne pouvez utiliser aucun des mécanismes de mise à jour automatique. Nous vous recommandons de définir la configuration suivante sur le modèle maître que vous utilisez pour créer ces machines virtuelles :

1. Lors de la création de la machine virtuelle, assurez-vous que la commande has-vendor-device est défini sur faux. Cela empêche Windows Update de mettre à jour automatiquement les pilotes d’E/S pour XenServer VM Tools pour Windows. Vous pouvez définir cet indicateur en :

   • Utilisation de l’interface graphique. Pour plus d’informations, consultez Créer une machine virtuelle Windows à l’aide de l’interface de ligne de commande.
   • Désactivation de l’ Autoriser Windows Update à fournir des pilotes d’E/S lors de la sélection d’un modèle de machine virtuelle dans le Nouvelle machine virtuelle dans XenCenter. Pour plus d’informations, consultez Vue d’ensemble des étapes de création de machine virtuelle.

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

Pendant l’installation:

Spécifiez cette configuration lors de la première installation des outils de machine virtuelle XenServer :

Paramètres pour les mises à jour automatiques par l’agent de gestion uniquement

Vous pouvez configurer l’agent de gestion pour qu’il mette à jour à la fois lui-même et les pilotes d’E/S. Si vous utilisez cette configuration, assurez-vous que les machines virtuelles ne peuvent pas mettre à jour les pilotes d’E/S via Windows Update. Si les deux mécanismes tentent de mettre à jour les pilotes d’E/S, cela peut entraîner des mises à jour inutiles.

Choisissez cette approche si votre organisation exige que vous examiniez les mises à jour avant de les appliquer à vos machines virtuelles Windows. Si tel est le cas, vous devez également rediriger l’agent de gestion pour qu’il obtienne ses mises à jour à partir d’un serveur interne.

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

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

3. (Facultatif) Rediriger les mises à jour de l’agent de gestion.

Pendant l’installation:

Spécifiez cette configuration lors de la première installation des outils de machine virtuelle XenServer :

Mettre à jour l’agent de gestion

XenServer vous permet de mettre à jour automatiquement l’agent de gestion sur les machines virtuelles Windows nouvelles et existantes. Par défaut, XenServer 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 de l’agent de gestion automatiquement, à condition que la machine virtuelle Windows ait accès à Internet.

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

XenServer 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.

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\XenServer\XenTools\AutoUpdate /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\XenServer\XenTools\AutoUpdate /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

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

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\XenServer\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 :

• 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 et Paramètres pour les cibles Citrix Provisioning ou les machines de réinitialisation au démarrage. 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\XenServer\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\XenServer\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 :\Fichiers programme\XenServer\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 préférez 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\XenServer\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

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 de machine virtuelle XenServer 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 et C :\Fichiers programme\XenServer\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 XenServer. 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.

La dernière version de XenServer VM Tools pour Windows est disponible à partir du Page de téléchargements de XenServer.

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.

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 inclut 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 contient également 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 inclut un correctif pour le problème suivant :

• 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.
• 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. Dans ce cas, 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 fois la version précédente et une version ultérieure 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
  • (PLUS TARD) Outils PV de l’hyperviseur Citrix.

  Une fois que vous avez mis à jour vers la dernière version des outils, aucun de ces noms antérieurs n’est répertorié. Seul XenServer VM Tools est répertorié dans vos programmes installés.

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 chez les coordinateurs de pool que chez les autres membres du pool.
• 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 d’une mise à jour des outils, le pilote xenbus peut déclencher 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.
• En cas de charge élevée du réseau et du système, et de faibles ressources, les machines virtuelles peuvent rencontrer des vérifications de bogues dans Citrix et les pilotes tiers, généralement avec le 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é ».