Citrix Hypervisor

适用于 Windows 的 XenServer VM Tools

June 19, 2024

投稿者:

X X

适用于 Windows 的 XenServer VM Tools（以前称为 Citrix VM Tools）可提供高性能 I/O 服务，同时又不会产生传统设备模拟开销。适用于 Windows 的 XenServer VM Tools 由 I/O 驱动程序（也称为半虚拟化驱动程序或 PV 驱动程序）和管理代理组成。

必须在每个 Windows VM 上安装适用于 Windows 的 XenServer VM Tools，才能使 VM 具有完全受支持的配置。尽管没有这些工具 VM 也可以运行，但是性能可能会受到影响。

适用于 Windows 的 XenServer VM Tools 版本的更新与 Citrix Hypervisor 的版本无关。请务必同时在您的 VM 中以及在用于创建 VM 的任何模板中将适用于 Windows 的 XenServer VM Tools 定期更新到最新版本。有关最新版本的工具的详细信息，请参阅适用于 Windows 的 XenServer VM Tools 的更新或新增功能。

安装 XenServer VM Tools

注意：

要在 Windows VM 上安装适用于 Windows 的 XenServer VM Tools，该 VM 必须运行 Microsoft .NET Framework 4.0 或更高版本。

在安装适用于 Windows 的 XenServer VM Tools 之前，请务必将您的 VM 配置为从 Windows Update 接收 I/O 驱动程序。Windows Update 是接收 I/O 驱动程序更新的推荐方式。但是，如果 Windows Update 不是您的 VM 的可用选项，还可以通过管理代理接收 I/O 驱动程序的更新或手动更新驱动程序。有关详细信息，请参阅更新 I/O 驱动程序。

要安装适用于 Windows 的 XenServer VM Tools，请执行以下操作：

我们建议您在安装或更新 XenServer VM Tools 之前为您的 VM 创建快照。
从 Citrix Hypervisor 下载页面下载适用于 Windows 的 XenServer VM Tools 文件。
1. 登录您的 Citrix 帐户以访问可下载的文件。
2. 展开 Citrix Hypervisor 下载页面上的产品部分，然后单击进入任何支持的 Citrix Hypervisor 版本。
3. 在产品页面上，转到 Citrix Hypervisor Main Components（Citrix Hypervisor 主要组件）部分。
  
  适用于 Windows 的 XenServer VM Tools 有 32 位和 64 位版本。
4. 下载 MSI 文件并根据提供的 SHA256 值验证您的下载。
将文件复制到您的 Windows VM 或 Windows VM 可以访问的共享驱动器。
运行 managementagentxXX.msi 文件开始安装 XenServer VM Tools。
```
Msiexec.exe /package managementagentxXX.msi
```
按照安装程序中的提示进行操作。
- 按照向导中的说明接受许可协议并选择目标文件夹。
- 自定义 Installation and Updates Settings（安装和更新设置）页面上的设置。Citrix Hypervisor Windows Management Agent Setup（Citrix Hypervisor Windows Management Agent 安装程序）向导将显示建议的设置。默认情况下，向导将显示以下设置：
  - 立即安装 I/O 驱动程序
  - 允许管理代理自动更新
  - 不允许管理代理自动更新 I/O 驱动程序
  - 向 Citrix 发送匿名使用信息
  如果不允许管理代理自动更新，请从列表中选择不允许管理代理自动更新。
  
  如果要允许管理代理自动更新 I/O 驱动程序，请选择允许管理代理自动更新 I/O 驱动程序。但是，我们建议您使用 Windows Update 来更新 I/O 驱动程序，而非使用管理代理。
  
  注意：
  
  如果已选择通过 Windows Update 机制接收 I/O 驱动程序更新，请勿允许管理代理自动更新 I/O 驱动程序。
  
  如果不希望与 Citrix 共享匿名使用信息，请取消选中向 Citrix 发送匿名使用信息复选框。传输到 Citrix 的信息包含请求更新的 VM 的 UUID。不收集与该 VM 有关的任何其他信息，也不会将这些信息传输到 Citrix。
- 单击下一步，然后单击安装开始执行适用于 Windows 的 XenServer VM Tools 安装过程。
系统提示完成安装过程时，重新启动 VM。

注意：

适用于 Windows 的 XenServer VM Tools 可以在安装过程中已重新启动 VM 后指定了 /quiet /norestart 或 /quiet /forcerestart 的情况下请求重新启动。

