XenServer® VM Tools para Windows

XenServer VM Tools (anteriormente Citrix VM Tools o XenServer PV Tools) para Windows proporcionan servicios de E/S de alto rendimiento sin la sobrecarga de la emulación de dispositivos tradicional. XenServer VM Tools para Windows constan de controladores de E/S (también conocidos como controladores paravirtualizados o controladores PV) y el Agente de administración.

XenServer VM Tools para Windows deben instalarse en cada VM de Windows para que la VM tenga una configuración totalmente compatible. Una VM funciona sin ellos, pero el rendimiento se ve afectado.

La versión de XenServer VM Tools para Windows se actualiza independientemente de la versión de XenServer. Para recibir soporte, asegúrese de que sus XenServer VM Tools para Windows se actualicen regularmente a la última versión, tanto en sus VM como en cualquier plantilla que utilice para crear sus VM. Para obtener más información sobre la última versión de las herramientas, consulte Novedades.

Instalar XenServer VM Tools

Nota:

Para instalar XenServer VM Tools para Windows en una VM de Windows, la VM debe ejecutar Microsoft .NET Framework versión 4.0 o posterior.

XenServer VM Tools para Windows se instalan de forma predeterminada en el directorio C:\Program Files\XenServer\XenTools de la VM.

Para instalar XenServer VM Tools para Windows:

1. Recomendamos que haga una instantánea de su VM antes de instalar o actualizar XenServer VM Tools.

2. Descargue el archivo XenServer VM Tools para Windows desde la página de descargas de XenServer.

3. verificar su descarga con el valor SHA-256 proporcionado.

4. Copie el archivo en su VM de Windows o en una unidad compartida a la que pueda acceder la VM de Windows.

5. Ejecute el archivo managementagentx64.msi para iniciar la instalación de XenServer VM Tools.

   Msiexec.exe /package managementagentx64.msi
   

6. Siga las indicaciones del instalador.

   • Siga las instrucciones del asistente para aceptar el acuerdo de licencia y elegir una carpeta de destino.

   • Personalice la configuración en la página Configuración de instalación y actualizaciones.

     De forma predeterminada, el asistente muestra la siguiente configuración recomendada:

     • Mantener las XenServer VM Tools para Windows actualizadas automáticamente.

     Para algunos casos de uso, se recomiendan diferentes configuraciones de actualización. Para obtener más información, consulte Actualizar XenServer VM Tools.

     Para configurar los ajustes de actualización, puede realizar los siguientes cambios:

     • Si no desea permitir la actualización automática del Agente de administración, desmarque la casilla de verificación Mantener las XenServer VM Tools para Windows actualizadas automáticamente.

   • Haga clic en Siguiente y luego en Instalar para iniciar el proceso de instalación de las XenServer VM Tools para Windows.

7. Reinicie la VM cuando se le solicite para completar el proceso de instalación.

   Es posible que los clientes que instalan las XenServer VM Tools para Windows o el Agente de administración a través de RDP no vean el mensaje de reinicio, ya que solo aparece en la sesión de la consola de Windows. Para asegurarse de reiniciar su VM (si es necesario) y de que su VM alcance un estado optimizado, especifique la opción de reinicio forzado en RDP. La opción de reinicio forzado reinicia la VM solo si es necesario para que la VM alcance un estado optimizado.

Advertencia:

La instalación o actualización de las XenServer VM Tools para Windows puede provocar que el nombre descriptivo y el identificador de algunos adaptadores de red cambien. Cualquier software configurado para usar un adaptador en particular podría tener que reconfigurarse después de la instalación o actualización de las XenServer VM Tools para Windows.

Instalación silenciosa

Para instalar las XenServer VM Tools para Windows de forma silenciosa y evitar que el sistema se reinicie, ejecute el siguiente comando:

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

Se puede obtener una instalación no interactiva, pero no silenciosa, ejecutando:

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

Notas:

• El parámetro /quiet se aplica únicamente a los cuadros de diálogo de instalación, pero no a la instalación del controlador de dispositivo. Cuando se especifica el parámetro /quiet, la instalación del controlador de dispositivo solicita permiso para reiniciar si es necesario.
  • Cuando se especifica /quiet /norestart, el sistema no se reinicia una vez completada toda la instalación de las herramientas. Este comportamiento es independiente de lo que el usuario especifique en el cuadro de diálogo de reinicio.
  • Cuando se especifica /quiet /forcerestart, el proceso de actualización o instalación puede desencadenar varios reinicios. Este comportamiento es independiente de lo que el usuario especifique en el cuadro de diálogo de reinicio.
  • Cuando la instalación del controlador de dispositivo solicita permiso para reiniciar, una instalación de herramientas con el parámetro quiet especificado aún puede estar en curso. Utilice el Administrador de tareas para confirmar si el instalador sigue en ejecución.

Para personalizar la configuración de instalación, utilice los siguientes parámetros con los comandos de instalación silenciosa:

Por ejemplo, para realizar una instalación silenciosa de las herramientas que no permita futuras actualizaciones automáticas del Agente de administración, ejecute uno de los siguientes comandos:

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

