XenServer

适用于 Windows 的 XenServer VM Tools

September 19, 2024

投稿者:

X X

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

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

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

安装 XenServer VM Tools

注意：

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

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

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

我们建议您在安装或更新 XenServer VM Tools 之前为您的 VM 创建快照。
从 XenServer 下载页面下载适用于 Windows 的 XenServer VM Tools 文件。
根据提供的 SHA256 值验证您的下载。
将文件复制到您的 Windows VM 或 Windows VM 可以访问的共享驱动器。
运行 managementagentx64.msi 文件开始安装 XenServer VM Tools。
```
Msiexec.exe /package managementagentx64.msi
```
按照安装程序中的提示进行操作。
- 按照向导中的说明接受许可协议并选择目标文件夹。
- 自定义 Installation and Updates Settings（安装和更新设置）页面上的设置。
  
  默认情况下，向导将显示以下建议的设置：
  - 立即安装 I/O 驱动程序
    - 如果 VM 已设置 has-vendor-device=true，则取消选择此选项，因为 Windows Update 已安装 I/O 驱动程序。
    - 如果 VM 已设置 has-vendor-device=false，则选择此选项。
  - 允许管理代理自动更新
  - 不允许管理代理自动更新 I/O 驱动程序
  - 向 Cloud Software Group, Inc. 发送匿名使用信息
  对于某些用例，建议使用不同的更新设置。有关详细信息，请参阅更新 XenServer VM Tools。
  
  要配置更新设置，可以进行以下更改：
  - 如果不允许管理代理自动更新，请从列表中选择不允许管理代理自动更新。
  - 如果要允许管理代理自动更新 I/O 驱动程序，请选择允许管理代理自动更新 I/O 驱动程序。但是，我们建议您使用 Windows Update 来更新 I/O 驱动程序，而非使用管理代理。如果已选择通过 Windows Update 机制接收 I/O 驱动程序更新，请勿允许管理代理自动更新 I/O 驱动程序。
  - 如果您不希望与我们共享匿名使用信息，请取消选中 向 Cloud Software Group, Inc. 发送匿名使用信息复选框复选框。传输到 Cloud Software Group 的信息包含请求更新的 VM 的 UUID 的前四个字符。不收集或传输与该 VM 有关的任何其他信息。
- 单击下一步，然后单击安装开始执行适用于 Windows 的 XenServer VM Tools 安装过程。
系统提示完成安装过程时，重新启动 VM。

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

警告：

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

无提示安装

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

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

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

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

备注：

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

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

指定 /quiet /forcerestart 后，升级或安装过程可能会触发多次重新启动。此行为与用户在重新启动对话框中指定的内容无关。

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

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

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

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

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

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

更新 XenServer VM Tools

请务必同时在您的 VM 中以及在用于创建 VM 的任何模板中将适用于 Windows 的 XenServer VM Tools 定期更新到最新版本。我们建议您在更新 XenServer VM Tools 之前为您的 VM 创建快照。有关最新版本的工具的详细信息，请参阅新增功能。

重要：

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

XenServer 为其每个组件提供自动更新机制：

管理代理可以自动自行更新
I/O 驱动程序可以通过管理代理或 Windows Update 进行更新。

或者，您可以手动更新其中一个或两个组件。

为工具的每个组件选择的更新方法可能取决于您的环境。

Citrix Provisioning 目标或 reset-on-boot 计算机的设置

如果您打算将 Windows VM 用作 Citrix Provisioning 目标或者设置了 reset-on-boot 标志，则不能使用任何自动更新机制。我们建议您在用于创建这些 VM 的主模板上设置以下配置：

在创建 VM 期间，请确保将 has-vendor-device 标志设置为 false。

有关详细信息，请参阅使用 CLI 创建 Windows VM。
禁用管理代理更新。

在安装过程中：

请在首次安装 XenServer VM Tools 时指定以下配置：

未选择自动更新设置的 XenServer VM Tools 安装程序

仅限管理代理自动更新的设置

可以将管理代理配置为同时更新自身和 I/O 驱动程序。如果您使用此配置，请确保防止 VM 通过 Windows Update 更新 I/O 驱动程序。如果两种机制都尝试更新 I/O 驱动程序，则可能导致不必要的更新。

如果贵组织要求您在将任何更新应用到您的 Windows VM 之前对其进行检查，请选择此方法。如果是这种情况，您还必须重定向管理代理以从内部服务器获取其更新。

禁止通过 Windows Update 更新 I/O 驱动程序。
将管理代理设置为更新 I/O 驱动程序。
（可选）重定向管理代理更新。