I/O 驱动程序将自动安装在可从 Windows Update 接收更新的 Windows VM 上。但是，我们建议您通过安装适用于 Windows 的 XenServer VM Tools 来安装管理代理，并确保配置始终受支持。

通过 RDP 安装适用于 Windows 的 XenServer VM Tools 或管理代理的客户可能看不到重新启动提示，因为该提示仅在 Windows 控制台会话中出现。为确保重新启动 VM（如有必要）以及使 VM 进入优化状态，请在 RDP 中指定强制重新启动选项。仅当需要使 VM 进入优化状态时，强制重新启动选项才会重新启动 VM。

无提示安装

要无提示安装适用于 Windows 的 XenServer VM Tools 并阻止系统重新启动，请运行以下命令之一：

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

或

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

可以通过运行以下命令获取非交互式带提示安装：

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

或

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

要自定义安装设置，请将以下参数与无提示安装命令一起使用：

参数	允许的值	默认	说明
ALLOWAUTOUPDATE	是或否	是	允许管理代理自动更新
ALLOWDRIVERINSTALL	是或否	是	立即安装 I/O 驱动程序
ALLOWDRIVERUPDATE	是或否	否	允许管理代理自动更新以安装更新后的驱动程序
IDENTIFYAUTOUPDATE	是或否	是	向 Citrix 发送匿名使用信息

例如，要无提示安装不允许执行将来的自动管理代理更新并且不向 Citrix 发送匿名信息的工具，请运行以下命令之一：

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

对于交互安装、静默安装和被动安装，在系统下一次重新启动后，可能要自动重新启动几次，才会完整安装适用于 Windows 的 XenServer VM Tools。对于指定了 /norestart 标志的安装，也会发生此行为。但是，对于提供了 /norestart 标志的安装，首次重新启动可能要手动完成。

默认情况下，适用于 Windows 的 XenServer VM Tools 安装在 VM 上的 C:\Program Files\Citrix\XenTools 目录中。

备注：

要在 Windows VM 上安装适用于 Windows 的 XenServer VM Tools，该 VM 必须运行 Microsoft .NET Framework 4.0 或更高版本。

/quiet 参数仅适用于安装对话框，但不适用于设备驱动程序安装。指定了 /quiet 参数时，设备驱动程序安装会要求允许重新启动（如果需要）。

指定了 /quiet /norestart 时，在安装了完整的工具后，系统不会重新启动。此行为与用户在重新启动对话框中指定的内容无关。

指定了 /quiet /forcerestart 时，在安装了完整的工具后，系统会重新启动。此行为与用户在重新启动对话框中指定的内容无关。

设备驱动程序安装要求允许重新启动时，指定了 quiet 参数的工具安装可能仍在进行。请使用任务管理器确认安装程序是否仍在运行。

警告：

安装或升级适用于 Windows 的 XenServer VM Tools 会导致某些网络适配器的友好名称和标识符发生变化。安装或升级适用于 Windows 的 XenServer VM Tools 后，可能必须重新配置已配置为使用特定适配器的任何软件。

更新适用于 Windows 的 XenServer VM Tools

Citrix Hypervisor 具有一种更为简单的机制，可以自动为 Windows VM 更新 I/O 驱动程序（PV 驱动程序）和管理代理。此机制使客户能够在更新可用时安装更新。

请务必同时在您的 VM 中以及在用于创建 VM 的任何模板中将适用于 Windows 的 XenServer VM Tools 定期更新到最新版本。

我们建议您在安装或更新 XenServer VM Tools 之前为您的 VM 创建快照。

重要：

如果您当前使用的是 8.2.x.x 或更早版本的驱动程序，并希望使用管理代理 MSI 文件更新到最新版本的驱动程序，则必须先使用设备管理器从您的 VM 中卸载 8.2.x.x 驱动程序，然后再安装这些驱动程序。如果未完成此步骤，MSI 安装过程将失败。

我们建议使用以下设置来更新适用于 Windows 的 XenServer VM Tools 的不同组件：

将以下注册表项的值设置为 REG_DWORD 值 3：HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot
确保将 VM 配置为从 Windows Update 接收 I/O 驱动程序。
将管理代理配置为自动自助更新。

在 XenCenter 中，VM 的常规选项卡中的虚拟化状态部分指定 VM 是否可以从 Windows Update 接收更新。默认情况下，从 Windows Update 接收 I/O 驱动程序更新的机制处于开启状态。如果不想从 Windows Update 接收 I/O 驱动程序更新，应在 VM 上禁用 Windows Update，或指定一个组策略。