Para instalaciones interactivas, silenciosas y pasivas, después del siguiente reinicio del sistema, puede haber varios reinicios automáticos antes de que las XenServer VM Tools para Windows estén completamente instaladas. Este comportamiento también se aplica a las instalaciones con la bandera /norestart especificada. Sin embargo, para las instalaciones donde se proporciona la bandera /norestart, el reinicio inicial podría iniciarse manualmente.

Actualizar XenServer VM Tools

Asegúrese de que sus XenServer VM Tools para Windows estén actualizadas a la última versión, tanto en sus máquinas virtuales como en cualquier plantilla que utilice para crear sus máquinas virtuales. Le recomendamos que cree una instantánea de su máquina virtual antes de actualizar las XenServer VM Tools. Para obtener más información sobre la última versión de las herramientas, consulte Novedades.

Importante:

Asegúrese de que todos los reinicios de VM solicitados se completen como parte de la actualización. Es posible que se requieran varios reinicios. Si no se completan todos los reinicios solicitados, la VM podría mostrar un comportamiento inesperado.

XenServer proporciona mecanismos de actualización automática para cada uno de sus componentes:

• El Agente de administración puede actualizarse automáticamente a sí mismo y a los controladores de E/S.
• Los controladores de E/S también se pueden actualizar a través de Windows Update al seleccionar una plantilla de VM en el asistente Nueva VM en XenCenter. Este enfoque no se recomienda, ya que las actualizaciones entregadas a través de Windows Update pueden causar reinicios de la VM. Para obtener detalles sobre cómo habilitar las actualizaciones de controladores de E/S a través de Windows Update, consulte Descripción general de los pasos de creación de VM.

Recomendamos instalar las herramientas con el instalador MSI y utilizar el mecanismo de actualización integrado del Agente de administración para gestionar las actualizaciones. Cuando instala las herramientas con el instalador, el mecanismo de actualización del Agente de administración detecta automáticamente las máquinas virtuales aprovisionadas mediante Machine Creation Services (MCS) o Citrix Provisioning, lo que le permite aplicar actualizaciones en la imagen dorada sin afectar a las máquinas aprovisionadas.

Alternativamente, puede actualizar uno o ambos componentes con el instalador.

El método de actualización a elegir para cada componente de las herramientas puede depender de su entorno.

Configuración de actualización recomendada

Para la mayoría de los casos de uso, recomendamos instalar las XenServer VM Tools para Windows con el instalador MSI y usar el Agente de administración para mantener tanto a sí mismo como a los controladores de E/S actualizados. Este enfoque evita los reinicios de VM que pueden ocurrir cuando las actualizaciones se entregan a través de Windows Update.

Recomendamos la siguiente configuración:

1. Habilitar actualizaciones del Agente de administración.

2. Deshabilitar las actualizaciones de los controladores de E/S a través de Windows Update.

Durante la instalación:

Se recomienda el valor predeterminado de la configuración:

Configuración para destinos de Citrix Provisioning™ o máquinas de reinicio al arrancar

Si tiene la intención de usar su VM de Windows como destino de Citrix Provisioning o con la marca de reinicio al arrancar habilitada, no puede usar ninguno de los mecanismos de actualización automatizados. Le recomendamos que establezca la siguiente configuración en la plantilla maestra que utiliza para crear estas VM:

1. Durante la creación de la VM, asegúrese de que la marca has-vendor-device esté establecida en false. Esto evita que Windows Update actualice automáticamente los controladores de E/S para XenServer VM Tools para Windows. Puede establecer esta marca de la siguiente manera:

   • Uso de la CLI. Para obtener más información, consulte Crear una VM de Windows mediante la CLI.

2. Deshabilitar las actualizaciones del Agente de administración.

Durante la instalación:

Especifique esta configuración al instalar por primera vez las XenServer VM Tools:

Configuración para actualizaciones automáticas solo por el Agente de administración

Puede configurar el Agente de administración para que se actualice a sí mismo y a los controladores de E/S.

Elija este enfoque si su organización requiere que revise las actualizaciones antes de aplicarlas a sus VM de Windows. Si este es el caso, también debe redirigir el Agente de administración para que obtenga sus actualizaciones de un servidor interno.

1. Deshabilitar las actualizaciones de los controladores de E/S a través de Windows Update.

2. (Opcional) Redirigir las actualizaciones del Agente de administración.

Durante la instalación:

Especifique esta configuración al instalar por primera vez las XenServer VM Tools:

Actualizar el Agente de administración

XenServer le permite actualizar el Agente de administración automáticamente en máquinas virtuales Windows nuevas y existentes. De forma predeterminada, XenServer permite la actualización automática del Agente de administración. Puede personalizar la configuración de actualización del Agente de administración durante la instalación de XenServer VM Tools para Windows. La actualización automática del Agente de administración se realiza sin problemas y no reinicia la máquina virtual. En los escenarios en los que se requiere un reinicio de la máquina virtual, aparece un mensaje en la pestaña Consola de la máquina virtual que notifica a los usuarios sobre la acción requerida.

Puede obtener las actualizaciones del Agente de administración automáticamente, siempre que la máquina virtual Windows tenga acceso a Internet.

Administrar las actualizaciones automáticas mediante la CLI

