How to install Integrity VM Guest using Host USB DVD drive

From Wiki-UX.info
Jump to: navigation, search


Abstract[edit]

This article explains the limitations of using USB DVD drives on Integrity Virtual Machine Guests. This information applies to systems that uses USB DVD inserts instead of [SCSI | IDE interfaces], like the rx2660, rx3600 and rx6600. This also applies to blade systems like the BL860C and BL870C when using an external USB drive instead of the Blade enclosure vMedia software.

Background[edit]

Integrity Virtual Machines 3.5 and 4.0 only support USB DVD of this platforms as virtual disks, in other words, the HPVM guest will detect all it's virtual CD/DVD as USB units, but USB units in the host cannot be used as backing store for HPVM guest, only the use of ISO files is supported on this situation. Direct attachment of the USB device is not supported, in most cases yields sub standard performance and I/O errors on the HPVM guest are common (this I/O errors are actually time outs on the HPVM host USB subsystem.

The same procedures detailed here can be use to present [SCSI | IDE] DVD/CD drives to HPVM guests.

Identify USB DVD/CD devices[edit]

On HP-UX 11i v2 and 11i v3 Hosts, before the Update to USB Driver Support made on late December 2008, USB 2.0 transfer speed was not supported. On HP-UX 11i v3 Update 3 and below, agile device special files (/dev/disk/disk#) for USB DVD/CD was not available. The following ioscan commands can be used to identified the USB DVD special device file.

The following commands can be used to identified the DVD/CD special device files on each platform.

HPUX 11i v2:

# ioscan -fnk
Class        I  H/W Path        Driver          S/W State   H/W Type     Description
=====================================================================================
...
OO           3  0/0/2/1         UsbOhci         CLAIMED     INTERFACE    USB OHCI Interface
OO           4  0/0/2/1.0       UsbMiniBus      CLAIMED     INTERFACE    USB Composite Device
OO           6  0/0/2/1.0.0     UsbBulkOnlyMS   CLAIMED     DEVICE       USB Bulk Only
ext_bus      0  0/0/2/1.0.16    UsbScsiAdaptor  CLAIMED     INTERFACE    USB SCSI Stack Adaptor
target       0  0/0/2/1.0.16.0  tgt             CLAIMED     DEVICE
disk         2  0/0/2/1.0.16.0.0          sdisk           CLAIMED     DEVICE       TEAC    DV-28E-V
                               /dev/dsk/c0t0d0   /dev/rdsk/c0t0d0
...

Note that on HP-UX 11i v2 prior to the Update to USB Driver Support, the USV DVD/CD devices Hardware Path will be attached to a USB OHCI Interface using the 00 USB Class driver through a UsbScsiAdaptor.

[-] 0/0/2/1 UsbOhci 
 [-]  0/0/2/1.0 UsbMiniBus
    [-] 0/0/2/1.0.0 UsbBulkOnlyMS
       [-]  0/0/2/1.0.16 UsbScsiAdaptor
          [-] 0/0/2/1.0.16.0  tgt
             [ ] 0/0/2/1.0.16.0.0 sdisk TEAC    DV-28E-V

HP-UX 11i v3:

# ioscan -fnkC disk | grep -i usb
disk     15  0/0/1/1.1.16   UsbScsiAdaptor   CLAIMED     DEVICE       USB SCSI Stack Adaptor
                           /dev/deviceFileSystem/Usb/MassStorage/dsk/disk@UnknownDevice-1659+9479=00
                           /dev/deviceFileSystem/Usb/MassStorage/rdsk/disk@UnknownDevice-1659+9479=00

Is highly recommended to schedule downtime of the HPVM host to installing the USB Driver Support updates detailed on the following guides:

This updates will provided USB 2.0 transfer speeds and provides agile device special files to HP-UX 11i v3 systems. Other well know USB stack performance problem are also corrected with this update dependencies. Check the previous guides for complete details.

Assign Host USB DVD to the HPVM guest[edit]

There are two methods to use USB dvd drives to provided HPVM guest backing storage:

  1. Create (dump) ISO images from the installation media
  2. Assign the Host USB DVD to the Guest

The supported method is to create a ISO image of the bootable HP-UX installation media. The unsupported method is to present USB drive directly to the HPVM guest with the Update to USB Driver Support patches installed on the HPVM host. This second approach is not widely tested, and some glitches are expected.

Following are the details for each method.

Create ISO images from the installation media[edit]

1. Copy the content of the installation media from the USB drive. The /var/tmp directory is used through the example, but using the same convention directory convention (/var/opt/hpvm/ISO-images of the Linux ISO images, chapter 6.2 of the Administration Guide) is highly recomended.

# mkdir /var/tmp/iso

HPUX 11i v2

# dd if=/dev/rdsk/c#t#d# of=/var/tmp/iso/B.11.31.ISO bs=2048

HP-UX 11i v3

  • On systems without the Update to USB Driver Support patches:
# dd if=/dev/deviceFileSystem/Usb/MassStorage/rdsk/disk@UnknownDevice-1659+9479=00 \
of=/var/tmp/iso/B.11.31.ISO bs=2048
  • On systems with Update to USB Driver Support patches:
# dd if=/dev/rdisk/disk# of=/var/tmp/iso/B.11.31.ISO bs=2048
NOTE: Even while using USB 2.0 transfer speeds, copying the disk using the HP-UX dd command can take a long time. You can use other speciality tools that allows the creation of CD/DVD ISO images on your worstation. On Windows based systems, the opensource imgburner has been tested.


2. Assign the ISO image to the HPVM guest.

# hpvmmodify -P tifa -a dvd:scsi::file:/var/tmp/iso/B.11.31.ISO

3. Verify the status

# hpvmstatus -P tifa
[Virtual Machine Details]
Virtual Machine Name VM #  OS Type State
==================== ===== ======= ========
tifa                     2 HPUX    Off

[Authorized Administrators]
Oper Groups:
Admin Groups:
Oper Users:
Admin Users:

[Virtual CPU Details]
#vCPUs Entitlement Maximum
====== =========== =======
     1       10.0%  100.0%

[Memory Details]
Total    Reserved
Memory   Memory
=======  ========
   2 GB     64 MB

[Storage Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
disk    avio_stor    0   0   0   0   0 disk      /dev/rdisk/disk10
dvd     scsi         0   2   0   0   0 file      /var/tmp/iso/B.11.31.ISO

[Network Interface Details]
Interface Adaptor    Name/Num   PortNum Bus Dev Ftn Mac Address
========= ========== ========== ======= === === === =================
vswitch   lan        sw1        2         0   1   0 ca-65-fd-92-24-b9

[Misc Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
serial  com1                           tty       console

Assign the Host USB DVD to the Guest[edit]

# hpvmmodify -P tifa -a dvd:scsi::disk:/dev/rdisk/disk8
# hpvmstatus -P tifa
[Virtual Machine Details]
Virtual Machine Name VM #  OS Type State
==================== ===== ======= ========
tifa                     2 HPUX    Off

[Authorized Administrators]
Oper Groups:
Admin Groups:
Oper Users:
Admin Users:

[Virtual CPU Details]
#vCPUs Entitlement Maximum
====== =========== =======
     1       10.0%  100.0%

[Memory Details]
Total    Reserved
Memory   Memory
=======  ========
   2 GB     64 MB

[Storage Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
disk    avio_stor    0   0   0   0   0 disk      /dev/rdisk/disk10
dvd     scsi         0   2   0   0   0 disk      /dev/rdisk/disk8

[Network Interface Details]
Interface Adaptor    Name/Num   PortNum Bus Dev Ftn Mac Address
========= ========== ========== ======= === === === =================
vswitch   lan        sw1        2         0   1   0 ca-65-fd-92-24-b9

[Misc Interface Details]
Guest                                 Physical
Device  Adaptor    Bus Dev Ftn Tgt Lun Storage   Device
======= ========== === === === === === ========= =========================
serial  com1                           tty       console

Start the HPVM guest[edit]

# hpvmstart -P tifa
(C) Copyright 2000 - 2008 Hewlett-Packard Development Company, L.P.
Opening minor device and creating guest machine container
Creation of VM, minor device 1
Allocating guest memory: 2048MB
  allocating low RAM (0-80000000, 2048MB)
/opt/hpvm/lbin/hpvmapp (/var/opt/hpvm/uuids/505cffd4-b846-11dd-a401-00306e4af350/vmm_config.next): Allocated 2147483648 bytes at 0x6000000100000000
    locking memory: 0-80000000
  allocating datalogger memory: FF800000-FF810000 (64KB for 12KB)
/opt/hpvm/lbin/hpvmapp (/var/opt/hpvm/uuids/505cffd4-b846-11dd-a401-00306e4af350/vmm_config.next): Allocated 65536 bytes at 0x6000000200000000
    locking datalogger memory
  allocating firmware RAM (fff00000-fff20000, 128KB)
/opt/hpvm/lbin/hpvmapp (/var/opt/hpvm/uuids/505cffd4-b846-11dd-a401-00306e4af350/vmm_config.next): Allocated 131072 bytes at 0x6000000200020000
    locked SAL RAM: 00000000fff00000 (8KB)
    locked ESI RAM: 00000000fff02000 (8KB)
    locked PAL RAM: 00000000fff04000 (8KB)
    locked Min Save State: 00000000fff06000 (4KB)
    locked datalogger: 00000000ff800000 (64KB)
Loading boot image
Image initial IP=102000 GP=686000
Initialize guest memory mapping tables
Starting event polling thread
Starting thread initialization
Daemonizing....
hpvmstart: Successful start initiation of guest 'tifa'

Connect to the HPVM guest virtual console[edit]

# hpvmconsole -P tifa


   vMP MAIN MENU

         CO: Console
         CM: Command Menu
         CL: Console Log
         SL: Show Event Logs
         VM: Virtual Machine Menu
         HE: Main Help Menu
          X: Exit Connection

[tifa] vMP> CO

Booting from the DVD using the EFI Shell[edit]

1. Select "EFI Shell [Built-in]"

EFI Boot Manager ver 1.10 [14.62] [Build: Tue Jun 17 09:30:56 2008]

Please select a boot option

    HP-UX Primary Boot: 0/0/0/0.0.0
    Lan Boot
    EFI Shell [Built-in]
    Boot option maintenance menu


    Use ^ and v to change option(s). Use Enter to select an option

2. Move to the DVD EFI Filesystem (fs#) for the Virtual DVD

Loading.: EFI Shell [Built-in]
EFI Shell version 1.10 [14.62]
Device mapping table
  fs0  : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part1,Sig90C9A3C6-B862-11DD-8002-D6217B60E588)
  fs1  : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part3,Sig90C9A448-B862-11DD-8004-D6217B60E588)
  fs2  : Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)/CDROM(Entry0)
  blk0 : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)
  blk1 : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part1,Sig90C9A3C6-B862-11DD-8002-D6217B60E588)
  blk2 : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part2,Sig90C9A40C-B862-11DD-8003-D6217B60E588)
  blk3 : Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part3,Sig90C9A448-B862-11DD-8004-D6217B60E588)
  blk4 : Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)
  blk5 : Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)/CDROM(Entry0)
  blk6 : Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)/CDROM(Entry1)
