
Install instructions for rhel4 pv-on-hvm drivers
================================================

Note: These packages do not support booting from a paravirtualized
      disk.  Booting the kernel requires the use of the emulated
      IDE driver, while user-level application & data disks can
      use the paravirtualized block driver.

Installation:

 (1) 'rpm -ivh kmod-xenpv-{%release}.$(uname -m).rpm'

 (2) Reconfigure the virtual machine: switch nic from emulated
      to paravirtual (aka remove type=ioemu in the xen guest config file).

 (3) Add additional disk partitions/volumes to the virtual
     machine that will be accessed via the xen-vbd pv-disk driver:
     e.g., edit the xen guest config file:
        original: 
             disk = [ "file:/home/xen-guest-disks/rhel4_64_fv.dsk,hda,w"]
        additional xvd disk: 
             disk = [ "file:/home/xen-guest-disks/rhel4_64_fv.dsk,hda,w", 
                      "tap:aio:/home/xen-guest-disks/rhel4_64_fv_usr.dsk,xvda,w" ]
 
 (4)  Boot the virtual machine. 
      NOTE: you must use "xm create <virt-machine-name>
            or else the xen-vnif pv-network driver will not be connected to eth0 properly.
            A known bug, BZ 300531.

 (5) An updated module-init-tools is required for this package, available
     in the RHEL4-6-z kernel and beyond.
     If automatic loading of the pv-on-hvm drivers does not occur,
     one has to do the following to configure the xen block & network drivers to
     run and see their respective devices:
	cp -R /lib/modules/2.6.9-67.ELsmp/extra/xenpv /lib/modules/'uname -r'/extra/xenpv
	cd /lib/modules/'uname -r'/extra/xenpv/<xenpv-version>
	insmod xen-platform-pci.ko
	insmod xen-balloon.ko
	insmod xen-vbd.ko
	insmod xen-vnif.ko

 (6)  You might have to reconfigure network (use system-config-network)
      or edit /etc/sysconfig/network-scripts/ifcfg-eth0 due to the nic driver change.

 (7) ia64 binary rpm's and builds are not available at this time, but
     are expected in a future revision.

 (8) This package is not supported on RHEL4-GA through RHEL4-U2 systems/kernels.

 (9) For performance reasons, "noapic" should be added to the kernel boot line
      in your system's grub.conf entry, e.g.,
          kernel /vmlinuz-2.6.9-59.EL ro root=/dev/VolGroup00/rhel4_x86_64 rhgb noapic