XenServer le permite usar la línea de comandos para administrar la actualización automática de los controladores de E/S y el Agente de administración. Puede ejecutar msiexec.exe con los argumentos que se enumeran en la siguiente tabla para especificar si los controladores de E/S y el Agente de administración se actualizan automáticamente. Para obtener información sobre cómo instalar XenServer VM Tools para Windows mediante msiexec.exe, consulte Instalación silenciosa.

Nota:

Para las máquinas virtuales administradas mediante PVS o MCS, el Agente de administración detecta automáticamente las máquinas no persistentes y deshabilita las actualizaciones automáticas en ellas. Esto le permite aplicar actualizaciones de herramientas en la imagen dorada sin afectar a las máquinas aprovisionadas, y evita los intentos de actualización en máquinas virtuales no persistentes que se perderían al restablecerse.

Habilitar las actualizaciones del Agente de administración

Para habilitar la actualización automática del Agente de administración por máquina virtual:

1. En la máquina virtual, abra un símbolo del sistema como administrador.

2. Ejecute el siguiente comando:

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

Para habilitar la actualización automática del Agente de administración por grupo, ejecute el siguiente comando en la consola del host:

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

Deshabilitar las actualizaciones del Agente de administración

Para deshabilitar la actualización automática del Agente de administración por máquina virtual:

1. En la máquina virtual, abra un símbolo del sistema como administrador.

2. Ejecute el siguiente comando:

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

Para deshabilitar la actualización automática del Agente de administración por grupo, ejecute el siguiente comando en la consola del host:

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

Redirigir las actualizaciones del Agente de administración

XenServer permite a los clientes redirigir las actualizaciones del Agente de administración a un servidor web interno antes de que se instalen. Esta redirección permite a los clientes revisar las actualizaciones antes de que se instalen automáticamente en la máquina virtual.

El Agente de administración utiliza un archivo de actualizaciones para obtener información sobre las actualizaciones disponibles. El nombre de este archivo de actualizaciones depende de la versión del Agente de administración que utilice:

• Para el Agente de administración 9.4.0 y posterior, use https://pvupdates.vmd.citrix.com.

Recomendamos encarecidamente que actualice a la versión más reciente del Agente de administración. Sin embargo, si utiliza una versión anterior del Agente de administración, proporcionamos los siguientes archivos de actualizaciones para usar con versiones anteriores:

• Para el Agente de administración 9.2.1.35 a 9.3.3.125 https://pvupdates.vmd.citrix.com/autoupdate.v1.json.
• Para el Agente de administración 9.0.0.0 a 9.2.0.27 https://pvupdates.vmd.citrix.com/updates.v9.json.

Complete los siguientes pasos para redirigir las actualizaciones del Agente de administración:

1. Descargue el archivo de actualizaciones.

2. Descargue los archivos MSI del Agente de administración a los que se hace referencia en el archivo de actualizaciones.

3. Valide que los hashes de los archivos MSI del Agente de administración coincidan con los referenciados en el archivo de actualizaciones.

4. Cargue los archivos MSI en un servidor web interno al que puedan acceder sus máquinas virtuales.

5. Actualice el archivo de actualizaciones para que apunte a los archivos MSI en el servidor web interno.

6. Cargue el archivo de actualizaciones en el servidor web.

Las actualizaciones automáticas también se pueden redirigir por máquina virtual o por grupo. Para redirigir las actualizaciones por máquina virtual:

1. En la máquina virtual, abra un símbolo del sistema como administrador.

2. Ejecute el comando

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

Para redirigir la actualización automática del Agente de administración por grupo, ejecute el siguiente comando:

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

Actualizar los controladores de E/S

Puede actualizar los controladores de E/S a través de Windows Update o mediante el Agente de administración. La sección Estado de virtualización de la pestaña General de una máquina virtual en XenCenter indica si la máquina virtual es apta para recibir actualizaciones de Windows Update. Alternativamente, puede desactivar las actualizaciones automáticas y administrar manualmente las actualizaciones de los controladores de E/S.

Cada controlador de E/S (como xennet, xenvif, xenvbd, xeniface y xenbus) tiene su propia versión. Para obtener detalles sobre las últimas versiones, consulte Novedades.

Habilitar las actualizaciones de controladores de E/S a través de Windows Update

Para obtener actualizaciones de controladores de E/S automáticamente de Microsoft Windows Update, se deben cumplir las siguientes condiciones:

• Windows Update está habilitado en la máquina virtual.

• La máquina virtual tiene acceso a Internet o puede conectarse a un servidor proxy WSUS.

• No está ejecutando la versión Core de Windows Server, ya que Windows Server Core no admite el uso de Windows Update para instalar o actualizar los controladores de E/S.

Puede habilitar las actualizaciones de controladores de E/S a través de Windows Update al seleccionar una plantilla de máquina virtual en el asistente Nueva máquina virtual de XenCenter. Para obtener detalles sobre cómo habilitar las actualizaciones de controladores de E/S a través de Windows Update, consulte Descripción general de los pasos de creación de máquinas virtuales.

Si no desea recibir actualizaciones de controladores de E/S de Windows Update, desactive Windows Update en su máquina virtual o especifique una política de grupo.

Deshabilitar las actualizaciones de controladores de E/S a través de Windows Update

Puede deshabilitar las actualizaciones de controladores de E/S a través de Windows Update tanto para máquinas virtuales nuevas como existentes:

