diff --git a/docs/troubleshooting/windows-pv-tools.md b/docs/troubleshooting/windows-pv-tools.md index b235ec4d..6e8fb6b5 100644 --- a/docs/troubleshooting/windows-pv-tools.md +++ b/docs/troubleshooting/windows-pv-tools.md @@ -1,16 +1,6 @@ # Windows PV Tools -Common issues with Windows PV tools. - -## Windows Management Agent failed to install - -### Cause -There was an issue with the installing of the drivers certificate, so the drivers did not load silently. - -### Solution -Resolved with version 8.2.2.200-RC1 and newer. - -*** +Common issues and topics related to Windows PV tools. ## PV-Drivers missing in the Device Manager @@ -32,8 +22,6 @@ If the tools are installed, while XCP-ng Center says that I/O is optimized, but ### Possible Solutions -* Resolved with version 8.2.2.200-RC1 and newer. - * Clean your system from `Citrix Client Tools` _AND_ `XCP-ng Client Tools` to create a clean state. * Then install the Client Tools from scratch. diff --git a/docs/vms/vms.md b/docs/vms/vms.md index 3d802c9e..016b67e9 100644 --- a/docs/vms/vms.md +++ b/docs/vms/vms.md @@ -370,9 +370,6 @@ Citrix tools: XCP-ng tools: * :heavy_plus_sign: Fully open-source. * :heavy_plus_sign: Maintained by the XCP-ng project. -* :heavy_minus_sign: The drivers are not signed with a key recognized by Microsoft, so Secure Boot can't be enabled with them. -* :heavy_minus_sign: The sources for the management agent are older than that of Citrix (they have stopped updating GitHub a while ago). -* :heavy_minus_sign: Have not been updated in a long time, due to difficulties finding skilled developers to work on them. Being actively worked on. * :heavy_minus_sign: Won't transparently replace existing Citrix tools. You need to remove Citrix tools first if they are present, in order to install XCP-ng tools. It's now up to you to choose. @@ -403,7 +400,7 @@ If you are using Xen Orchestra, you can switch the "Windows Update tools" advanc If your VM already has XCP-ng tools and you wish to switch to Citrix tools, then you need to do the same kind of clean-up as described farther in this document for the opposite situation. #### XCP-ng Windows Guest Tools -Drivers built by the XCP-ng community. +Drivers built and signed by Vates. **Download**: [https://github.com/xcp-ng/win-pv-drivers/releases](https://github.com/xcp-ng/win-pv-drivers/releases) @@ -445,24 +442,26 @@ xe vm-param-get param-name=has-vendor-device uuid={VM-UUID} `True` means that it's active, `False` that it isn't. It needs to be `False`. ###### Install the XCP-ng drivers -0. snapshot before just in case -1. unpack the ZIP file -2. start setup.exe -3. follow the install wizard +0. Snapshot your VM before installing (just in case) +1. Unpack the ZIP file +2. Start the installation MSI +3. Follow the install wizard -**Note**: Restart can take a while if your windows is currently updating. Restart only occurs after windows has the updates finished. +##### Upgrade from XCP-ng Windows PV Tools (8.2 or earlier) or XenServer VM Tools -4. after restart one of two messages should pop up - * request for restart \<- just restart! - * Management Agent installed successfully \<- enjoy :-) +Our installer will block installation when these tools are already present. These tools must be cleanly uninstalled before continuing with the installation. -##### Upgrade from Citrix :registered: XenServer :registered: client tools +:::warning +If you're using XCP-ng Windows PV Tools 8.2 or earlier, it must be uninstalled using XenClean to avoid encountering BSODs. Follow the procedure in our [Troubleshooting Guide - Windows PV Tools](../troubleshooting/windows-pv-tools.md). +::: -Our installer is not able currently to cleanly uninstall Citrix tools. Citrix tools' uninstaller itself isn't either: it leaves various things behind. +:::warning +In any case, first disable "Windows Update tools" for the VM (Xen Orchestra, advanced tab) and reboot it. +::: #### Contributing ##### Linux / xBSD If you would like to contribute improvements to the `install.sh` script so that it supports your distro, create a pull request against: https://github.com/xcp-ng/xe-guest-utilities/tree/master/mk. Relevant files are usually `xe-linux-distribution` and `install.sh`. ##### Windows -The XCP-ng team is looking for help in improving the guest tools installer, build process, and clean-up tools. +The XCP-ng team is looking for help in improving the guest tools installer, build process, and clean-up tools. For more details, see the [win-pv-drivers](https://github.com/xcp-ng/win-pv-drivers) repository.