Product SiteDocumentation Site

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. Before starting the actual uninstallation process, 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”).
    <disk type='file' device='disk'>
      <driver name='tap' type='aio'/>
      <source file='/var/lib/xen/images/disk2.img'/>
      <target dev='xvdb'/>
    </disk>
    
    Example 6.1. Para-virtualized disk entry

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

    Note

    Red Hat Virtualization 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.
  2. Open the Add or Remove Programs in the Control Panel menu.
  3. Select the Red Hat Xen Para-virtualized Drivers program from the list and click the Remove button.
  4. After prompting for confirmation, the uninstall process will reboot the guest and proceed with the actual uninstallation. Click Yes at the prompt, and wait for the uninstall process to complete.
    After reboot, the uninstall wizard will remove the driver for the para-virtualization interface device.
  5. The Windows Device Manager will then detect an unrecognized device named "PCI Device" and an "Add New Hardware Wizard" will appear. You can safely close the wizard with the Cancel button. Similarly, you can ignore requests to reboot machine; these come from Windows rather than from the uninstall program.
  6. Shut down the guest, and restart it using the modified configuration you prepared in step Step 4.
Using virt-manager 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.