• Para máquinas virtuales nuevas: Al crear una nueva máquina virtual con el asistente Nueva máquina virtual en XenCenter, puede deshabilitar las actualizaciones automáticas de controladores de E/S configurando un indicador. Esto es particularmente importante para los destinos de Citrix Provisioning o las máquinas de reinicio al arrancar, donde la desactivación de las actualizaciones automáticas garantiza la estabilidad. Para obtener más información, consulte Descripción general de los pasos de creación de máquinas virtuales y Configuración para destinos de Citrix Provisioning o máquinas de reinicio al arrancar. Para usuarios avanzados que prefieren administrar esta configuración mediante la línea de comandos, consulte Crear una máquina virtual Windows mediante la CLI.

• Para máquinas virtuales existentes: Si la máquina virtual ya está implementada, puede deshabilitar las actualizaciones de controladores de E/S configurando una política de grupo. Esto garantiza que la máquina virtual no reciba actualizaciones automáticas de Windows Update.

Configurar el agente de administración para actualizar los controladores de E/S

Para obtener más información, consulte Instalar XenServer VM Tools para Windows.

Reinicios automáticos

Asegúrese de que todos los reinicios de VM solicitados se completen como parte de la actualización. Es posible que se requieran varios reinicios. Si no se completan todos los reinicios solicitados, es posible que observe un comportamiento inesperado.

Puede establecer una clave de registro que especifique el número máximo de reinicios automáticos que se realizan al instalar los controladores a través del Administrador de dispositivos o Windows Update. Después de haber instalado la versión 9.1.1.8 o posterior del controlador xenbus, las XenServer VM Tools para Windows utilizan la guía proporcionada por esta clave de registro. Si tiene una versión anterior de xenbus, es posible que siga experimentando un comportamiento inesperado. Si esto ocurre, reinicie la VM desde XenCenter.

Para usar esta función, le recomendamos que establezca la siguiente clave de registro lo antes posible: HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot. El valor de la clave de registro debe ser un número entero positivo. Le recomendamos que establezca el número de reinicios en la clave de registro en 3.

Cuando se establece esta clave de registro, las XenServer VM Tools para Windows realizan tantos reinicios como sean necesarios para completar las actualizaciones o el número de reinicios especificado por la clave de registro, el valor que sea menor.

Antes de cada reinicio, Windows puede mostrar una alerta durante 60 segundos que advierte del próximo reinicio. Puede descartar la alerta, pero esta acción no cancela el reinicio. Debido a este retraso entre los reinicios, espere unos minutos después del reinicio inicial para que se complete el ciclo de reinicio.

Notas:

Esta configuración es necesaria para servidores sin cabeza con direcciones IP estáticas.

Esta función de reinicio automático solo se aplica a las actualizaciones de los controladores de E/S de Windows a través del Administrador de dispositivos o Windows Update. Si utiliza el instalador del Agente de administración para implementar los controladores, el instalador ignora esta clave de registro y gestiona los reinicios de la VM según su propia configuración.

Si, después de esperar a que se completen todos los reinicios, sigue experimentando un comportamiento inesperado, inicie un reinicio de la VM desde XenCenter® para intentar restaurar la configuración.

Configuración de reinicios automáticos mediante la línea de comandos

En su VM de Windows, abra un símbolo del sistema como administrador y ejecute el siguiente comando:

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

Alternativamente, si su VM de Windows está configurada para permitir el acceso remoto, puede ejecutar el siguiente comando desde un símbolo del sistema de administrador en otro sistema:

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

Para obtener más información, consulte el comando reg add de Windows.

Configuración de reinicios automáticos mediante el Editor del Registro

1. Desde el menú Inicio de Windows, abra el Editor del Registro y navegue hasta la clave: HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters​.
2. Cree una nueva subclave del tipo REG_DWORD con el nombre: Autoreboot.
3. Establezca el valor de Autoreboot en un número entero, por ejemplo, 3.

Otras configuraciones y consultas

Buscar la versión del controlador de E/S

Para averiguar la versión de los controladores de E/S instalados en la VM:

1. Navegue hasta C:\Windows\System32\drivers.

2. Localice el controlador en la lista.

3. Haga clic con el botón derecho en el controlador y seleccione Propiedades y, a continuación, Detalles.

   El campo Versión del archivo muestra la versión del controlador instalado en la VM.

Buscar la versión del agente de administración

Para averiguar la versión del agente de administración instalado en la VM:

1. Navegue hasta C:\Program Files\XenServer\XenTools.

2. Haga clic con el botón derecho en XenGuestAgent de la lista y haga clic en Propiedades y luego en Detalles.

   El campo Versión del archivo muestra la versión del Agente de administración instalado en la VM.

Cambios de comportamiento en la versión 9.6.0.19

A partir de XenServer VM Tools para Windows 9.6.0.19, el comportamiento de activación del dispositivo ha cambiado para mejorar la fiabilidad cuando cambia el parámetro has-vendor-device de la VM.

XenServer VM Tools para Windows ahora:

• Utiliza la activación de dispositivos basada en prioridades
• Administra automáticamente los cambios de configuración
• Utiliza identificadores de dispositivos secundarios coherentes en todas las transiciones de dispositivos
• Realiza la transición automáticamente al dispositivo PV correcto después de reiniciar