Shell> fs2:

3. Start the INSTALL.EFI boot program.

fs2:\> INSTALL.EFI

(C) Copyright 1999-2008 Hewlett-Packard Development Company, L.P.
All rights reserved

HP-UX Boot Loader for IPF  --  Revision 2.036

Press Any Key to interrupt Autoboot
\AUTO ==> boot :IINSTALL
Seconds left till autoboot -   0
AUTOBOOTING...> System Memory = 2042 MB
loading section 0
.................................................................................................... (complete)
loading section 1
................. (complete)
loading symbol table
loading ram disk file (:IINSTALLFS).
.....................................................................................................................
 (complete)
Launching :IINSTALL
SIZE: Text:50892K + Data:8336K + BSS:23776K = Total:83006K

Adding a Virtual DVD boot option[edit]

1. Select Boot option maintenance menu

EFI Boot Manager ver 1.10 [14.62] [Build: Tue Jun 17 09:30:56 2008]

Please select a boot option

    HP-UX Primary Boot: 0/0/0/0.0.0
    Lan Boot
    EFI Shell [Built-in]
    Boot option maintenance menu


    Use ^ and v to change option(s). Use Enter to select an option

2. Select "Add a Boot Option"

EFI Boot Maintenance Manager ver 1.10 [14.62]

