Skip to content

Commit afec10e

Browse files
authored
Merge pull request #347 from xcp-ng/stormi/xsa468
Updates for XSA-468
2 parents 0c18791 + 6e39e15 commit afec10e

File tree

2 files changed

+240
-197
lines changed

2 files changed

+240
-197
lines changed

docs/troubleshooting/windows-pv-tools.md

Lines changed: 2 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,6 @@
22

33
Common issues with Windows PV tools.
44

5-
## Windows Management Agent failed to install
6-
7-
### Cause
8-
There was an issue with the installing of the drivers certificate, so the drivers did not load silently.
9-
10-
### Solution
11-
Resolved with version 8.2.2.200-RC1 and newer.
12-
13-
***
14-
155
## PV-Drivers missing in the Device Manager
166

177
### Cause
@@ -22,7 +12,7 @@ If despite running the Windows tools installer, there's no devices visible in th
2212

2313
#### Leftovers from old Citrix XenServer Client Tools.
2414

25-
See the [XenClean guide](#fully-removing-xen-pv-drivers-with-xenclean) below for instructions.
15+
See the [XenClean guide](/vms/#fully-removing-xen-pv-drivers-with-xenclean) for instructions.
2616

2717
## Network PV drivers aren't working.
2818

@@ -32,12 +22,10 @@ If the tools are installed, while XCP-ng Center says that I/O is optimized, but
3222

3323
### Possible Solutions
3424

35-
* Resolved with version 8.2.2.200-RC1 and newer.
36-
3725
* Clean your system from `Citrix Client Tools` _AND_ `XCP-ng Client Tools` to create a clean state.
3826
* Then install the Client Tools from scratch.
3927

40-
See the [XenClean guide](#fully-removing-xen-pv-drivers-with-xenclean) below for instructions.
28+
See the [XenClean guide](/vms/#fully-removing-xen-pv-drivers-with-xenclean) for instructions.
4129

4230
## Not all PV drivers are correctly installed
4331

@@ -69,31 +57,6 @@ Consult your motherboard manual for details; for example, on Dell systems with i
6957
![](../../static/img/performance-setting.png)
7058
</div>
7159

72-
## Fully removing Xen PV drivers with XenClean
73-
74-
XenClean is an utility for cleanly removing Xen PV drivers and management agents of the following products:
75-
76-
* XCP-ng Windows PV Tools, versions 8.2 to 9.1
77-
* XenServer VM Tools for Windows, versions 7.1 to 9.4
78-
* Other Xen drivers
79-
80-
It is included in the installation package of XCP-ng Windows PV Tools 9.0 and above.
81-
[See the newest releases here.](https://github.com/xcp-ng/win-pv-drivers/releases)
82-
83-
:::note
84-
Before running XenClean:
85-
86-
* Take a snapshot of your VM.
87-
* You should always use the latest version of XenClean regardless of your Windows PV driver version. The same applies to XenBootFix.
88-
* You should disable the "Manage Citrix PV drivers via Windows Update" option on your VM. Otherwise, Windows may reinstall PV drivers from Windows Update after rebooting.
89-
* 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**.
90-
:::
91-
92-
To use XenClean, simply run the `Invoke-XenClean.ps1` script **as Administrator**. Your system will automatically reboot.
93-
94-
:::tip
95-
XenClean leaves its log files at the current directory and at `%TEMP%\xenclean-<time>`. Please provide these logs in case of uninstallation failure.
96-
:::
9760

9861
## Windows fails to boot (hanging at boot or BSOD with Stop code `INACCESSIBLE_BOOT_DEVICE`)
9962

0 commit comments

Comments
 (0)