Estas mejoras son particularmente importantes para los entornos MCS y PVS que utilizan imágenes doradas compartidas.

No se requiere una limpieza manual del dispositivo ni ciclos de reinicio adicionales después de cambiar el parámetro has-vendor-device.

Todavía se requiere un apagado y reinicio para que el cambio de parámetro surta efecto.

Solucionar problemas de XenServer VM Tools para Windows

Proporcionamos una herramienta, xtbugtool, que captura información de diagnóstico para XenServer VM Tools. Para obtener más información, consulte Solucionar problemas de VM.

Cambio del parámetro has-vendor-device

Cambiar el parámetro has-vendor-device de la VM requiere que la VM se apague y se reinicie.

Nota:

No se recomienda cambiar has-vendor-device una vez que la imagen se ha implementado, ya que las imágenes reset-on-boot reconstruyen la configuración en cada arranque y esto provoca cambios en las configuraciones de red.

En XenServer VM Tools para Windows 9.6.0.19 y posteriores:

• El dispositivo PV correcto se selecciona automáticamente durante el arranque
• Se evitan las conexiones de backend duplicadas
• Las discrepancias en la configuración del dispositivo se resuelven automáticamente

No deberían ser necesarios ciclos de reinicio adicionales ni intervención manual dentro de la VM después del reinicio.

Si hay instaladas versiones anteriores de XenServer VM Tools para Windows, es posible que aún se requieran reinicios adicionales o una limpieza manual del dispositivo.

Desinstalar XenServer VM Tools

No recomendamos eliminar XenServer VM Tools de sus máquinas virtuales Windows. Estas herramientas son necesarias para que sus máquinas virtuales Windows sean totalmente compatibles. Eliminarlas puede causar un comportamiento inesperado. Desinstale manualmente XenServer VM Tools solo como último recurso.

Desinstalación estándar

Para realizar una desinstalación estándar de XenServer VM Tools, puede utilizar la función de Windows Agregar o quitar programas:

1. Cree una instantánea de la VM antes de empezar.
2. En la VM de Windows, vaya a Agregar o quitar programas.
3. Seleccione XenServer VM Tools y haga clic en Uninstall.
4. Reinicie la VM.

El comando uninstall.exe

La desinstalación de XenServer VM Tools mediante la función Agregar o quitar programas de Windows llama al archivo <tools-install-directory>\uninstall.exe para realizar las acciones de desinstalación. En su lugar, puede optar por llamar a este comando desde un terminal de PowerShell o un símbolo del sistema con privilegios de administrador.

1. Cree una instantánea de la VM antes de empezar.
2. Como administrador, abra un símbolo del sistema o un terminal de PowerShell.
3. Ejecute el comando <tools-install-directory>\uninstall.exe.
4. Reinicie la VM.

Opciones de comando

El comando uninstall.exe acepta los siguientes parámetros:

• help - Muestra información de uso del comando.
• log - Genera un archivo de registro que indica lo que ha hecho el comando.
• verbose - Imprime en la consola lo que ha hecho el comando.
• disable - Deshabilita los controladores que fueron instalados por el instalador MSI.
• force-disable - Deshabilita los controladores en todas las situaciones.
• hidden - Elimina dispositivos ocultos. Estos dispositivos no se utilizan y han sido reemplazados, pero podrían haber dejado entradas de registro obsoletas.
• cleanup - Elimina desinstaladores antiguos de Agregar o quitar programas. Estos desinstaladores pueden incluir entradas duplicadas de versiones anteriores de las herramientas.
• purge - (9.3.1 y posteriores) Restablece la VM a un estado limpio, tal como estaba antes de que se instalara cualquier parte de las XenServer VM Tools. Para obtener más información, consulte Desinstalación completa de todos los componentes de XenServer VM Tools.
• install - (9.3.1 y posteriores) Instala el conjunto actual de controladores de E/S y solicita un reinicio de la VM cuando sea necesario.
• reboot - Reinicia la VM después de que todas las demás operaciones de comando hayan finalizado.

Desinstalación completa de todos los componentes de XenServer VM Tools

La última versión de XenServer VM Tools para Windows (9.3.1 y posteriores) incluye el comando uninstall.exe purge. La opción purge de la aplicación uninstall.exe restablece una VM al estado anterior a la instalación de cualquier controlador de E/S. Si tiene problemas al actualizar sus herramientas a una versión más reciente o necesita un estado limpio para instalar un conjunto posterior de herramientas en su VM, utilice esta utilidad.

1. Cree una instantánea de la VM antes de empezar.
2. Como administrador, abra un símbolo del sistema o una terminal de PowerShell.
3. Ejecute el comando <tools-install-directory>\uninstall.exe purge verbose
4. Reinicie la VM.

Después de usar este comando, no es necesario realizar ningún paso de limpieza manual como podría haber tenido que hacer con versiones anteriores de XenServer VM Tools. Todos los cambios relacionados con XenServer VM Tools se han eliminado.

¿Qué elimina la opción purge?

Si utiliza el comando uninstall.exe purge, se eliminan todos los rastros de XenServer VM Tools de su VM de Windows. La lista de acciones realizadas por este comando es la siguiente:

