XCP-ng Windows PV tools announcements

manilx

@dinhngtu Is it impossible to report the correct Windows version? Seems to be the "correct" solution....

dinhngtu

Sorry for the confusion, I was posting the output from my Windows 11 computer...

On Server 2022 for example, it will report "Windows Server 2022 Datacenter 64-bit" instead. So the OS name should be correct wrt. client/server editions, i.e. it will not report as Windows 11 on Server 2025.

Chemikant784

@dinhngtu From my point of view this would be fine So the systems can be distinguished even when the buildnumber is the same.

spelon

Got a weird bug on these.

Used xenclean to remove Citrix 9.4.1 drivers, installed the 9.0.9137-2 . Now if I live migrate a VDI, the agent gives up on that VM. Drivers are all working, just the agent needs reinstalling. Only got one pool to test it on, but its the same on all four hosts.

Three VMS I migrated disks on;

From Management Agent Detected before VDI migrated to agent missing after migration completion;

All three are Server 2019 VMs.

Any similar known issues?

dinhngtu

@spelon Yes, it's known. I'll try to fix that in the next release.

manilx

@dinhngtu Hopefully before the next updates to xcpng. Rolling pool update moves all VM's....

Does this bug clear itself after a VM reboot? Or has the tools to be reinstalled? Is it only cosmetic or does it affect the running VM?

Havne't tried this myself and as we have moved all VM's to these new tools I'd like to be aware of what I can expect.

dinhngtu

@manilx It's purely cosmetic and will clear on reboot.

manilx

@dinhngtu

archw

Whats the difference between this one and the the one created by "managementagentx64-9.4.2.msi" downloaded from "http://downloadns.citrix.com.edgesuite.net/17528/managementagent-9.4.2-x64.msi" or https://www.xenserver.com/downloads#lightbox-20160?

As of right now, using "managementagentx64-9.4.2.msi" I get "Management agent 9.4.2-178 detected" with the latest Citrix/xenserver.com drivers.

Is it better to start using this signed build of the XCP-ng Windows PV drivers?

Thanks!

Henrik

@archw xcp-ng tools are developed by Vates with many improvements over the citrix tools that align with xcp-ng.

"Dont forget to clean out the old citrix tools before installing." - https://github.com/xcp-ng/win-pv-drivers/releases

You can read more here:
https://xcp-ng.org/blog/2025/10/10/signed-windows-pv-drivers-now-available/
https://xcp-ng.org/blog/2025/07/29/windows-pv-drivers-update-and-roadmap/

archw

@Henrik
Thanks for the advice! I just did one.....lots of rebooting required.

After you run xclean, it then reboots. When it comes back, there is no mouse so, unless you can do everything from keystrokes, you have to reboot. When it comes back, you can then install the new drivers. It then reboots and now you can reset your original ip address (if it was a static IP address).

Henrik

@archw and forgot to type "Not compatible with the "Manage Citrix PV drivers via Windows Update" option. You must disable this option before installing."

dom0

In regards to statement few posts above that XCP-ng tools are developed by Vates, does that mean that Vates builds them from scratch or modifies Citrix/XenServer ones?

I am thinking about switching to "XCP-ng windows guest tools 9.0.9137'', production is currently on "XenServer VM Tools for Windows 9.4.2".

dinhngtu

@dom0 They are built from scratch using these components:

Upstream Xen Project PV driver sources, which includes contributions from Citrix, Vates, Invisible Things Lab among others, and where we are one of the maintainers;
The Rust guest agent, which is developed by us;
The installer, packaging and tooling is completely our own.

The main repo is here: https://github.com/xcp-ng/win-pv-drivers

dinhngtu

Hello all,

Version 9.1.100 Release Signed of the Windows PV tools has been released.

Download the latest release here: https://github.com/xcp-ng/win-pv-drivers/releases

It will be integrated into the XCP-ng built-in tools ISO after a test period of 2 weeks.

This release brings multiple bug fixes to all Windows drivers and guest tools components.

To download XenClean, click here. The installer downloads also includes a copy of XenClean and XenBootFix. Remember to carefully read XenClean docs before use.

Before installing

Thank you for using our Windows PV tools. Please carefully read the instructions below.

Not compatible with the "Manage Citrix PV drivers via Windows Update" option. You must disable this option before installing.
We recommend creating backups/snapshots before installing.

Changes since 9.0.9137

NEW: Add installer option to disable time sync.
NEW: SBOM is now included with the installation package.
Improved: Better cleanup of Xenbus devices.
Fixes: Driver symbols are now back after an accidental omission in 9.0.9137.
Fixes: Fix restoration of network settings after uninstallation.
Fixes: Fix XenClean in Safe Mode.
Fixes: Fix system time drifting when time sync is enabled.
Fixes: Fix display of Windows OS version.
Fixes: Fix Xen Guest Agent reporting on VM resume.
Fixes: Fix receive-side scaling.
Fixes: Various driver stability fixes.

Help / Community support

If you encounter installation/uninstallation errors, please try again with one of the following commands:

For installing:
msiexec.exe /i XenTools-x64.msi /log install.log

For uninstalling:
msiexec.exe /x XenTools-x64.msi /log uninstall.log

Please include this log along with the file C:\Windows\INF\setupapi.dev.log in your bug report. These files will help us troubleshoot any installation issues.

Additionally, please report any errors or BSOD you encounter during testing of this release. Your feedback is very appreciated.

Discussion: https://xcp-ng.org/forum (preferred)
Issue Tracker: https://github.com/xcp-ng/xcp/issues
IRC: #xcp-ng and #xcp-ng-dev on irc.freenode.net

Full Changelog: https://github.com/xcp-ng/win-pv-drivers/compare/v9.0.9137...v9.1.100

manilx

@dinhngtu Updated from previous version running on 8 Windows Server 2022 VM's across HomeLab & Office.

No issues.

dom0

@dinhngtu

Thank you for explanation!

My production servers are currently running XenServer VM Tools for Windows 9.4.2. Would you recommend switching to XCP-ng tools?

dinhngtu

@dom0 Yes, the Vates tools are our recommended guest tools for XCP-ng going forward.

probain

Would it be possible to either have direct links to the exe's without them being zipped? Or list the version number of the xen-guest-agent.exe?

I'm installing these through Ansible (see code below). And it would be way cleaner if either of those two wishes could be true.

    - name: Install Xen Guest tools on Windows hosts
      when: ansible_system == "Win32NT"
      tags: xcp_ng
      block:
        - name: Install Xen Guest Tools
          when: ansible_virtualization_type == "xen"
          block:
            - name: Copy over Latest Xen PV drivers
              ansible.windows.win_copy:
                src: "XenTools-x64_{{ xen_guest_agent_version }}.msi"
                dest: "C:\\Users\\{{ ansible_user }}\\Downloads\\XenDrivers-x64.msi"
                force: true

            - name: Install XenDrivers if the version isnt already created
              ansible.windows.win_package:
                path: "C:\\Users\\{{ ansible_user }}\\Downloads\\XenDrivers-x64.msi"
                creates_path: C:\Program Files\XCP-ng\Windows PV Drivers\XenGuestAgent\xen-guest-agent.exe
                creates_version: "{{ xen_guest_agent_version }}"
                arguments:
                  - /quiet

dinhngtu

@probain The canonical way is to check the product_id instead https://docs.ansible.com/projects/ansible/latest/collections/ansible/windows/win_package_module.html#parameter-product_id The ProductCode changes every time a new version of XCP-ng Windows PV tools is released, and you can get it from each release's MSI: