XenServer VM Tools pour Windows

XenServer VM Tools (anciennement Citrix VM Tools ou XenServer PV Tools) pour Windows fournit des services d’E/S de haute performance sans les frais liés à l’émulation de périphériques traditionnelle. XenServer VM Tools pour Windows se composent 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 machine virtuelle Windows pour que la machine virtuelle dispose d’une configuration 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 la section Nouveautés.

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.

XenServer VM Tools pour Windows sont installés par défaut dans le répertoire C:\Program Files\XenServer\XenTools de la machine virtuelle.

Pour installer XenServer VM Tools pour Windows :

1. Nous vous recommandons de créer un instantané de votre machine virtuelle avant d’installer ou de mettre à jour XenServer VM Tools.

2. Téléchargez le fichier XenServer VM Tools pour Windows depuis la page de téléchargement 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 fichier 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 choisissez un dossier de destination.

   • Personnalisez les paramètres de la page Paramètres d’installation et de mise à jour .

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

     • Installez les pilotes d’E/S maintenant
       • Si has-vendor-device=true est défini pour la machine virtuelle, cette option est désélectionnée, car les pilotes d’E/S ont déjà été installés par Windows Update.
       • Si has-vendor-device=false est défini pour la machine virtuelle, cette option est sélectionnée.
     • Autoriser les mises à jour automatiques des agents de gestion
     • Interdire les mises à jour automatiques des pilotes d’E/S par l’agent de gestion
     • Envoyez des informations d’utilisation anonymes à Cloud Software Group, Inc.

     Dans certains cas d’utilisation, différents paramètres de mise à jour sont recommandés. Pour plus d’informations, consultez Mettre à jour XenServer VM Tools.

     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 les pilotes d’E/S automatiquement.
     • Si vous ne souhaitez pas partager d’informations d’utilisation anonymes avec nous, décochez la case Envoyer des informations d’utilisation anonymes à 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 machine virtuelle n’est collectée ou transmise.

   • Cliquez sur Suivant puis sur Installer pour démarrer 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 risquent de ne pas voir l’invite de redémarrage car elle apparaît uniquement sur la session de console Windows. Pour vous assurer que vous redémarrez votre machine virtuelle (si nécessaire) et que votre machine virtuelle soit optimisée, spécifiez l’option Forcer le redémarrage dans RDP. L’option de redémarrage forcé redémarre la machine virtuelle uniquement si elle est nécessaire pour obtenir la machine virtuelle dans un état optimisé.

Avertissement :

L’installation ou la mise à niveau des XenServer VM Tools pour Windows peut entraîner la modification du nom et de l’identifiant conviviaux de certains adaptateurs réseau. Tout logiciel configuré pour utiliser un adaptateur spécifique devra peut-être être reconfiguré après l’installation ou la mise à niveau de XenServer VM Tools pour Windows.

Installation non assistée

Pour installer les XenServer VM Tools pour Windows en mode silencieux et empêcher le système de redémarrer, exécutez l’une des commandes suivantes :

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

Ou

Setup.exe /quiet /norestart
<!--NeedCopy-->

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

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

Ou

Setup.exe /passive
<!--NeedCopy-->

Remarques :

• Le paramètre /quiet s’applique uniquement aux boîtes de dialogue d’installation, mais pas à l’installation du pilote de périphérique. Lorsque le /quiet paramètre est spécifié, l’installation du pilote de périphérique demande l’autorisation de redémarrer si nécessaire.
  • Lorsque /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.
  • Lorsque /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 paramètre quiet 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’autorisera pas les futures mises à jour automatiques de l’agent de gestion et n’enverra 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 automatiques avant que les XenServer VM Tools pour Windows ne soient complètement installés. Ce comportement est également le cas pour les installations dont l’indicateur /norestart est spécifié. Toutefois, pour les installations où l’indicateur /norestart est fourni, le redémarrage initial peut être lancé manuellement.

Mettre à jour XenServer VM Tools

Assurez-vous que XenServer VM Tools 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 instantané de votre machine virtuelle avant de mettre à jour XenServer VM Tools. Pour plus d’informations sur la dernière version des outils, consultez la section Nouveautés.

Important :

Assurez-vous que tous les redémarrages de VM 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 par l’agent de gestion ou via Windows Update.

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

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

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