Main Menu. Select an Operation


        Boot from a File
        Add a Boot Option
        Delete Boot Option(s)
        Change Boot Order

        Manage BootNext setting
        Set Auto Boot TimeOut

        Select Active Console Output Devices
        Select Active Console Input Devices
        Select Active Standard Error Devices

        Cold Reset
        Exit


    Timeout-->[10] sec SystemGuid-->[505CFFD4-B846-11DD-A401-00306E4AF350]
    SerialNumber-->[VM00847001          ]

3. Select "Removable Media Boo"

EFI Boot Maintenance Manager ver 1.10 [14.62]

Add a Boot Option.  Select a Volume


    IA64_EFI [Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part1,Sig9
    IA64_EFI [Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part3,Sig9
    Removable Media Boot [Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)]
    Load File [Acpi(PNP0A03,0)/Pci(1|0)/Mac(CA65FD9224B9)]
    Load File [EFI Shell [Built-in]]
    Legacy Boot
    Exit

4. Save Boot entry to NVRAM.

    Device Path Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)

    Enter New Description:  Virtual DVD
    New BootOption Data. ASCII/Unicode strings only, with max of 240 characters
    Enter BootOption Data Type [A-Ascii U-Unicode N-No BootOption] :  Ascii
    Enter BootOption Data [Data will be stored as Ascii string]: [Enter]



    Save changes to NVRAM [Y-Yes N-No]: [Y]