在安装过程中：

请在首次安装 XenServer VM Tools 时指定以下配置：

未选择自动更新设置的 XenServer VM Tools 安装程序

更新管理代理

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

您可以自动获取管理代理更新，但前提是 Windows VM 有权访问 Internet。

使用 CLI 管理自动更新

XenServer 允许您使用命令行管理 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	允许/不允许自动更新机制向我们发送匿名使用信息

启用管理代理更新

要在每个 VM 的基础上启用管理代理的自动更新，请运行以下命令：

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

运行以下命令：

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

请确保您的池允许管理代理更新。在主机控制台中，运行以下命令：

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

禁用管理代理更新

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

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

运行以下命令：

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

要在每个池的基础上禁用管理代理的自动更新，请在主机控制台中运行以下命令：

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

重定向管理代理更新

客户可以通过 XenServer 在安装管理代理更新之前将其重定向到内部 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\XenServer\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-->

更新 I/O 驱动程序

可以通过 Windows Update 或使用管理代理更新 I/O 驱动程序。还可以关闭自动更新并手动管理 I/O 驱动程序的更新。

每个 I/O 驱动程序（xennet、xenvif、xenvbd、xeniface 和 xenbus）都有自己的版本。有关最新版本的信息，请参阅新增功能。

将 I/O 驱动程序设置为通过 Windows Update 进行更新

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

VM 中已启用 Windows Update
VM 具有 Internet 访问权限，或者可以连接到 WSUS 代理服务器
您运行的不是核心版本的 Windows Server。Windows Server Core 不支持使用 Windows Update 安装或更新 I/O 驱动程序。

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

禁止通过 Windows Update 更新 I/O 驱动程序

在 XenCenter 中，VM 的常规选项卡中的虚拟化状态部分指定 VM 是否可以从 Windows Update 接收更新。默认情况下，从 Windows Update 接收 I/O 驱动程序更新的机制处于开启状态。

对于已经存在的 Windows VM，如果您不想从 Windows Update 接收 I/O 驱动程序更新，请指定组策略。

对于新 Windows VM，您可以在创建 VM 期间在 VM 中设置一个标志，以防止 Windows Update 更新 I/O 驱动程序。有关详细信息，请参阅 Citrix Provisioning 目标或 reset-on-boot 计算机的设置和使用 CLI 创建 Windows VM。

将管理代理设置为更新 I/O 驱动程序

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

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

运行以下命令：

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

停止管理代理更新 I/O 驱动程序

要阻止管理代理更新 I/O 驱动程序，请执行以下步骤：

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

运行以下命令：

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

自动重新启动

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

可以设置注册表项，用于指定通过设备管理器或 Windows Update 安装驱动程序时执行的最大自动重新启动次数。安装了 xenbus 驱动程序版本 9.1.1.8 或更高版本后，适用于 Windows 的 XenServer VM Tools 将使用此注册表项提供的指导。如果您使用的是早期版本的 xenbus，则可能仍会遇到意外行为。如果出现这种情况，请从 XenCenter 重新启动 VM。

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

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

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

备注：

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

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

如果在等待所有重新启动操作完成后，您仍然遇到意外行为，请从 XenCenter 启动 VM 的重新启动操作以尝试还原配置。

使用命令行设置自动重新启动

在您的 Windows VM 上，以管理员身份打开命令提示符并运行以下命令：

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

或者，如果您的 Windows VM 配置为允许远程访问，则可以在其他系统中的管理员命令提示符下运行以下命令：

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

有关详细信息，请参阅 reg add Windows command（reg add Windows 命令）。

使用注册表编辑器设置自动重新启动

在 Windows 的“开始”菜单中，打开注册表编辑器并导航到注册表项 HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters。
创建名为 Autoreboot 的类型 REG_DWORD 的新子注册表项。
将 Autoreboot 的值设置为整数，例如 3。

其他配置和查询

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

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

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

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

查明管理代理的版本

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

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

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

配置匿名使用信息

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

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

运行以下命令：

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

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

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

卸载 XenServer VM Tools

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

标准卸载

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