1. Activez les mises à jour des agents de gestion.

2. Empêchez 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\Parameters\Autoreboot.

   Pour plus d’informations, voir ### Redémarrages automatiques.

4. Configurez les pilotes d’E/S pour qu’ils soient mis à jour via Windows Update.

Lors de l’installation :

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

Paramètres pour les cibles Citrix Provisioning ou les machines réinitialisées au démarrage

Si vous avez l’intention d’utiliser votre machine virtuelle Windows comme cible Citrix Provisioning ou si l’indicateur de réinitialisation au démarrage est défini, 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 principal que vous utilisez pour créer ces machines virtuelles :

1. Lors de la création de votre machine virtuelle, assurez-vous que l’indicateur has-vendor-device est défini sur false.

   Pour plus d’informations, voir Créer une machine virtuelle Windows à l’aide de l’interface de ligne de commande.

2. Désactivez les mises à jour des agents de gestion.

Lors de l’installation :

Spécifiez cette configuration lors de la première installation de XenServer VM Tools :

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

Vous pouvez configurer l’agent de gestion pour qu’il se mette à jour lui-même et que les pilotes d’E/S soient mis à jour. 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 depuis un serveur interne.

1. Désactivez la mise à jour des pilotes d’E/S via Windows Update.

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

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

Lors de l’installation :

Spécifiez cette configuration lors de la première installation de XenServer VM Tools :

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 autorise la mise à jour automatique de l’agent de gestion. Toutefois, il ne permet pas à l’agent de gestion de procéder à la mise à jour automatique des 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 se produit 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 automatiquement les mises à jour de l’agent de gestion, à condition que la machine virtuelle Windows ait accès à Internet.

Gérer les mises à jour automatiques à l’aide de la

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 répertorié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.exe, consultez la section Installation silencieuse.

Remarque :

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

Par exemple :

setup.exe  /passive /forcerestart ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
     ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

Activer les mises à jour des agents de gestion

Pour activer la mise à jour automatique de l’agent de gestion par machine virtuelle, procédez comme suit :

1. Sur la machine virtuelle, ouvrez une invite de commandes 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-->
   

3. Assurez-vous que les mises à jour de l’agent de gestion sont autorisées par votre pool. Dans la console hôte, exécutez la commande suivante :

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

Désactiver les mises à jour de l’agent

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

1. Sur la machine virtuelle, ouvrez une invite de commandes 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 par 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 Management

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 de consulter 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 une utilisation de Management Agent 9.2.1.35 et versions ultérieures https://pvupdates.vmd.citrix.com/autoupdate.v1.json.
• Pour les agents de gestion 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. Télé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 pointer 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 commandes en tant qu’administrateur.

2. Exécutez 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. Vous pouvez également désactiver les mises à jour automatiques et gérer manuellement les mises à jour des pilotes d’E/S.

Chacun des pilotes d’E/S (xennet, xenvif, xenvbd, xeniface et xenbus) possède sa propre version. Pour plus d’informations sur les dernières versions, consultez la section Nouveautés.

Configurez les pilotes d’E/S pour qu’ils soient mis à jour via Windows Update

Vous pouvez obtenir les mises à jour des pilotes d’E/S automatiquement à partir de Microsoft Windows Update, à condition :

• Windows Update est activé dans la machine virtuelle

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

• Vous n’utilisez pas la version Core de Windows Server. Windows Server Core ne prend pas en charge l’utilisation de Windows Update pour installer ou actualiser les pilotes d’E/S.

La section État de la virtualisation de l’onglet Général d’une machine virtuelle dans XenCenter spécifie si la machine virtuelle peut recevoir des mises à jour à partir de Windows Update. Le mécanisme de réception des mises à jour des pilotes d’E/S à partir de Windows Update est activé par défaut. Si vous ne souhaitez pas recevoir les mises à jour des pilotes d’E/S de Windows Update, désactivez Windows Update sur votre machine virtuelle ou spécifiez une stratégie de groupe.

Désactiver la mise à jour des pilotes d’E/S via Windows Update

La section État de la virtualisation de l’onglet Général d’une machine virtuelle dans XenCenter spécifie si la machine virtuelle peut recevoir des mises à jour à partir de Windows Update. Le mécanisme de réception des mises à jour des pilotes d’E/S à partir de Windows Update est activé par défaut.