5. Exit Add "Add a Boot Option" menu.

EFI Boot Maintenance Manager ver 1.10 [14.62]

Add a Boot Option.  Select a Volume


    IA64_EFI [Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part1,Sig9
    IA64_EFI [Acpi(PNP0A03,0)/Pci(0|0)/Scsi(Pun0,Lun0)/HD(Part3,Sig9
    Removable Media Boot [Acpi(PNP0A03,0)/Pci(2|0)/Scsi(Pun0,Lun0)]
    Load File [Acpi(PNP0A03,0)/Pci(1|0)/Mac(CA65FD9224B9)]
    Load File [EFI Shell [Built-in]]
    Legacy Boot
    Exit

6. Exit the "EFI Boot Maintenance Manager"

EFI Boot Maintenance Manager ver 1.10 [14.62]

Main Menu. Select an Operation


        Boot from a File
        Add a Boot Option
        Delete Boot Option(s)
        Change Boot Order

        Manage BootNext setting
        Set Auto Boot TimeOut

        Select Active Console Output Devices
        Select Active Console Input Devices
        Select Active Standard Error Devices

        Cold Reset
        Exit


    Timeout-->[10] sec SystemGuid-->[505CFFD4-B846-11DD-A401-00306E4AF350]
    SerialNumber-->[VM00847001          ]

7. Select "Virtual DVD"

EFI Boot Manager ver 1.10 [14.62] [Build: Tue Jun 17 09:30:56 2008]

Please select a boot option

    HP-UX Primary Boot: 0/0/0/0.0.0
    Lan Boot
    EFI Shell [Built-in]
    Virtual DVD
    Boot option maintenance menu


    Use ^ and v to change option(s). Use Enter to select an option

8. Boot from the "Virtual DVD" boot entry.

Starting: Virtual DVD

(C) Copyright 1999-2008 Hewlett-Packard Development Company, L.P.
All rights reserved

HP-UX Boot Loader for IPF  --  Revision 2.036

Press Any Key to interrupt Autoboot
\EFI\BOOT\AUTO ==> boot :IINSTALL
Seconds left till autoboot -   0
AUTOBOOTING...> System Memory = 2042 MB
loading section 0
.................................................................................................... (complete)
loading section 1
................. (complete)
loading symbol table
loading ram disk file (:IINSTALLFS).
.....................................................................................................................
 (complete)
Launching :IINSTALL
SIZE: Text:50892K + Data:8336K + BSS:23776K = Total:83006K
Console is on Serial COM1
Booting kernel...

Disabling 8259s
krs_read_mfs: Error 5 opening MFS.
Loaded ACPI revision 2.0 tables.
krs_read_mfs: Error 5 opening MFS.

Memory Class Setup
-------------------------------------------------------------------------
Class     Physmem              Lockmem              Swapmem
-------------------------------------------------------------------------
System :  1943 MB              1943 MB              1943 MB
Kernel :  1943 MB              1943 MB              1943 MB
User   :  1672 MB              1482 MB              1488 MB
-------------------------------------------------------------------------

ktracer is off until requested.
NOTE: nm_devvp_lock not a power of 2 or is outside of allowed range: (16)
NOTE: setting nm_devvp_lock to 32
Installing Socket Protocol families AF_INET and AF_INET6
Kernel EVM initialized
sec_init(): kernel RPC authentication/security initialization.
secgss_init():  kernel RPCSEC_GSS security initialization.
rpc_init(): kernel RPC initialization.
rpcmod_install(): kernel RPC STREAMS module "rpcmod" installation. ...(driver_install)
NOTICE: nfs_client_pv3_install(): nfs3 File system was registered at index 11.
NOTICE: nfs_client_pv4_install(): nfs4 File system was registered at index 12.
iether0: INITIALIZING HP  PCI/PCI-X 1000Base-T  at hardware path 0/0/1/0

    System Console is on the Built-In Serial Interface
afinet_prelink: module installed
Starting the STREAMS daemons-phase 1
    Swap device table:  (start & size given in 512-byte blocks)
        entry 0 - auto-configured on root device; ignored - no room
WARNING: No swap device configured, so dump cannot be defaulted to primary swap.
WARNING: No dump devices are configured.  Dump is disabled.
AF_INET socket/streams output daemon running, pid 31
Create STCP device files
Starting the STREAMS daemons-phase 2
     $Revision: vmunix:    B.11.31_LR FLAVOR=perf nfsauth: lookupname: 2

Memory Information:
    physical page size = 4096 bytes, logical page size = 4096 bytes
    Physical: 2091584 Kbytes, lockable: 1421172 Kbytes, available: 1670652 Kbytes

       * Preparing to execute init...
=======  12/19/08 00:06:06 EST  HP-UX Installation Initialization. (Fri Dec 19
         00:06:06 EST 2008)
         @(#)Ignite-UX Revision C.7.7.98
         @(#)ignite/launch (opt) Revision:
         /branches/IUX_RA0809/ignite/src@75250 Last Modified: 2008-08-25
         11:39:14 -0600 (Mon, 25 Aug 2008)
       * Configuring RAM filesystems...
       * Scanning system for IO devices...
       * Boot device is: 0/0/2/0.0x0.0x0
       * Setting keyboard language.

Apendix[edit]

How to quickly mount an USB DVD | CDROM[edit]

1. Edit /etc/fstab and add a mount entry for the USB device special file.

...
/dev/deviceFileSystem/Usb/MassStorage/dsk/disk@UnknownDevice-1659+9479=00 /usbcd cdfs rr 0 2

2. Create the mount point directory

# mkdir /usbcd

3. Mount the the USB DVD | CDROM

# mount /usbcd


How to swap DVD images online[edit]

If the HPVM Host administrator sets up multiple Virtual FileDVD images for the HPVM guest, the HPVM Virtual Console command eject and insert media should be used to select among the available ISO files assigned to the guest. The eject command changes the Virtual FileDVD into a Virtual NullDVD device.

ISO files can be added to or removed from the file system directory for the Virtual FileDVD by the HPVM Host Administrator. Once this ISO file directory is updated, use an insert command to view all the newly available ISO files in the directory and to choose one to be used for a new Virtual FileDVD. It is not necessary to change the file directory between each eject and insert operation. The guest administrator can change the ISO files provided in the file directory without any HPVM Host Administrator interaction.

Example:

Note that all the process is accomplish from the HPVM guest.


1. Current Virtual FileDVD status.

 # diskinfo /dev/rdsk/c1t7d0
 SCSI describe of /dev/rdsk/c1t7d0:
              vendor: HP
          product id: Virtual FileDVD
                type: CD-ROM
                size: 665600 Kbytes
    bytes per sector: 2048
 #

2. Eject the Virtual FileDVD using the vMP console.

Hit [Control]+[B] to go to Virtual MP console.

 vMP> ej
                 Ejectable Guest Devices
 Num     Hw-path         (Bus,Slot,Tgt)  Gdev    Pstore  Path
 -------------------------------------------------------------------------
 [1]     0/0/1/0.7.0     (0,1,7)         dvd     file    /var/opt/hpvm/ISO-images/hpux/IOTdisc
 
 Enter menu item number or [Q] to Quit: 1
 
 Confirm eject action
      G - Go
      F - Force
 
 Enter menu item or [Q] to Quit: G
 vMP>

3. The Virtual FileDVD becomse a Virtual NullDVD.

 vMP> co
 
 # diskinfo /dev/rdsk/c1t7d0
 SCSI describe of /dev/rdsk/c1t7d0:
              vendor: HP
          product id: Virtual NullDVD
                type: CD-ROM
                size: 0 Kbytes
    bytes per sector: 0
 #

4. Insert next Virtual FileDVD using the vMP console.

 vMP> in
                 Insertable Guest Devices
 Num     Hw-path         (Bus,Slot,Tgt)  Gdev
 --------------------------------------------
 [1]     0/0/1/0.7.0     (0,1,7)         dvd
 
 Enter menu item number or [Q] to Quit: 1
                 Insertable File Backing Stores
 Num     File
 ---------------------
 [1]     0505-FOE.iso
 [2]     0512-FOE.iso
 [3]     0603-FOE-D1.iso
 [4]     0603-FOE-D2.iso
 [5]     IOTdisc
 
 Enter menu item number or [Q] to Quit: 1
 Confirm insertion action
      G - Go
      F - Force
 
 Enter menu item or [Q] to Quit: G
 vMP>

5. The device return to a Virtual FileDVD, but the backing ISO image is selected on step 4. Note the size difference between each Virtual FileDVD

 vMP> co
 
 # diskinfo /dev/rdsk/c1t7d0
 SCSI describe of /dev/rdsk/c1t7d0:
              vendor: HP
          product id: Virtual FileDVD
                type: CD-ROM
                size: 3686144 Kbytes
    bytes per sector: 2048
 #

Reference[edit]

Authors[edit]