• Servicios:
  • Deshabilita todos los servicios de XenServer VM Tools, lo que impide que los controladores y servicios instalados se inicien al reiniciar.
  • Detiene cualquier servicio de XenServer VM Tools en ejecución.
• Controladores:
  • Desinstala los controladores de E/S de todos los nodos de dispositivo.
  • Desinstala los dispositivos ocultos. Esta acción es la misma que la realizada por la opción de línea de comandos hidden.
  • Desinstala los paquetes de controladores en caché, lo que los elimina del almacén de controladores. Como resultado, los controladores de E/S no se reinstalan automáticamente.
• Registro:
  • Elimina la información de registro obsoleta utilizada por versiones de los controladores que ya no tienen soporte.
  • Elimina las claves relacionadas con las herramientas de HKLM\System\CurrentControlSet\Control\Class\...
  • Elimina las claves relacionadas con las herramientas de HKLM\System\CurrentControlSet\Services.
  • Elimina las claves relacionadas con las herramientas de HKLM\System\CurrentControlSet\Enum\...
• Archivos:
  • Elimina cualquier archivo de controlador de XenServer VM Tools de C:\Windows\System32 y C:\Windows\System32\drivers.
  • Elimina los archivos INF de XenServer VM Tools de C:\Windows\INF.
  • Elimina cualquier archivo obsoleto dejado por versiones de las herramientas que ya no tienen soporte de C:\Program Files\Citrix\XenTools y C:\Program Files\XenServer\XenTools.
• Otros:
  • Elimina entradas antiguas en Agregar o quitar programas. Esta acción es la misma que la realizada por la opción de línea de comandos cleanup.
  • Borra parte de la información de estado obsoleta de InstallAgent.
  • Elimina xenfilt.sys de los filtros superiores. Este cambio evita que xenfilt.sys se cargue en cualquier nodo de controlador.
  • Elimina las claves unplug, lo que hace que la VM vuelva a los dispositivos emulados al reiniciar.
  • Elimina el StartOverride de StorNvme. Este cambio fuerza a stornvme.sys a iniciarse en el arranque y permite que funcionen los dispositivos de arranque NVMe (UEFI) emulados.

Mejores prácticas

Versión recomendada para implementaciones de MCS y PVS

Utilice XenServer VM Tools para Windows 9.6.0.19 o posterior para entornos donde las VM realizan la transición entre has-vendor-device=true y has-vendor-device=false.

Esta versión mejora la fiabilidad de la transición de dispositivos PV y reduce las inconsistencias de configuración para implementaciones de imágenes doradas compartidas.

Novedades

La versión de XenServer VM Tools para Windows se actualiza independientemente de la versión de XenServer. Asegúrese de que sus XenServer VM Tools para Windows se actualicen regularmente a la última versión, tanto en sus VM como en cualquier plantilla que utilice para crear sus VM.

La última versión de XenServer VM Tools para Windows está disponible en la página de descargas de XenServer.

XenServer VM Tools para Windows 9.6.0

Publicado el 13 de mayo de 2026

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.6.0
• Agente de administración 9.6.0.12
• bus xen 9.1.13.23
• interfaz xen 9.1.14.6
• xennet versión 9.1.8.6
• xenvbd versión 9.1.11.5
• xenvif versión 9.1.15.8

Cambios en 9.6.0

• Resistencia mejorada a los cambios de configuración de la VM.

• Notificaciones mejoradas desde el icono de la bandeja del sistema.

Corregido en 9.6.0

• Se corrigió un problema por el que el tráfico de red RSS no se distribuía entre las CPU.

• Se corrigió un error de comprobación al actualizar XenServer VM Tools para Windows, en algunas configuraciones.

Versiones anteriores

9.4.2

Publicado el 24 de septiembre de 2025

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.4.2
• Agente de administración 9.3.2.95
• xenbus versión 9.1.12.120
• xeniface, versión 9.1.13.96
• xennet, versión 9.1.7.65
• xenvbd versión 9.1.10.84
• xenvif versión 9.1.14.109

Cambios en 9.4.2

• Opciones de instalación simplificadas
• Icono de la bandeja del sistema, que proporciona notificaciones de XenServer VM Tools para Windows

Esta versión también incluye actualizaciones para recopilar telemetría.

Corregido en 9.4.2

• Distribución mejorada de la carga de trabajo de red entre las CPU

9.4.1

Publicado el 27 de mayo de 2025

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.4.1
• Agente de administración: 9.3.1.80
• xenbus: 9.1.11.115
• xeniface: 9.1.12.94
• xennet: versión 9.1.7.65
• xenvbd: versión 9.1.9.82
• Interfaz virtual de Xen: 9.1.13.107

Todos los clientes afectados por los problemas descritos en CTX692748 - XenServer y Citrix Hypervisor Security Bulletin deben actualizar a esta versión de las herramientas o a una posterior.

Esta versión también incluye actualizaciones de la telemetría recopilada.

Problemas corregidos en 9.4.1

Esta versión contiene correcciones para los siguientes problemas:

• En algunos casos, con XenServer VM Tools 9.4.0 instalado, Windows 11 no se puede actualizar de 23H2 a 24H2.
• El Agente de administración a veces puede fallar al reiniciar o iniciar la VM.
• Algunas máquinas virtuales Windows pueden experimentar reinicios forzados inesperados.