重要：

确保请求的所有 VM 重新启动操作都作为更新的一部分完成。可能需要多次重新启动。如果所有请求的重新启动操作都未完成，这可能会导致出现意外行为。

以下各部分内容介绍了与自动更新 I/O 驱动程序和管理代理有关的信息。

更新 I/O 驱动程序

您可以从 Microsoft Windows Update 自动获取 I/O 驱动程序更新，但前提是：

您运行的是 Citrix Hypervisor 8.2 Premium Edition，或者可以通过 Citrix Virtual Apps and Desktops 授权或 Citrix DaaS 授权访问 Citrix Hypervisor。
您已使用随 Citrix Hypervisor 8.2 发布的 XenCenter 创建 Windows VM
VM 中已启用 Windows Update
VM 具有 Internet 访问权限，或者可以连接到 WSUS 代理服务器

注意：

Windows Server Core 不支持使用 Windows Update 安装或更新 I/O 驱动程序。请改为使用可从 Citrix Hypervisor 下载页面获取的适用于 Windows 的 XenServer VM Tools 安装程序。XenServer VM Tools 可在所有支持的 Citrix Hypervisor 版本下作为可下载的组件提供。您必须登录 Citrix 帐户才能访问这些下载内容。

客户还可以通过管理代理自动更新机制自动接收 I/O 驱动程序更新。可以在适用于 Windows 的 XenServer VM Tools 安装期间配置此设置。有关详细信息，请参阅安装适用于 Windows 的 XenServer VM Tools。

自动重新启动

确保请求的所有 VM 重新启动操作都作为更新的一部分完成。可能需要多次重新启动。如果所有请求的重新启动都未完成，则可能会看到意外行为。

可以设置注册表项，用于指定通过设备管理器或 Windows Update 安装驱动程序时执行的最大自动重新启动次数。安装了 xenbus 驱动程序版本 9.1.1.8 或更高版本后，适用于 Windows 的 XenServer VM Tools 将使用此注册表项提供的指导。

要使用此功能，我们建议您尽快设置以下注册表项：HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。注册表项的值必须为正整数。我们建议您将注册表项中的重新启动次数设置为 3。

设置此注册表项后，适用于 Windows 的 XenServer VM Tools 将根据需要执行任意次数的重新启动以完成更新或注册表项指定的重新启动次数（以较低值为准）。

在每次重新启动之前，Windows 都可以在 60 秒内显示警报，警告即将重新启动。可以消除该警报，但此操作不会取消重新启动。由于重新启动之间存在延迟，因此，请在初次重新启动后等待几分钟，以便重新启动周期完成。

备注：

对于具有静态 IP 地址的无头服务器，此设置是必需的。

此自动重新启动功能仅适用于通过设备管理器或 Windows Update 对 Windows I/O 驱动程序进行的更新。如果使用管理代理安装程序部署驱动程序，安装程序将忽略此注册表项，并根据自己的设置管理 VM 重新启动。

查明 I/O 驱动程序的版本

要查明 VM 上安装的 I/O 驱动程序的版本，请执行以下操作：

导航到 C:\Windows\System32\drivers。
从列表中找到该驱动程序。
右键单击该驱动程序并选择属性，然后选择详细信息。

文件版本字段将显示 VM 上安装的驱动程序版本。

更新管理代理

使用 Citrix Hypervisor 可以在新的和现有的 Windows VM 上自动更新管理代理。默认情况下，Citrix Hypervisor 允许管理代理自动更新。但是，不允许管理代理自动更新 I/O 驱动程序。您可以在适用于 Windows 的 XenServer VM Tools 安装过程中自定义管理代理更新设置。管理代理自动更新会无缝地进行，而不会重新启动 VM。如果需要重新启动 VM，VM 的“控制台”选项卡上将显示一条消息，向用户通知需要执行的操作。

您可以自动获取管理代理更新，但前提是：

您运行的是 Citrix Hypervisor 8.2 Premium Edition，或者可以通过 Citrix Virtual Apps and Desktops 授权或 Citrix DaaS 授权访问 Citrix Hypervisor。
您安装了随 Citrix Hypervisor 7.0 或更高版本发行的适用于 Windows 的 XenServer VM Tools
Windows VM 具有 Internet 访问权限

查明管理代理的版本

要查明 VM 上安装的管理代理的版本，请执行以下操作：

导航到 C:\Program Files\Citrix\XenTools。
右键单击列表中的 XenGuestAgent，然后依次单击属性和详细信息。

