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 Installation, Configuration, and Administration > Chapter 4 Creating and Booting Guests

Creating Guests

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

To create guests, use the hpvmcreate command, specifying the guest characteristics using the command options shown in Table 4–1.

Table 4-1 Options to the hpvmcreate Command

Guest CharacteristicCommand Option
Guest name-P vm_name
Operating system-O os_type
Virtual CPUs-c number_vcpus
CPU entitlement-e percent

-E cycles
Memory-r amount
Virtual network devices-a rsrc
MAC address-a rsrc
Boot path-a rsrc
Startup behavior-B start_attr
Admin account name-u usergroup:[kind]

-g group:[kind]
Application disks-a rsrc

 

Note that these items of information are almost equivalent to the information in the guest planning worksheet provided in “Allocating Resources to Guests” in Chapter 2. You can use the information you recorded in your guest planning chart to create each guest.

Specifying Virtual Devices

To allocate virtual network devices and virtual storage devices to guests, you use the -a option with the rsrc argument. The rsrc argument supplies all the information that the VM Host needs to allocate the device to the guest.

Use the -a option to the hpvmcreate command to specify both virtual storage devices and virtual network devices. If the required resources are not available on the current VM Host system, the guest is created and warning messages describe the resources that are not available. This allows you to create guests for future system configurations.

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

device-type:adapter-type:[hardware-address]:storage-type:device

The device information contains the guest virtual device information (device-type:adapter-type:[hardware-address]) and the physical device information (storage-type:device), separated by a colon (:).

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

  • device-type (virtual device type): disk or dvd

  • adapter-type (virtual device adapter type): scsi

  • [hardware address] (optional). If you do not specify the virtual device hardware address, it will be generated for you (recommended). If specified, the hardware address is formatted as bus:device:target.

    • PCI bus number (bus)

    • PCI slot number (device)

    • SCSI target number (target)

  • storage-type:device

    Table 4–2 lists the physical storage types and associated device specifications. You can specify the following storage types

    Table 4-2 Physical Storage Types

    Storage TypeDeviceExample
    diskDisk or DVD/dev/rdsk/c4t3d2
    lvLVM or VxVM character logical device file/dev/vg01/rlv0l2
    fileLocally-mounted, nonHFS file/guestfiles/diskfile
    nullVxFS directory containing ISO files/docs

     

For examples of using the hpvmcreate command to create guests and allocate various virtual devices, see “Example Guest Creation.”

You can also use the rsrc resource specification to associate a guest virtual network device with a virtual network switch (vswitch). 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 for network devices is:

network:lan:[hardware-address]:vswitch:vswitch-name

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

  • network

  • lan

  • [hardware-address] (optional), formatted as bus,device,mac-addr. If you do not specify the hardware address, or a portion of it, the information is generated for you (recommended). The hardware address consists of the following information:

    • bus (virtual network device PCI bus number)

    • device (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 make sure it does not conflict with any of the VM Host’s physical network adapter MAC addresses and to make sure that the “locally-administered” bit is set, and that the “multicast” and “broadcast” bits are clear.

  • vswitch

    The virtual switch information is formatted as vswitch:vswitch-name (where vswitch-name is the name assigned to the virtual network switch when you create it using the hpvmnet command)

Cloning Guests

Once you have created a guest, you can easily create an identical guest by using the hpvmclone command. Like hpvmcreate and hpvmmodify, the hpvmclone command accepts the -a option for specifying virtual device mapping. This allows you to create new guests with similar characteristics but different virtual resources. For more information about using the hpvmclone command, refer to hpvmclone(1M) .

Example Guest Creation

The example guests described in Chapter 2 can be created as described in this section. To create the first guest in the example configuration (compass1), enter the following command:

# hpvmcreate -Pcompass1 -c1 -r1G \
-a network:lan::vswitch:clan1\
-a network:lan::vswitch:clan2\
-a network:lan:0,1:vswitch:localnet \
-a disk:scsi::lv:/dev/vg01/rlv022\
-a dvd:scsi:0,0,1:null:/dev
#

The guest compass1 has one virtual CPU, 1 GB of memory, and 5% entitlement (the default). It has network access using both vswitches clan1 and clan2, and accesses the logical volume named rlv022.

To create the second guest (compass2), enter the following command:

# hpvmcreate -Pcompass2 -c2 -r3G -e50 -B manual\
 -a disk:scsi:1,0,2:disk:/dev/vg01/rlv023
#

The guest compass2 has one virtual CPU, 3 GB of memory, and 50% entitlement. It is allocated access to the disk device associated with /dev/vg01/rlv023. Network access will be through the local network only.

To create the third guest (compass3), enter the following command:

# hpvmcreate -Pcompass3 -c1 -r2G \
-a disk:scsi::disk:/dev/vg01/rlv023 \
-a network:lan::vswitch:clan1 
HPVM guest compass3 configuration problems:
    Warning 1: Insufficient free memory for guest.
    These problems may prevent HPVM guest compass3 from booting.
hpvmcreate: The creation process is continuing.
#

Note that compass3 was created even though memory resources are insufficient to run this guest on the current VM Host. You can modify the characteristic of a guest by using the hpvmmodify command, as described in “Changing Guest Configurations” in Chapter 5.

If problems exist on the VM Host system when you boot the guest, the guest is not allowed to boot.

You can view information about the guest configuration using the hpvmstatus command:

# hpvmstatus
[Virtual Machines]
Virtual Machine Name VM #  OS Type State    # vCPUs # Devs # Nets Memory
==================== ===== ======= ======== ======= ====== ====== ===========
compass1                15 HPUX    Off            1      2      2        1 GB
compass2                16 HPUX    Off            2      1      0        3 GB
compass3                17 HPUX    Off            1      1      1        2 GB

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