Pour les machines virtuelles Windows qui existent déjà, si vous ne souhaitez pas recevoir les mises à jour des pilotes d’E/S de Windows Update, spécifiez une stratégie de groupe.

Pour les nouvelles machines virtuelles Windows, vous pouvez définir un indicateur dans la machine virtuelle lors de la création de la machine virtuelle afin d’empêcher les mises à jour des pilotes d’E/S à partir de Windows Update. Pour plus d’informations, consultez les sections Paramètres pour les cibles Citrix Provisioning ou les machines réinitialisées au démarrage et Création d’une machine virtuelle Windows à l’aide de l’interface de ligne de commande.

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 demander à l’agent de gestion de mettre à jour automatiquement les pilotes d’E/S. Si vous préférez mettre à jour ce paramètre après avoir terminé le processus d’installation de XenServer VM Tools pour Windows, effectuez les étapes suivantes :

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

2. Exécutez la commande suivante :

   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 commandes 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 VM 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 maximum de redémarrages automatiques effectués lorsque vous installez les pilotes via le Gestionnaire de périphériques ou Windows Update. Après avoir installé le pilote Xenbus version 9.1.1.8 ou ultérieure, les XenServer VM Tools pour Windows suivent les instructions fournies par cette clé de registre.

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\Parameters\Autoreboot. La valeur de la clé de registre doit être un nombre 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, XenServer VM Tools pour Windows effectue 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, la valeur la plus basse étant retenue.

Avant chaque redémarrage, Windows peut afficher une alerte pendant 60 secondes pour vous avertir du prochain redémarrage. 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 que le cycle de redémarrage soit terminé.

Remarques :

Ce paramètre est requis pour les serveurs headless avec des adresses IP statiques.

Cette fonction 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 ignore cette clé de registre et gère les redémarrages de la machine virtuelle en fonction de ses propres paramètres.

Autres configurations et requêtes

Trouver la version du pilote d’E/S

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

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

2. Recherchez le pilote dans la liste.

3. Cliquez avec le bouton droit sur le pilote et sélectionnez Propriétés, puis Détails.

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

Trouvez la version de l’agent de gestion

Pour connaître la version de l’agent de gestion installé sur la machine virtuelle, procédez comme suit :

1. Accédez à C:\Program Files\XenServer\XenTools.

2. Cliquez avec le bouton droit sur XenGuestAgent dans la liste et cliquez sur Propriétés, puis sur Détails.

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

Configurer des 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, effectuez les étapes suivantes :

1. Sur la machine virtuelle, ouvrez une invite de commandes 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-->
   

Résoudre les problèmes liés à XenServer VM Tools pour Windows

Nous fournissons un outil, xtbugtool, qui capture les informations de diagnostic pour XenServer VM Tools. Pour plus d’informations, consultez Résoudre les problèmes liés aux machines virtuelles.

Désinstallez XenServer VM Tools

Nous ne recommandons pas de supprimer XenServer VM Tools 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 provoquer un comportement inattendu. Désinstallez manuellement vos XenServer VM Tools uniquement en dernier recours.

Désinstallation standard

Pour effectuer une désinstallation standard de XenServer VM Tools, vous pouvez utiliser la fonctionnalité d’ ajout ou de suppression de programmes de Windows :

1. Créez un instantané de la machine virtuelle avant de démarrer.
2. Sur la machine virtuelle Windows, accédez à Ajout/Suppression de programmes.
3. Sélectionnez XenServer VM Tools et cliquez sur Désinstaller.
4. Redémarrez la VM.

La commande uninstall.exe

La désinstallation de XenServer VM Tools à l’aide de la fonctionnalité Ajouter ou supprimer des programmes de Windows appelle le fichier <tools-install-directory>\uninstall.exe pour effectuer les actions de désinstallation. Vous pouvez plutôt 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 démarrer.
2. En tant qu’administrateur, ouvrez une invite de commandes ou un terminal PowerShell.
3. Exécutez la commande <tools-install-directory>\uninstall.exe.
4. Redémarrez la VM.

Options de commande

La commande uninstall.exe accepte les paramètres suivants :