文件版本字段将显示 VM 上安装的管理代理版本。

使用 CLI 管理自动更新

Citrix Hypervisor 允许您使用命令行管理 I/O 驱动程序和管理代理的自动更新。您可以在运行 msiexec.exe 时使用下表中列出的参数来指定是否自动更新 I/O 驱动程序和管理代理。有关使用 msiexec.exe 安装适用于 Windows 的 XenServer VM Tools 的信息，请参阅无提示安装。

注意：

对于使用 PVS 或 MCS 管理的 VM，当 Citrix Virtual Desktops VDA 存在并报告计算机是非静态计算机时，会自动关闭自动更新。

参数	值	说明
ALLOWAUTOUPDATE	YES/NO	允许/不允许管理代理自动更新
ALLOWDRIVERINSTALL	YES/NO	允许/不允许适用于 Windows 的 XenServer VM Tools 安装程序安装 I/O 驱动程序
ALLOWDRIVERUPDATE	YES/NO	允许/不允许管理代理自动更新 I/O 驱动程序
IDENTIFYAUTOUPDATE	YES/NO	允许/不允许自动更新机制向 Citrix 发送匿名使用信息

例如：

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

或

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

重定向管理代理更新

客户可以通过 Citrix Hypervisor 在安装管理代理更新之前将其重定向到内部 Web 服务器。此重定向功能让客户可以在 VM 上自动安装更新之前对其进行检查。

要重定向管理代理更新，请执行以下操作：

管理代理使用更新文件获取有关可用更新的信息。此更新文件的名称取决于您使用的管理代理的版本：

对于管理代理 9.2.1.35 及更高版本，请使用 https://pvupdates.vmd.citrix.com/autoupdate.v1.json。
适用于管理代理 9.0.0.0 到 9.2.0.27 https://pvupdates.vmd.citrix.com/updates.v9.json。

请完成以下步骤以重定向管理代理更新：

下载更新文件。
下载在更新文件中引用的管理代理 MSI 文件。
将 MSI 文件上载到您的 VM 可以访问的内部 Web 服务器。
更新更新文件，使其指向内部 Web 服务器上的 MSI 文件。
将更新文件上载到 Web 服务器。

也可以按每个 VM 或按每个池重定向自动更新。要按每个 VM 重定向更新，请执行以下操作：

在 VM 上，以管理员身份打开一个命令提示窗口。

运行命令

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

要按每个池重定向管理代理自动更新，请运行以下命令：

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

禁用管理代理更新

要在每 VM 的基础上禁用管理代理自动更新，请执行以下操作：

在 VM 上，以管理员身份打开一个命令提示窗口。

运行以下命令：

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

要按每个池禁用管理代理自动更新，请运行以下命令：

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

修改 I/O 驱动程序自动更新设置

在适用于 Windows 的 XenServer VM Tools 安装过程中，可以指定是否允许管理代理自动更新 I/O 驱动程序。如果倾向于在完成适用于 Windows 的 XenServer VM Tools 安装过程后更新此设置，请执行以下步骤：

在 VM 上，以管理员身份打开一个命令提示窗口。

运行以下命令：

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

要向 Citrix 发送匿名使用信息，请执行以下操作：

在适用于 Windows 的 XenServer VM Tools 安装过程中，可以指定是否要向 Citrix 发送匿名使用信息。如果要在完成适用于 Windows 的 XenServer VM Tools 安装过程后更新此设置，请执行以下步骤：

在 VM 上，以管理员身份打开一个命令提示窗口。

运行以下命令：

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

对适用于 Windows 的 XenServer VM Tools 进行故障排除

我们提供了工具 xtbugtool，用于捕获 XenServer VM Tools 的诊断信息。有关详细信息，请参阅 VM 问题故障排除。

卸载适用于 Windows 的 XenServer VM Tools

我们不建议从您的 Windows VM 中删除 XenServer VM Tools。这些工具是完全支持您的 Windows VM 所必需的。删除这些工具可能会导致出现意外行为。手动卸载 XenServer VM Tools 只能作为最后的手段。

标准卸载

要对 XenServer VM Tools 执行标准卸载，可以使用 Windows 的添加或删除程序功能：

请在开始之前创建 VM 的快照。
在 Windows VM 中，转到添加或删除程序。
选择 Citrix Hypervisor PV Tools，然后单击卸载。
重新启动 VM。

`uninstall.exe` 命令

