1.7 SUSE Drivers for Red Hat Enterprise Linux 5 on Xen

This section provides instructions for installing, uninstalling, and updating the SUSE Drivers for Red Hat Enterprise Linux 5 on Xen.

1.7.1 Installing the RHEL 5 Drivers

  1. Open a terminal.

  2. Mount the driver pack ISO. Instructions for mounting the ISO are available in the Configuration Options and Settings Guide in Section 1.5: Virtual CD Drives and ISO Images.

    (Optional) If you are installing from an RPM that you built, the RPM is located in /usr/src/redhat/RPMS/ arch , where arch is the architecture of the virtual machine. See Section 1.7.5, Building Your Own RPMs for more information.

  3. Install the RPM.

    1. Open a terminal.

    2. Enter rpm -U xxx.rpm , where xxx is the RPM filename.

    3. Edit the /boot/grub/menu.lst file and make the following changes:

      • Set the default= xxx (where xxx is the old boot entry) to default=0, which is the boot entry with the latest initrd.

      • For each drive specified in the virtual machine configuration file (for example, hda and hdb), append hdx=noprobe to the kernel line for the updated kernel, where hdx is the drive specification found in the virtual machine configuration file.

  4. Shut down the virtual machine.

  5. On the virtualization host server, open a terminal and enter xm delete vm_name to delete the virtual machine’s reference in xenstore so it is no longer managed.

    HINT: Enter xm list to see the name of the virtual machine ( vm_name).

  6. Open the virtual machine configuration file located on virtualization host server ( /etc/xen/vm/vm_cfgfile where vm_cfgfile is usually the same as the name of the virtual machine).

  7. Remove all parameters from the vif= line except the mac=mac_address parameter. Make sure to leave the single quotes.

    For example, change the line

    vif=[ 'mac=00:16:3e:55:24:21,model=pcnet,type=ioemu', ]
    

    to

    vif=[ 'mac=00:16:3e:55:24:21', ]
    
  8. At the terminal, enter xm new vm_cfgfile to reference the virtual machine in the xenstore so it is managed again.

  9. Restart the virtual machine.

1.7.2 Uninstalling the RHEL 5 Drivers

  1. Open a terminal.

  2. Enter rpm -e kmod-vmdp-rhel5- xxx , where xxx is the version of the installed driver pack.

    HINT:Enter rpm -qa | grep vmdp to find out what you have installed.

  3. Edit the /boot/grub/menu.lst and make the following changes:

    • Set the default= xxx (where xxx is the old boot entry) to default=0, which is the boot entry with the latest initrd.

    • Remove all hdx=noprobe entries from the kernel line.

  4. Restart the virtual machine.

1.7.3 Upgrading the RHEL 5 Drivers

  1. Open a terminal.

  2. Mount the new driver pack ISO. Instructions for mounting the ISO are available in the Configuration Options and Settings Guide in Section 1.5: Virtual CD Drives and ISO Images.

    (Optional) If you are installing from an RPM that you built, the RPM is located in /usr/src/redhat/RPMS/ arch , where arch is the architecture of the virtual machine. See Section 1.7.5, Building Your Own RPMs for more information.

  3. Enter rpm -U xxx.rpm , where xxx is the name of the newer driver pack RPM.

  4. Verify that the default kernel is the one with the latest initrd in the /boot/grub/menu.list.

1.7.4 Using the Drivers with an Upgraded Kernel

  1. Install the kernel.

    IMPORTANT:Do not reboot the virtual machine.

  2. Before rebooting the virtual machine, make sure all the following directories are present in /lib/modules/ xxx/weak-updates/vmdp (where xxx is the new kernel version):

    • blkfront

    • netfront

    • platform-pci

    • util

    • xenbus

If these files are not present, do the following:

  1. Edit the /boot/grub/menu.lst file and remove all hdx=noprobe entries from the kernel line.

  2. Restart the virtual machine.

  3. Upgrade the driver pack (see Section 1.7.3, Upgrading the RHEL 5 Drivers).

  4. Edit the /boot/grub/menu.lst file and make the following change:

    For each drive specified in the virtual machine configuration file (for example, hda and hdb), append hdx=noprobe to the kernel line for the updated kernel, where hdx is the drive specification found in the virtual machine configuration file.

  5. Reboot the virtual machine.

1.7.5 Building Your Own RPMs

If you do not have a driver pack that is compatible with your Linux kernel, you can build your own SUSE Drivers for Red Hat Enterprise Linux 5 on Xen RPM.

  1. Open a terminal.

  2. Mount the driver pack ISO. Instructions for mounting the ISO are available in the Configuration Options and Settings Guide in Section 1.5: Virtual CD Drives and ISO Images.

  3. Enter rpmbuild -–rebuild xxx.src.rpm , where xxx is the name for the source RPM. This creates a binary RPM in /usr/src/redhat/RPMS/ arch/ , where arch is the architecture of the virtual machine.