Chapter 6. Uninstalling the para-virtualized drivers

This section details the process for uninstalling the para-virtualized drivers from your Microsoft Windows guests.

Procedure 6.1. Removing the para-virtualized drivers

  1. Open the Add or Remove Programs in the Control Panel menu.
  2. Select the Red Hat Xen Para-virtualized Drivers program from the list and click the Remove button.
  3. Once the uninstall process finishes you are prompted to reboot the guest. Click No to the prompt. Shut down the guest instead, do not reboot or restart the guest.
  4. After shutting down the guest, use virsh dumpxml to create an XML configuration file for the guest. Change guest-name and guest.xml to match the name of your guest and the file for saving the configuration.
    # virsh dumpxml guestname > guest.xml
    For every disk entry (refer to Example 6.1, “Para-virtualized disk entry”) in the guest.xml file modify the para-virtualized disk entry to use the generic virtualized drivers(refer to Example 6.2, “Generic disk entry”).

    Example 6.1. Para-virtualized disk entry

    <disk type='file' device='disk'>
      <driver name='tap' type='aio'/>
      <source file='/var/lib/xen/images/disk2.img'/>
      <target dev='xvdb'/>
    </disk>
    

    Example 6.2. Generic disk entry

    <disk type='file' device='disk'>
      <driver name='file'/>
      <source file='/var/lib/xen/images/disk2.img'/>
      <target dev='hdb'/>
    </disk>
    

    Warning

    Xen is limited to 4 fully virtualized IDE devices. You cannot presently convert more than 3 para-virtualized disks to fully virtualized disks due to this limitation.
  5. Restart the guest.
  6. The installer automatically enables the para-virtualized disk driver during the install. The uninstall wizard removed the driver but the device node remains in Windows Device Manager after rebooting. The device node appears as a device named "PCI Device".
    This device causes a "Add New Hardware Wizard" to appear. You can safely close the wizard with the Cancel button.
    To permanently disable the para-virtualized disk driver after uninstalling the driver package you must use the provided scripts in the C:\Program Files\RedHat\XenPV directory. The para-virtualized drivers files are in the directory chosen during the installation process.
    • disableRedHatSCSIDriver.bat - this script disables the para-virtualized disk driver
    • enableRedHatSCSIDriver.bat - this script enables the para-virtualized disk driver
    Double click the disableRedHatSCSIDriver.bat file or execute disableRedHatSCSIDriver.bat from an MS-DOS prompt.

    Note

    To run executable batch files in Windows Vista you must right click the file and select Run as Administrator from the menu that appears. Double clicking on the file runs the batch script without the appropriate privileges to run successfully.
    After running the disable script the "PCI Device" in the Device Manager displays a red X icon, indicating that it is disabled.

Note

To re-install the para-virtualized drivers the enableRedHatSCSIDriver.bat script must be executed before the installation program. Ensure that the red X is gone from the device node before attempting to re-install the drivers using the installer package.
Using virt-manger to uninstall devices

virt-manager can be used instead of virsh to remove devices.

To remove devices, use the Remove for the para-virtualized devices. Removed devices can be added again with the Add wizard.
Once a device has been removed re-adding removed devices causes the device to use the the generic drivers. Use the procedure for adding devices to force the devices to use the para-virtualized drivers. Refer to Block device configuration.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.