9.4.0

Publicado el 22 de octubre de 2024

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.4.0
• Agente de administración: 9.3.0.65
• Bus de Xen: 9.1.9.105
• xeniface versión 9.1.10.87
• xennet versión 9.1.7.65
• xenvbd: 9.1.8.79
• xenvif: 9.1.12.101

Esta versión contiene correcciones para los siguientes problemas:

• La versión de XenServer VM Tools para Windows no se informa correctamente a Citrix Hypervisor™ debido a que el Agente de administración comprueba el valor incorrecto de InstallStatus en el registro.
• Debido a un manejo incompleto de las claves de registro StartOverride de StorNvme, podría encontrarse con una BSOD con el error “Inaccessible Boot Device” después de reiniciar su VM de Windows durante una actualización de XenServer VM Tools a través de Windows Update.
• A veces, al actualizar XenServer VM Tools para Windows, la configuración de IP estática se pierde y la configuración de red cambia para usar DHCP. Este problema se resuelve si está actualizando desde la versión 9.3.3 o posterior (por ejemplo, de 9.4.0 a una versión más reciente). Sin embargo, si está actualizando desde una versión anterior a la 9.3.3 (por ejemplo, de 9.3.2 a 9.4.0), el problema ocurrirá una vez durante la actualización, pero no afectará a futuras actualizaciones. Para obtener más información, consulte el artículo de soporte Pérdida de IP estática al actualizar a VM Tools para Windows 9.3.3 o anterior.

Esta versión contiene los siguientes problemas conocidos:

• Si depende del Management Agent para las actualizaciones automáticas, debe actualizar manualmente a la versión 9.4.0 o posterior, ya que la 9.3.3 no se actualiza automáticamente a la 9.4.0 debido a problemas de comprobación de certificados. Para resolver esto, instale manualmente XenServer VM Tools para Windows 9.4.0 o una versión más reciente en cada VM.

9.3.3

Publicado el 4 de junio de 2024

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.3.3
• Management Agent: 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.

Esta versión incluye correcciones para los siguientes problemas:

• A veces, el Agente de administración puede fallar con una ManagementException cuando la VM está bajo una carga pesada.
• En los servidores Windows 2022, una única vCPU puede consumir el 100% de la CPU. Como resultado, el servidor deja de responder.
• Las máquinas virtuales Windows alojadas en un grupo que utiliza redes OpenVSwitch y tramas Ethernet etiquetadas con VLAN pueden tener una conectividad de red inconsistente.

9.3.2

Publicado el 27 de noviembre de 2023

Esta versión cambia la marca de Citrix® VM Tools a XenServer VM Tools.

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.3.2
• Agente de administración: 9.2.2.435
• xenbus: 9.1.7.80.
• xeniface: 9.1.8.69.
• xennet: 9.1.5.51.
• xenvbd, versión 9.1.6.58
• xenvif, versión 9.1.10.83

Esta versión también contiene las siguientes mejoras:

• Mejoras en el comando uninstall.exe.
• Cambios para permitir que algunas máquinas virtuales Windows utilicen hasta 64 vCPU, siempre que su versión de XenServer y el sistema operativo Windows lo admitan.

Esta versión incluye una solución para el siguiente problema:

• En ocasiones, al instalar las herramientas de máquina virtual de XenServer, un error no fatal puede provocar que la instalación falle.

9.3.1

Publicado el 25 de enero de 2023

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.3.1
• Agente de administración: 9.2.1.35
• xenbus: 9.1.5.54
• xeniface: 9.1.5.42
• xennet: versión 9.1.3.34
• xenvbd: versión 9.1.4.37
• xenvif: versión 9.1.8.58

Esta versión incluye las siguientes mejoras:

• Mejoras en la utilidad uninstall.exe, incluido el parámetro purge. Para obtener más información, consulte Desinstalar XenServer VM Tools.
• Mejoras generales en el instalador de XenServer VM Tools.
• Mejoras generales en el manejo de cadenas de claves de registro.

Esta versión contiene correcciones para los siguientes problemas:

• A veces, cuando las XenServer VM Tools se actualizan a través de Windows Update, la configuración de IP estática se pierde y la configuración de red cambia para usar DHCP.
• En las máquinas virtuales Windows, las tablas de concesión pueden agotarse fácilmente. Cuando esto ocurre, las solicitudes de lectura y escritura pueden fallar o las VIF adicionales no se habilitan correctamente y no se inician.
• En raras ocasiones, al actualizar las XenServer VM Tools para Windows, el Agente de administración existente puede no apagarse e impedir que la actualización se realice correctamente.
• En una máquina virtual Windows, es posible que vea tanto la versión anterior como una posterior de las herramientas o del Agente de administración en sus Programas instalados.
  • (ANTERIOR) Agente de administración de Citrix XenServer para Windows
  • (POSTERIOR) Citrix Hypervisor PV Tools.

  Después de actualizar a la última versión de las herramientas, ninguno de estos nombres anteriores aparece en la lista. Solo XenServer VM Tools aparece en sus Programas instalados.

9.3.0

