Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
 HP Integrity Virtual Machines Version 4.0 Installation, Configuration, and Administration > Integrity VM Manpages

hpvmresources(5)
» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

NAME

hpvmresources — Specifying virtual storage and virtual network devices.

SYNOPSIS

Virtual resource specification

DESCRIPTION

Use the hpvmcreate, hpvmclone, and hpvmmodify commands to specify storage devices and vswitches for guests. To specify the name of the storage device or vswitch, use the syntax described here.

The resource specification contains the virtual device information and the backing store information, separated by a colon (:). The resource specification can be used to define a virtual storage device or a virtual network device.

Specifying Storage Devices

For storage devices, enter the resource specification in the following format:

devicetype:adaptertype:bus,device,target:storage:device

If you omit any part of the resource specification, you must include the colon (:) character as the field delimiter.

The guest virtual device information consists of the following fields, separated by colons:

  • devicetype (virtual device type):

    • disk

    • dvd

    • tape

    • changer

    • burner

  • adaptertype (virtual device adapter type): scsi or avio_stor.

    NOTE: You can specify avio_stor only with disk or dvd device types.

  • bus, device, target (virtual device hardware address) (optional):

    The virtual device hardware address consists of three fields, separated by commas:

    • bus (the virtual device PCI bus number)

    • device (the virtual device PCI slot number)

    • target (the virtual device SCSI target number)

    If you do not specify the virtual device hardware address, it is generated automatically. If you specify a portion of the virtual device hardware address (for example, just the target), you must include the commas (for example, to specify just target 2, enter ,,2).

The physical device information consists of two fields, separated by a colon:

  • storage (physical storage type)

  • device (physical device)

The physical storage type and device specification can be one of the following:

  • disk. For the physical device, specify a disk device file (for example, /dev/rdisk/disk1).

  • lv. For the physical device, specify the LVM or VxVM character logical device file (for example, /dev/vg01/rlv0l2).

  • file. For the physical device, specify a locally mounted, non-NFS VxFS file (for example, /guestfiles/diskfile1).

  • null. Specify an empty storage unit. Do not specify a world-writable directory such as tmp. (This is useful for removable media, such as DVDs.)

    NOTE: When assigning a null device to a resource on a virtual machine, the file name serves as a placeholder. Therefore, you do not receive an error if the file does not exist. For example, in the following command, if the file XXX.iso does not exist, no error is given.
    # hpvmmodify -P vm1 -a disk:scsi::null"/opt/XXX.iso

  • attach. Specify an attached device, such as a tape device, media changer, or CD/DVD burner.

The physical device names must not contain the following characters: colon (:), semicolon (;), and comma (,).

The following example associates a guest virtual disk device with a physical disk device:

# disk:scsi::0,1,0:disk:/dev/rdisk/disk1

  • The virtual device type is disk.

  • The virtual device adapter type is scsi.

  • The virtual device PCI bus number is 0.

  • The virtual device PCI slot number is 1.

  • The virtual device SCSI target number is 0.

  • The physical storage type is disk.

  • The physical device is /dev/rdisk/disk1.

The following example associates an empty guest virtual DVD with multiple future choices of ISO files:

dvd:scsi::null:/docs

  • The virtual device type is dvd.

  • The virtual device adapter type is scsi.

  • The virtual device hardware address is automatically generated.

  • The physical storage type is null.

  • The physical device is /docs.

The following example specifies a tape device:

tape:scsi::attach:/dev/rscsi/c6t5d0

Specifying Network Devices

To associate a guest virtual network device with a virtual network switch (vswitch), use the following syntax. (Before you can associate the virtual network device to a virtual switch, you must create the vswitch using the hpvmnet command.)

The format of the rsrc parameter for network devices is:

network:adaptertype:bus,device,mac-addr:vswitch:vswitch-name:portid:portnumber

If you omit any portion of the network resource specification, use the colon character (:) as a field delimiter.

The guest virtual network information consists of the following fields, separated by colons:

  • network

  • adaptertype (virtual device adapter type): lan , avio_lan

  • :bus,device,mac-addr (virtual network device hardware address) (optional)

    The virtual network device hardware address consists of three fields, separated by commas:

    • bus (the virtual network device PCI bus number)

    • device (the virtual network device PCI slot number)

    • mac-addr (the virtual network device MAC address, in either of the following formats: 0xaabbcc001122 or aa-bb-cc-00-11-22)

      The MAC address that you enter is checked to verify that it is unique, because the address cannot conflict with any of the VM Host's physical network adapter MAC addresses, and to verify that the proper bits are set. You can specify either the bus and device with the MAC address or the MAC address without the bus and device, or you can omit the entire hardware address. If you do not specify the virtual network device hardware address, or a portion of it, the missing information is generated automatically. If you specify only a portion of the virtual network device hardware address (for example, just the MAC address), include the commas (for example ,,aa-bb-cc-00-11-22).

The virtual switch information consists of the following fields, separated by a colon:

  • vswitch

  • vswitch-name (the name assigned to the virtual network switch)

  • portnumber (the number of the port on the vswitch)

The following example associates a guest virtual network device with a vswitch:

network:avio_lan:0,1,02-02-03-04-05-06:vswitch:net1

  • The guest virtual network device type is network.

  • The virtual adapter type is avio_lan.

  • The virtual PCI bus number is 0.

  • The virtual PCI slot number is 1.

  • The virtual MAC address is 02-02-03-04-05-06.

  • The physical network device type is vswitch.

  • The vswitch name is net1.

AUTHORS

The hpvmresources command was developed by HP.

SEE ALSO

On the VM Host:

hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), hpvmsar(1M), hpvmstart(1M), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M), p2vassist(1M)

On the Integrity VM guest:

hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)



hpvmremove
  		 


hpvmsar  
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.