使用 Windows 的添加或删除程序功能卸载 XenServer VM Tools 会调用 <tools-install-directory>\uninstall.exe 文件来执行卸载操作。您可以改为选择从 PowerShell 终端或具有管理员权限的命令提示符调用此命令。

请在开始之前创建 VM 的快照。
以管理员身份打开命令提示符或 PowerShell 终端。
运行命令 <tools-install-directory>\uninstall.exe。
重新启动 VM。

命令选项

uninstall.exe 命令接受以下参数：

help - 显示此命令的用法信息。
log - 生成一个日志文件，指示命令完成的操作。
verbose - 将命令完成的操作输出到控制台。
disable - 禁用安装程序 MSI 安装的驱动程序。
force-disable - 在所有情况下都禁用这些驱动程序。
hidden - 删除隐藏的设备。这些设备未使用，并且已被取代，但可能留下了陈旧的注册表项。
cleanup - 从添加或删除程序中删除旧的卸载程序。这些卸载程序可能包含来自旧版本工具的重复条目。
purge -（9.3.1 及更高版本）将 VM 重置为干净状态，就像安装 XenServer VM Tools 的任何部分之前一样。有关详细信息，请参阅完全卸载所有 XenServer VM Tools 组件。
install - （9.3.1 及更高版本）安装当前的 I/O 驱动程序集，并在需要时提示重新启动 VM。
reboot- 在所有其他命令操作完成后重新启动 VM。

完全卸载所有 XenServer VM Tools 组件

适用于 Windows 的 XenServer VM Tools（9.3.1 及更高版本）的最新版本包含命令 uninstall.exe purge。uninstall.exe 应用程序上的 purge 选项将 VM 重置为安装任何 I/O 驱动程序之前的状态。如果您在将工具升级到较新版本时遇到问题，或者需要干净状态才能在您的 VM 上安装一组更新的工具，请使用此实用程序。

请在开始之前创建 VM 的快照。
以管理员身份打开命令提示符或 PowerShell 终端。
运行 <tools-install-directory>\uninstall.exe purge verbose 命令
重新启动 VM。

使用此命令后，您无需像在早期版本的 XenServer VM Tools 中那样执行任何手动清理步骤。与 XenServer VM Tools 相关的所有更改均已删除。

`purge` 选项删除了什么对象?

如果使用命令 uninstall.exe purge，则会从 Windows VM 中删除 XenServer VM Tools 的所有痕迹。此命令执行的操作列表如下：

服务：
- 禁用所有 XenServer VM Tools 服务，这会阻止已安装的驱动程序和服务在重新启动时启动。
- 停止任何正在运行的 XenServer VM Tools 服务。
驱动程序：
- 从所有设备节点中卸载 I/O 驱动程序。
- 卸载隐藏的设备。此操作与执行 hidden 命令行选项的操作相同。
- 卸载缓存的驱动程序软件包，这会将其从驱动程序存储库中删除。因此，不会自动重新安装 I/O 驱动程序。
注册表：
- 删除驱动程序不再支持的版本所使用的过时的注册表信息。
- 从 HKLM\System\CurrentControlSet\Control\Class\... 中删除与工具相关的密钥
- 从 HKLM\System\CurrentControlSet\Services 中删除与工具相关的密钥。
- 从 HKLM\System\CurrentControlSet\Enum\... 中删除与工具相关的密钥
文件：
- 从 C:\Windows\System32 和 C:\Windows\System32\drivers 中删除所有 XenServer VM Tools 驱动程序文件。
- 从 C:\Windows\INF 中删除所有 XenServer VM Tools INF 文件。
- 从 C:\Program Files\Citrix\XenTools 中删除这些工具不再支持的版本留下的任何过时的文件。
其他：
- 删除添加或删除程序中的旧条目。此操作与执行 cleanup 命令行选项的操作相同。
- 清除 InstallAgent 的一些过时的状态信息。
- 从高层过滤器中移除 xenfilt.sys。此更改可防止 xenfilt.sys 在任何驱动程序节点上加载。
- 删除 unplug 密钥，这会导致 VM 在重新启动时还原到模拟设备。
- 删除 StorNvme 的 StartOverride。此更改强制 stornvme.sys 在引导时启动，并允许模拟 NVMe (UEFI) 引导设备运行。

新增功能

适用于 Windows 的 XenServer VM Tools 版本的更新与 Citrix Hypervisor 的版本无关。请务必同时在您的 VM 中以及在用于创建 VM 的任何模板中将适用于 Windows 的 XenServer VM Tools 定期更新到最新版本。