• help - Affiche les informations d’utilisation de la commande.
• log - Génère un fichier journal qui indique ce que la commande a fait.
• verbose - Imprime sur la console ce que la commande a fait.
• disable - Désactive les pilotes qui ont été installés par le programme d’installation MSI.
• force-disable - Désactive les pilotes dans toutes les situations.
• hidden - Supprime les appareils cachés. Ces appareils ne sont pas utilisés et ont été remplacés, mais peuvent avoir laissé des entrées de registre périmées.
• cleanup - Supprime les anciens programmes de désinstallation de la fonction Ajout/Suppression de programmes. Ces programmes de désinstallation peuvent inclure des entrées dupliquées provenant d’anciennes versions des outils.
• purge - (9.3.1 et versions ultérieures) Réinitialise la machine virtuelle à un état propre tel qu’il était avant l’installation d’une partie XenServer VM Tools. Pour plus d’informations, consultez la section Désinstallation complète de tous les composants de XenServer VM Tools.
• install - (9.3.1 et versions ultérieures) Installe l’ensemble actuel de pilotes d’E/S et invite à redémarrer la machine virtuelle si nécessaire.
• reboot- Redémarre la machine virtuelle une fois toutes les autres opérations de commande terminées.

Désinstallation complète de tous les composants de 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. L’option purge de l’application uninstall.exe réinitialise une machine virtuelle à son état antérieur à l’installation de l’un 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 d’outils plus récent sur votre machine virtuelle, utilisez cet utilitaire.

1. Créez un instantané de la machine virtuelle avant de démarrer.
2. En tant qu’administrateur, ouvrez une invite de commandes ou un terminal PowerShell.
3. Exécutez la commande <tools-install-directory>\uninstall.exe purge verbose
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 de XenServer VM Tools. Toutes les modifications liées à XenServer VM Tools ont été supprimées.

Qu’est-ce que purge cette option supprime ?

Si vous utilisez la commande uninstall.exe purge, toutes les traces XenServer VM Tools sont supprimées de votre machine virtuelle 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 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 du périphérique.
  • Désinstalle les appareils cachés. Cette action est identique à celle exécutée avec l’option de ligne de commande hidden.
  • 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 automatiquement réinstallés.
• Registre :
  • Supprime les informations de registre périmées utilisées par les versions non prises en charge des pilotes.
  • Supprime les clés liées aux outils dans HKLM\System\CurrentControlSet\Control\Class\...
  • Supprime les clés liées aux outils de HKLM\System\CurrentControlSet\Services.
  • Supprime les clés liées aux outils dans HKLM\System\CurrentControlSet\Enum\...
• Fichiers :
  • Supprime tous les fichiers de pilote XenServer VM Tools de C:\Windows\System32 et de C:\Windows\System32\drivers.
  • Supprime les fichiers XenServer VM Tools INF de C:\Windows\INF.
  • Supprime tous les fichiers périmés laissés par les versions non prises en charge des outils depuis C:\Program Files\Citrix\XenTools et C:\Program Files\XenServer\XenTools.
• Autres :
  • Supprime les anciennes entrées dans Ajout/Suppression de programmes. Cette action est identique à celle exécutée avec l’option de ligne de commande cleanup.
  • Efface certaines informations d’état périmées de l’InstallAgent.
  • xenfilt.sys Suppression des filtres supérieurs. Cette modification xenfilt.sys empêche le chargement sur les nœuds du pilote.
  • Supprime les unplug clés, ce qui fait que la machine virtuelle redevient des périphériques émulés au redémarrage.
  • Supprime StartOverride de StorNVMe. Cette modification force le démarrage stornvme.sys 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 XenServer VM Tools 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 des XenServer VM Tools pour Windows est disponible sur la page des téléchargements de XenServer.

XenServer VM Tools pour Windows 9.3.3

Publié le 4 juin 2024

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

• Programme d’installation : 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
• xenbd : 9.1.7.66
• xenvif : 9.1.11.92

Problèmes résolus dans la version 9.3.3

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 processeur virtuel peut consommer 100 % du processeur. Par conséquent, le serveur ne répond plus.
• Les machines virtuelles Windows hébergées dans un pool qui utilise le réseau OpenVSwitch et des trames Ethernet étiquetées VLAN peuvent présenter une connectivité réseau incohérente.

