diff --git a/docs/troubleshooting/windows-pv-tools.md b/docs/troubleshooting/windows-pv-tools.md index 62af7d2a..9a5423da 100644 --- a/docs/troubleshooting/windows-pv-tools.md +++ b/docs/troubleshooting/windows-pv-tools.md @@ -1,4 +1,4 @@ -# Windows Agent / PV-Tools +# Windows PV Tools Common issues with Windows PV tools. @@ -21,19 +21,8 @@ If despite running the Windows tools installer, there's no devices visible in th ### Solutions #### Leftovers from old Citrix XenServer Client Tools. -1. remove any xen*.* files from `C:\Windows\system32` like - * xenbus_coinst_7_2_0_51.dll - * xenvbd_coinst_7_2_0_40.dll - * xenbus_monitor_8_2_1_5.exe - * and similiar `xen*_coinst` and `xen*_monitor` files -2. remove any leftover `XenServer` devices from device manager, also display hidden `XenServer` devices and remove them! - * To show hidden devices in Device Manager: `View -> Show Hidden Devices` -#### There was an issue with the installing of the drivers certificate, so the drivers did not load silently - -Resolved with version 8.2.2.200-RC1 and newer. - -*** +See the XenClean guides below for instructions. ## Network PV drivers aren't working. @@ -48,7 +37,7 @@ If the tools are installed, while XCP-ng Center says that I/O is optimized, but * Clean your system from `Citrix Client Tools` _AND_ `XCP-ng Client Tools` to create a clean state. * Then install the Client Tools from scratch. -[This Guide](../../vms#%EF%B8%8F-guest-tools) may help you through the process. +See the XenClean guides below for instructions. ## Not all PV drivers are correctly installed @@ -80,6 +69,76 @@ Consult your motherboard manual for details; for example, on Dell systems with i ![](../../static/img/performance-setting.png) +## Completely removing existing Xen PV drivers with XenClean + +XenClean is an utility for cleanly removing Xen PV drivers and management agents of the following products: + +* XCP-ng Windows PV Tools, versions 8.2 and 9.1 +* XenServer VM Tools for Windows, versions 9.3 and 9.4 +* Other Xen drivers + +It is included in the installation package of XCP-ng Windows PV Tools 9.1 and above. +[See the newest releases here.](https://github.com/xcp-ng/win-pv-drivers/releases) + +To use XenClean, simply run the `Invoke-XenClean.ps1` script **as Administrator**. Your system will automatically reboot. + +**Note**: You should always use the latest version of XenClean regardless of your Windows PV driver version. The same applies to XenBootFix. + +**Note**: You should disable the "Manage Citrix PV drivers via Windows Update" option on your VM before running XenClean. Otherwise, Windows may reinstall PV drivers from Windows Update after rebooting. + +**Note**: If you downloaded XenClean from the internet, you may need to unblock the script file before running it. This can be done by right-clicking the file, then choosing **Properties** - **Unblock** - **OK**. + +**Tip**: XenClean leaves its log files at `%TEMP%\xenclean-