XenServer VM Tools pour Windows

XenServer VM Tools pour Windows (anciennement Citrix VM Tools) fournit des services d’E/S hautes performances sans les coûts liés à l’émulation d’appareils 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 Citrix Hypervisor. 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. Pour plus d’informations sur la dernière version des outils, consultez Mises à jour XenServer VM Tools pour Windows ou 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.

Avant d’installer XenServer VM Tools 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 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 Citrix Hypervisor.

   1. Connectez-vous à votre compte Citrix pour accéder aux fichiers téléchargeables.
   2. Développez les sections du 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, accédez à la section Composants principaux de Citrix Hypervisor .

      XenServer VM Tools pour Windows sont disponibles en versions 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 fichier 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 choisissez un dossier de destination.

   • Personnalisez les paramètres de la page Paramètres d’installation et de mise à jour . L’assistant d’ installation de l’agent de gestion Windows Citrix Hypervisor affiche les paramètres recommandés. Par défaut, l’assistant affiche les paramètres suivants :

     • Installez les pilotes d’E/S maintenant
     • Autoriser les mises à jour automatiques des
     • Interdire les mises à jour automatiques 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 à actualiser 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 les pilotes d’E/S automatiquement.

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

   • Cliquez sur Suivant puis sur Installer pour démarrer 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 XenServer VM Tools pour Windows peuvent demander le redémarrage avec /quiet /norestart ou /quiet /forcerestart après 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 les XenServer VM Tools pour Windows afin d’installer l’agent de gestion et de conserver une configuration prise en charge.

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

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

Ou

Setup.exe /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’autorisent pas les futures mises à jour automatiques de l’agent de gestion et n’envoient 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 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.

XenServer VM Tools pour Windows sont installés par défaut dans le répertoire C:\Program Files\Citrix\XenTools de 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 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 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 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.

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.

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 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 d’installer ou de mettre à jour XenServer VM Tools.

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 effectuer la mise à 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 n’effectuez pas cette étape, le processus d’installation MSI échoue.

Nous vous recommandons d’utiliser les paramètres suivants pour mettre à jour les différents composants des 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\Parameters\Autoreboot
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.

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.

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, cela peut entraîner un comportement inattendu.

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

Mettre à jour les pilotes d’E/S

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

• 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 émis avec Citrix Hypervisor 8.2

• Windows Update est activé dans la machine virtuelle

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

Remarque :

Windows Server Core ne prend pas en charge l’utilisation de Windows Update pour installer ou actualiser les pilotes d’E/S. Utilisez plutôt le programme d’installation de XenServer VM Tools pour Windows disponible sur la page de téléchargement de Citrix Hypervisor. XenServer VM Tools sont disponibles en tant que composant téléchargeable dans toutes les versions prises en charge de Citrix Hypervisor. Vous devez vous connecter à votre compte Citrix pour accéder à ces téléchargements.

Les clients peuvent également recevoir automatiquement les mises à jour des pilotes d’E/S via le mécanisme de mise à jour automatique de l’agent de gestion. Vous pouvez configurer ce paramètre lors de l’installation de XenServer VM Tools pour Windows. Pour plus d’informations, consultez Installer XenServer VM Tools pour Windows.

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.

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.

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 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 les mises à jour de l’agent de gestion automatiquement, à condition :

• 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 avec Citrix Hypervisor 7.0 ou version ultérieure

• La machine virtuelle Windows a accès à Internet

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

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

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

Ou

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

Rediriger les mises à jour de Management

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

Pour rediriger les mises à jour de Management Agent :

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

Désactiver les mises à jour de Management

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\Citrix\XenTools /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 :

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

Modifier les paramètres de mise à jour automatique du pilote d’

Lors de l’installation de XenServer VM Tools pour Windows, vous pouvez spécifier si vous souhaitez autoriser l’agent de gestion à 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\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
       InstallDrivers /d YES/NO
   <!--NeedCopy-->
   

Pour envoyer des informations d’utilisation anonymes à Citrix :

Lors de l’installation de XenServer VM Tools pour Windows, vous pouvez spécifier si vous souhaitez envoyer des informations d’utilisation anonymes à Citrix. Si vous souhaitez 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\Citrix\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ésinstaller XenServer VM Tools pour Windows

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 Citrix Hypervisor PV 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 commande 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 commande 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 de C:\Program Files\Citrix\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 Citrix Hypervisor. 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.

XenServer VM Tools pour Windows 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

Améliorations apportées à la version 9.3.1

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 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 caractères des clés de registre.

Problèmes résolus dans la version 9.3.1

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.
• Dans de rares cas, lors de la mise à niveau des 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, vous pouvez voir à la fois la version précédente et la dernière version des outils ou de l’agent de gestion répertoriées dans vos Programmes installés.
  • (PRÉCÉDENT) Citrix XenServer Windows Management Agent
  • (DERNIER) Citrix Hypervisor PV Tools.

Versions précédentes

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 sur les maîtres de pool que sur les autres membres du pool.
• Sur les machines virtuelles Windows comportant plus de 8 processeurs virtuels, Receive Side Scaling 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 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 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 être soumises à 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é ».