diff --git a/docs/troubleshooting/windows-pv-tools.md b/docs/troubleshooting/windows-pv-tools.md index 2c61cac..52a2712 100644 --- a/docs/troubleshooting/windows-pv-tools.md +++ b/docs/troubleshooting/windows-pv-tools.md @@ -1,16 +1,6 @@ -# Windows Agent / PV-Tools +# 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 @@ -21,19 +11,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. @@ -43,12 +22,10 @@ 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. -[This Guide](../../vms#upgrade-from-citrix-xenserver-client-tools) may help you through the process. +See the XenClean guides below for instructions. ## Not all PV drivers are correctly installed @@ -60,4 +37,71 @@ It's possible that some antivirus blocks the end of the installation of the PV d ### Solution -Simply pausing the agent and doing a reboot will make the XenTools to install succesfully. After a succesfull installation, enabling the SentinelOne agent again is possible without any other issues regarding the tools or drivers. \ No newline at end of file +Simply pausing the agent and doing a reboot will make the XenTools to install succesfully. After a succesfull installation, enabling the SentinelOne agent again is possible without any other issues regarding the tools or drivers. + +## 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 CD of XCP-ng Windows PV Tools 9.1 and above. + +To use XenClean, simply run the `Invoke-XenClean.ps1` script **as Administrator**. Your system will automatically reboot. + +**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-