Xen Windows GplPv/Installing

Needs Review Important page: This page is probably out-of-date and needs to be reviewed and corrected!

Before installing

After building you should have a 'target' directory with all the stuff you need in it. Copy this to your target machine. If you downloaded a binary zip then extract it to your target machine. For the shutdown monitor, which handles the graceful shutdown/reboot requests from Dom0, you will need the .NET framework 2.0 installed.

NOTE: x64 versions of Vista and Server 2008 require signed drivers. The GPLPV drivers are only test signed. In order to use them you need to enable test signing by running "bcdedit /set testsigning on" and rebooting.

Uninstalling

If you are upgrading from a pre-0.9.0 release, you will need to completely purge the old drivers from your system.

• Open regedit and go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
• Alter Enum\ACPI_HAL\PNP0C08\0\Control\ActiveService from "XenHide" to "ACPI"
• You may find some registry keys/values need you to alter permissions before you can edit/delete them.
• Search for all occurences of UpperFilter or LowerFilter keys containing xenhide.sys and delete them
• Delete Services\Xen* (anything in Services starting with Xen)
• Beware of keys/values which "co-incidentally" have xen in their name such as xenroll.dlll and IVBSAXEntityResolver
• Don't remove any "Xen" keys/values under HKLM/HARDWARE/ACPI
• View files C:\Windows\inf\oem*.?nf in a text editor, delete all that refer to xen or GPLPV
• Delete the folders C:\Windows\System32\DRVSTORE\xen*
• Delete the files C:\Windows\System32\drivers\xen*.sys
• Reboot, making sure not to select a boot entry that specifies /GPLPV, if you are prompted to add drivers for new hardware at this stage, hit the cancel button.

If you end up with a bluescreen at this point, it might be useful to boot from a windows CD (or .iso file) and press "R" for recovery console, then use the LISTSVC, ENABLE and DISABLE commands to ensure all xen drivers are disabled *except* for xenhide which should be set to BOOT.

Installing (0.9.5 and above)

---

• /!\ Warning: When installing for the first time, make sure you do NOT boot with /GPLPV specified in your boot entry. This is sure to break things!

---

• Run "Xen PV Drivers <version>.exe"
• Run "C:\Program Files\Xen PV Drivers\ShutdownMon.exe -i" to install shutdownmon as a service (in a command prompt if you want to get feedback that it succeeds).
• (Windows 2000, XP, 2003) Open C:\boot.ini and copy your normal boot entry and add /gplpv to the copy. It should look something like this (excuse the line wrapping):

[boot loader]
timeout=30
default=multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
[operating systems]
multi(0)disk(0)rdisk(0)partition(1)\WINDOWS="Windows Server 2003, Enterprise, GPLPV" /noexecute=optout /fastdetect /gplpv
multi(0)disk(0)rdisk(0)partition(1)\WINDOWS="Windows Server 2003, Enterprise" /noexecute=optout /fastdetect

That should be all that is required. Alternatively, you can install the drivers separately via the device manager if you want, for example if you just want xenpci to do graceful shutdown but don't yet want to try the PV device drivers.

• (Windows Vista, 2008) (this bit isn't complete) Do the following at a command prompt

bcdedit /enum /v         <-- note the guid string next to "identifier" under "Windows Boot Loader"
bcdedit /copy {string from above} /d "Microsoft Windows Server 2008 GPLPV"    <-- change description to whatever suits you and note the new guid that gets printed as a result
bcdedit /set {new guid from above} LOADOPTIONS "GPLPV"

Installing (Pre 0.9.5)

---

• /!\ Warning: When installing for the first time, make sure you do NOT boot with /GPLPV specified in your boot entry. This is sure to break things!

---

• Run install.bat
• Open C:\boot.ini and copy your normal boot entry and add /gplpv to the copy. It should look something like this (excuse the line wrapping):

[boot loader]
timeout=30
default=multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
[operating systems]
multi(0)disk(0)rdisk(0)partition(1)\WINDOWS="Windows Server 2003, Enterprise, GPLPV" /noexecute=optout /fastdetect /gplpv
multi(0)disk(0)rdisk(0)partition(1)\WINDOWS="Windows Server 2003, Enterprise" /noexecute=optout /fastdetect

That should be all that is required. Alternatively, you can install the drivers separately via the device manager if you want, for example if you just want xenpci to do graceful shutdown but don't yet want to try the PV device drivers.