Publicado el 26 de julio de 2022

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.3.0
• Agente de administración: 9.2.0.27
• xenbus: versión 9.1.4.49
• xeniface versión: 9.1.4.34
• xennet versión: 9.1.3.34
• xenvbd: 9.1.3.33
• xenvif: 9.1.6.52

Esta versión incluye las siguientes mejoras:

• Mejoras generales en el instalador de XenServer VM Tools.

Esta versión contiene correcciones para los siguientes problemas:

• El software de seguridad estaba bloqueando que los discos secundarios marcados como extraíbles se expusieran al sistema operativo, como medida de prevención de la exfiltración de datos. Esta actualización le permite marcar un VBD como no extraíble y que este se exponga correctamente a través del sistema operativo.
• En una VM de Windows, a veces la dirección IP de un VIF SR-IOV no es visible en XenCenter.

9.2.3

Publicado el 28 de abril de 2022

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.2.3
• Agente de administración: 9.1.1.13
• xenbus: versión 9.1.3.30
• xeniface: versión 9.1.4.34
• Controlador xennet:
  • 9.1.1.8 (para Windows Server 2012 y Windows Server 2012 R2)
  • 9.1.2.23 (para todos los demás sistemas operativos Windows compatibles)
• Controlador xenvbd: 9.1.2.20
• xenvif: versión 9.1.5.48

Esta versión contiene correcciones para los siguientes problemas:

• En XenServer VM Tools para Windows versión 9.2.2, las opciones de sincronización de hora no están disponibles.
• Una condición de carrera puede provocar que las máquinas virtuales Windows muestren un error de pantalla azul después de la migración en vivo en Citrix Hypervisor 8.2 Cumulative Update 1.
• Las máquinas virtuales Windows que tienen instalada la versión 9.2.1 o 9.2.2 de XenServer VM Tools y que son destinos PVS a veces pueden congelarse con una pantalla negra. El mensaje “Guest Rx stalled” está presente en los registros del kernel de dom0. Este problema ocurre con más frecuencia en los coordinadores de grupos que en otros miembros del grupo.
• En las máquinas virtuales Windows con más de 8 vCPU, el escalado del lado de recepción podría no funcionar porque el controlador xenvif no puede configurar la tabla de indirección.

9.2.2

Publicado el 14 de enero de 2022

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.2.2
• Agente de administración: 9.1.1.13
• xenbus: versión 9.1.3.30
• xeniface: 9.1.2.22
• xennet:
  • 9.1.1.8 (para Windows Server 2012 y Windows Server 2012 R2)
  • 9.1.2.23 (para todos los demás sistemas operativos Windows compatibles)
• xenvbd: 9.1.2.20
• xenvif: 9.1.3.31

Esta versión contiene correcciones para los siguientes problemas:

• Durante una actualización de las herramientas, el controlador xenbus puede solicitar un reinicio antes de que se complete la instalación del controlador. Aceptar el reinicio puede causar un error de pantalla azul en su VM de Windows.
• Al comprimir la información de diagnóstico recopilada, la herramienta de diagnóstico xt-bugtool agota el tiempo de espera después de 20 segundos. Este comportamiento puede provocar que el archivo zip de diagnóstico no se cree correctamente.
• El uso compartido del portapapeles de VNC no funciona.
• Las versiones anteriores de los controladores no se lanzaron a través de Windows Update.

9.2.1

Publicado el 24 de junio de 2021

Este conjunto de herramientas contiene las siguientes versiones de componentes:

• Instalador: 9.2.1
• Agente de administración: 9.1.0.10
• bus de Xen: 9.1.2.14
• interfaz de Xen: 9.1.1.11
• xennet - 9.1.1.8
• xenvbd - 9.1.1.8
• xenvif: 9.1.2.16

Nota:

Este conjunto de controladores no se proporcionó a través de Windows Update.

Esta versión contiene correcciones para los siguientes problemas:

• En algunos casos, el estado de portátil/tableta de la VM no se puede cambiar.
• Después de reiniciar una VM, a veces puede empezar a enviar mensajes de registro excesivos al archivo daemon.log.
• Una condición de carrera en las dependencias de carga del controlador después de una actualización del sistema operativo puede impedir que se actualicen las Herramientas de VM de XenServer.
• Un error de almacenamiento puede provocar que las VM de Windows se bloqueen.
• A veces, la dirección IP de un VIF SR-IOV no es visible en XenCenter. Para solucionar el problema, reinicie el Agente de administración desde el Administrador de servicios de la VM.
• Bajo una alta carga de red y del sistema, y con pocos recursos, las VM pueden experimentar comprobaciones de errores tanto en los controladores de Citrix como en los de terceros, normalmente con el código IRQL_NOT_LESS_OR_EQUAL. Esta corrección mejora el almacenamiento en búfer de red para evitar estas comprobaciones de errores.
• La actualización de los controladores de E/S de Windows puede provocar que las VM UEFI no arranquen, informando de “0xC000000E. Un dispositivo requerido no está conectado o no se puede acceder a él.”
• Puede ocurrir un problema al instalar las Herramientas de VM de XenServer después de desinstalar una versión anterior de las Herramientas de VM de XenServer que devuelve el siguiente mensaje de error: “Este dispositivo no puede iniciarse (código 10) (Operación fallida) La operación solicitada no se realizó correctamente.”