Versions précédentes

9.3.2

Publié le 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 commande uninstall.exe.
• Modifications visant à permettre à certaines machines virtuelles Windows d’utiliser jusqu’à 64 processeurs virtuels 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

Publié le 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 à l’utilitaire uninstall.exe, y compris au paramètre purge. Pour plus d’informations, consultez la section 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 caractères des clés de registre.

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

• Parfois, lorsque XenServer VM Tools sont mis à jour via Windows Update, les paramètres IP statiques sont perdus et les paramètres réseau sont modifiés pour utiliser le protocole DHCP.
• Sur les machines virtuelles Windows, les tables de subvention peuvent facilement s’épuiser. Dans ce cas, les demandes de lecture et d’écriture peuvent échouer ou des VIF supplémentaires ne sont pas activés correctement et ne peuvent pas démarrer.
• En de rares occasions, 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 réussite de la mise à niveau.
• Sur une machine virtuelle Windows, les versions précédente et ultérieure des outils ou de l’agent de gestion peuvent être répertoriées dans vos programmes installés.
  • (PRÉCÉDENT) Citrix XenServer Windows Management Agent
  • (ULTÉRIEUREMENT) Citrix Hypervisor PV Tools.

  Une fois que vous avez effectué la mise à jour vers la dernière version des outils, aucun de ces anciens noms n’apparaît dans la liste. Seul XenServer VM Tools est répertorié dans vos programmes installés.

9.3.0

Publié le 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 :

• Un logiciel de sécurité empêchait les disques secondaires marqués comme amovibles d’être exposés au système d’exploitation, à titre de mesure de prévention de l’exfiltration de données. Cette mise à jour vous permet de signaler un VBD comme étant non amovible et de le faire correctement apparaître via le système d’exploitation.
• Sur une machine virtuelle Windows, parfois l’adresse IP d’un SR-IOV VIF n’est pas visible dans XenCenter.

9.2.3

Publié le 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 horaire ne sont pas disponibles.
• Une condition de course peut entraîner l’affichage d’une erreur d’écran bleu sur les machines virtuelles Windows après une migration en direct sur la mise à jour cumulative 1 de Citrix Hypervisor 8.2.
• Les machines virtuelles Windows sur lesquelles la version 9.2.1 ou 9.2.2 de XenServer VM Tools est installée et qui sont des cibles PVS peuvent parfois se bloquer 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 du pool que chez les autres membres du pool.
• Sur les machines virtuelles Windows dotées de plus de 8 processeurs virtuels, 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

Publié le 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 demander un redémarrage avant la fin de l’installation du pilote. L’acceptation du redémarrage peut provoquer une erreur d’écran bleu sur votre machine virtuelle Windows.
• Lors de la compression des informations de diagnostic collectées, l’outil de diagnostic xt-bugtool expire après 20 secondes. Ce comportement peut entraîner 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’ont pas été publiées via Windows Update.

9.2.1

Publié le 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’a pas été fourni via Windows Update.

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

• Dans certains cas, l’état Laptop/Slate de la machine virtuelle ne peut pas être modifié.
• Une fois qu’une machine virtuelle a été redémarrée, elle peut parfois commencer à envoyer des messages de journal excessifs au fichier daemon.log.
• Une situation de concurrence dans les dépendances liées à la charge des pilotes après une mise à niveau du système d’exploitation peut empêcher la mise à niveau des XenServer VM Tools.
• Une erreur de stockage peut provoquer le blocage des machines virtuelles Windows.
• Parfois, l’adresse IP d’un VIF SR-IOV n’est pas visible dans XenCenter. Pour résoudre le problème, redémarrez l’agent de gestion depuis le gestionnaire de services de la machine virtuelle.
• En cas de charge réseau et système élevée et de faibles ressources, les machines virtuelles peuvent subir des vérifications de bogues à la fois dans Citrix et dans des 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 empêcher ces vérifications de bogues.
• La mise à niveau des pilotes d’E/S Windows peut empêcher le démarrage des machines virtuelles UEFI, signalant « 0xC000000E. L’appareil requis n’est pas connecté ou n’est pas accessible. « »
• Un problème peut survenir lors de l’installation XenServer VM Tools après la désinstallation d’une version précédente 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é ».