请在开始之前创建 VM 的快照。
在 Windows VM 中，转到添加或删除程序。
选择 XenServer VM 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 和 C:\Program Files\XenServer\XenTools 中删除这些工具不再支持的版本留下的任何过时的文件。
其他：
- 删除添加或删除程序中的旧条目。此操作与执行 cleanup 命令行选项的操作相同。
- 清除 InstallAgent 的一些过时的状态信息。
- 从高层过滤器中移除 xenfilt.sys。此更改可防止 xenfilt.sys 在任何驱动程序节点上加载。
- 删除 unplug 密钥，这会导致 VM 在重新启动时还原到模拟设备。
- 删除 StorNvme 的 StartOverride。此更改强制 stornvme.sys 在引导时启动，并允许模拟 NVMe (UEFI) 引导设备运行。

新增功能

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

适用于 Windows 的 XenServer VM Tools 的最新版本可从 XenServer 下载页面获取。

适用于 Windows 的 XenServer VM Tools 9.3.3

发布日期：2024 年 6 月 4 日

这组工具包含以下组件版本：

安装程序：9.3.3
管理代理：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

9.3.3 中已修复的问题

此版本中包含针对以下问题的修复：

有时，当 VM 负载过重时，管理代理可能会因 ManagementException 而崩溃。
在 Windows 2022 服务器上，单个 vCPU 可以消耗 100% 的 CPU。因此，服务器将变得无响应。
使用 OpenVSwitch 网络连接和带有 VLAN 标记的以太网帧的池中托管的 Windows VM 的网络连接可能不一致。

早期版本

9.3.2

发布时间：2023 年 11 月 27 日

此版本将 Citrix VM Tools 重命名为 XenServer VM Tools。

这组工具包含以下组件版本：

安装程序：9.3.2
管理代理：9.2.2.435
xenbus：9.1.7.80
xeniface：9.1.8.69
xennet：9.1.5.51
xenvbd：9.1.6.58
xenvif：9.1.10.83

此版本还包含以下改进功能：

改进了 uninstall.exe 命令。
进行了更改，使某些 Windows VM 能够使用多达 64 个 vCPU，而您的 XenServer 版本和 Windows 操作系统都支持此功能。

此版本中包含针对以下问题的修复：

有时，在安装 XenServer VM Tools 时，非致命错误可能会导致安装失败。

9.3.1

发布时间：2023 年 1 月 25 日

这组工具包含以下组件版本：

安装程序：9.3.1
管理代理：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

此版本包括以下改进功能：

改进了 uninstall.exe 实用程序，包括 purge 参数。有关详细信息，请参阅卸载 XenServer VM Tools。
对 XenServer VM Tools 安装程序进行了常规改进。
对注册表项的字符串处理功能进行了常规改进。

此版本包含对以下问题的修复：

有时，当通过 Windows Update 更新 XenServer VM Tools 时，静态 IP 设置会丢失，网络设置会更改为使用 DHCP。
在 Windows VM 上，授权表很容易耗尽。发生这种情况时，读取和写入请求可能会失败，或者其他 VIF 无法正确启用并且无法启动。
在极少数情况下，在升级适用于 Windows 的 XenServer VM Tools 时，现有管理代理可能无法关闭并阻止升级成功。
在 Windows VM 上，您可能会看到已安装的程序中列出的工具或管理代理的早期版本和更高版本。
- （早期版本）Citrix XenServer Windows Management Agent
- （更高版本）Citrix Hypervisor PV Tools。
更新到最新版本的工具后，这两个较早的名称均不列出。您的“已安装的程序”中仅列出 XenServer VM Tools。

9.3.0

发布时间：2022 年 7 月 26 日

这组工具包含以下组件版本：

安装程序：9.3.0
管理代理：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

此版本包括以下改进功能：

对 XenServer VM Tools 安装程序进行了常规改进。

此版本包含对以下问题的修复：

作为一项防止数据泄露的措施，安全性软件正在阻止标记为可移除的辅助磁盘向操作系统公开。应用此更新后，您可以将 VBD 标记为不可移除，并通过操作系统将其正确公开。
在 Windows VM 上，SR-IOV VIF 的 IP 地址有时在 XenCenter 中不可见。

9.2.3

发布时间：2022 年 4 月 28 日

这组工具包含以下组件版本：

安装程序：9.2.3
管理代理：9.1.1.13
xenbus：9.1.3.30
xeniface：9.1.4.34
xennet：
- 9.1.1.8（适用于 Windows Server 2012 和 Windows Server 2012 R2）
- 9.1.2.23（适用于其他支持的所有 Windows 操作系统）
xenvbd：9.1.2.20
xenvif：9.1.5.48

此版本包含对以下问题的修复：

