Skip to content

Commit 188b336

Browse files
committed
Update XenClean and XenBootFix instructions
Update version numbers. State that the latest WinPV tools can now be obtained in ISO form. Signed-off-by: Tu Dinh <[email protected]>
1 parent b866746 commit 188b336

File tree

1 file changed

+6
-7
lines changed

1 file changed

+6
-7
lines changed

docs/troubleshooting/windows-pv-tools.md

+6-7
Original file line numberDiff line numberDiff line change
@@ -73,11 +73,11 @@ Consult your motherboard manual for details; for example, on Dell systems with i
7373

7474
XenClean is an utility for cleanly removing Xen PV drivers and management agents of the following products:
7575

76-
* XCP-ng Windows PV Tools, versions 8.2 and 9.1
77-
* XenServer VM Tools for Windows, versions 9.3 and 9.4
76+
* XCP-ng Windows PV Tools, versions 8.2 to 9.1
77+
* XenServer VM Tools for Windows, versions 7.1 to 9.4
7878
* Other Xen drivers
7979

80-
It is included in the installation package of XCP-ng Windows PV Tools 9.1 and above.
80+
It is included in the installation package of XCP-ng Windows PV Tools 9.0 and above.
8181
[See the newest releases here.](https://github.com/xcp-ng/win-pv-drivers/releases)
8282

8383
:::note
@@ -98,7 +98,7 @@ XenClean leaves its log files at the current directory and at `%TEMP%\xenclean-<
9898
## Windows fails to boot (hanging at boot or BSOD with Stop code `INACCESSIBLE_BOOT_DEVICE`)
9999

100100
In some situations (failed uninstallation, major Windows version upgrades), Xen PV drivers (whether Citrix or XCP-ng) may cause Windows to fail to start (hanging at boot, BSOD with Stop code `INACCESSIBLE_BOOT_DEVICE`).
101-
The XenBootFix utility included with XCP-ng Windows PV Tools 9.1 and above helps you disable any active Xen PV drivers and get your system to a bootable state before running XenClean.
101+
The XenBootFix utility included with XCP-ng Windows PV Tools 9.0 and above helps you disable any active Xen PV drivers and get your system to a bootable state before running XenClean.
102102

103103
:::note
104104
The utility only runs in Windows Preinstallation Environment (PE) or Windows Recovery Environment (RE). It will not run from Safe Mode.
@@ -121,9 +121,8 @@ Below is a procedure for using XenBootFix to recover a non-booting VM:
121121
* If your Windows partition does not have a drive letter, type `sel vol N` where `N` is the volume number shown in Diskpart, then type `assign letter=W`. Your Windows partition will be assigned the drive letter `W:`.
122122
* Finally, at the `DISKPART>` prompt, type `exit` to exit Diskpart.
123123
5. Obtain XenBootFix.
124-
* If you're using XCP-ng Windows PV Tools 9.1 or later, it is located at `W:\Program Files\XCP-ng\Windows PV Drivers\XenBootFix\XenBootFix.exe` where `W:` is your Windows drive letter.
125-
* If you have PowerShell, run the following command: `Invoke-WebRequest https://<download path of XenBootFix.exe> -OutFile XenBootFix.exe`
126-
* Failing all that, you can create a new ISO image containing XenBootFix using WinCDEmu, ImgBurn or a similar tool, then attach it to your VM.
124+
* The easiest way is to download and use the [latest release ISO](https://github.com/xcp-ng/win-pv-drivers/releases) of XCP-ng Windows PV Tools, which includes a copy of XenBootFix at `package\XenBootFix\XenBootFix.exe`.
125+
* If you're using XCP-ng Windows PV Tools 9.0 or later, it is also located at `W:\Program Files\XCP-ng\Windows PV Drivers\XenBootFix\XenBootFix.exe` where `W:` is your Windows drive letter.
127126
* **Note**: If using Windows PE, do not remove its CD image when it's running. You may encounter unexpected errors otherwise.
128127
6. Run the command `<path to XenBootFix.exe> W:\Windows` where `W:` is your Windows drive letter.
129128
* **Note**: Make sure the drive letter belongs to your actual Windows installation and not Windows PE/RE. By default, Windows PE/RE use the drive letter **X:**.

0 commit comments

Comments
 (0)