在适用于 Windows 的 XenServer VM Tools 版本 9.2.2 中，时间同步选项不可用。
在 Citrix Hypervisor 8.2 累积更新 1 上进行实时迁移后，争用条件可能会导致 Windows VM 显示蓝屏错误。
安装了 XenServer VM Tools 版本 9.2.1 或 9.2.2 且作为 PVS 目标的 Windows VM 有时可能会冻结并显示黑屏。dom0 内核日志中出现“Guest Rx stalled”（Guest Rx 已停止）消息。与其他池成员相比，此问题更常发生在池协调器上。
在配备了 8 个以上的 vCPU 的 Windows VM 上，接收方缩放功能可能不起作用，因为 xenvif 驱动程序无法设置间接表。

9.2.2

发布时间：2022 年 1 月 14 日

这组工具包含以下组件版本：

安装程序：9.2.2
管理代理：9.1.1.13
xenbus：9.1.3.30
xeniface：9.1.2.22
xennet：
- 9.1.1.8（适用于 Windows Server 2012 和 Windows Server 2012 R2）
- 9.1.2.23（适用于其他支持的所有 Windows 操作系统）
xenvbd：9.1.2.20
xenvif：9.1.3.31

此版本包含对以下问题的修复：

在更新工具期间，xenbus 驱动程序可以在驱动程序安装完成之前提示重新启动。接受重新启动可能会导致 Windows VM 中出现蓝屏错误。
压缩收集的诊断信息时，xt-bugtool 诊断工具在 20 秒后超时。此行为可能会导致诊断 zip 文件无法正确创建。
VNC 剪贴板共享不起作用。
驱动程序的早期版本不是通过 Windows Update 发布的。

9.2.1

发布时间：2021 年 6 月 24 日

这组工具包含以下组件版本：

安装程序：9.2.1
管理代理：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

注意：

这组驱动程序不是通过 Windows Update 提供的。

此版本包含对以下问题的修复：

在某些情况下，无法更改 VM 的便携式计算机/平板电脑状态。
VM 重新启动后，有时可能会开始向 daemon.log 文件发送过多的日志消息。
操作系统升级后驱动程序负载依赖关系中的争用条件可能会阻止 XenServer VM Tools 升级。
存储错误可能导致 Windows VM 崩溃。
SR-IOV VIF 的 IP 地址有时在 XenCenter 中不可见。要解决此问题，请从 VM 的服务管理器中重新启动管理代理。
在网络和系统负载过高以及资源不足的情况下，VM 可能会在 Citrix 和第三方驱动程序中遇到缺陷检查问题，代码通常为 IRQL_NOT_LESS_OR_EQUAL。此修复改进了网络缓冲功能以防止这些缺陷检查。
升级 Windows I/O 驱动程序可能会导致 UEFI VM 无法启动，报告“0xC000000E. A required device isn’t connected or can’t be accessed.”（0xC000000E。所需设备未连接或无法访问。）
卸载 XenServer VM Tools 的早期版本后安装 XenServer VM Tools 时可能会出现问题，并返回以下错误消息：“This Device cannot start (code 10) (Operation failed) The requested operation was unsuccessful”（此设备无法启动(代码 10) (操作失败) 请求的操作不成功）。

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

适用于 Windows 的 XenServer VM Tools

September 19, 2024

投稿者:

X X

September 19, 2024

投稿者:

X X

这是否有帮助？

适用于 Windows 的 XenServer VM Tools

安装 XenServer VM Tools

无提示安装

更新 XenServer VM Tools

推荐的更新设置

Citrix Provisioning 目标或 reset-on-boot 计算机的设置

仅限管理代理自动更新的设置

更新管理代理

使用 CLI 管理自动更新

启用管理代理更新

禁用管理代理更新

重定向管理代理更新

更新 I/O 驱动程序

将 I/O 驱动程序设置为通过 Windows Update 进行更新

禁止通过 Windows Update 更新 I/O 驱动程序

将管理代理设置为更新 I/O 驱动程序

停止管理代理更新 I/O 驱动程序

自动重新启动

使用命令行设置自动重新启动

使用注册表编辑器设置自动重新启动

其他配置和查询

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

查明管理代理的版本

配置匿名使用信息

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

卸载 XenServer VM Tools

标准卸载

uninstall.exe 命令

命令选项

完全卸载所有 XenServer VM Tools 组件

purge 选项删除了什么对象？

新增功能

适用于 Windows 的 XenServer VM Tools 9.3.3

9.3.3 中已修复的问题

早期版本

9.3.2

9.3.1

9.3.0

9.2.3

9.2.2

9.2.1

在本文中

`uninstall.exe` 命令

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