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 3 Creating Virtual Machines

Using the hpvmcreate Command

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

To create a virtual machine, enter the hpvmcreate command in the following format:

hpvmcreate -P vm-name [-F | -s] [-l vm_label] [-B start_attr]
[-O os_type[:version]] [-c number_vcpus] [-e percent | -E cycles]
[-g group[:{admin|oper}]] [-u user[:{admin|oper}]]
[-a rsrc] [-r amount]
[-i {SG | -i SG_pkgname | -i GWLM | -i SG_pkgname,GWLM | -i NONE}]
[-j {0|1}]

Table 3-2 describes the options you can use with the hpvmcreate command.

Table 3-2 Options to the hpvmcreate Command

OptionDescription
-P vm-nameSpecifies the name of the virtual machine. The virtual machine name can be up to eight alphanumeric characters. To provide remote console access to the guest, its name must be a legal UNIX account name (no more than eight characters, where the colon (:) and newline (\) characters are not valid). The -P option is required.
-FSuppresses all resource-conflict checks and associated warning messages (force mode). Use force mode for troubleshooting purposes only.
-sSanity checks the virtual machine configuration and returns warnings or errors, but does not create the virtual machine.
-l vm_labelSpecifies a descriptive label for this virtual machine. The label can contain up to 256 alphanumeric characters, including A-Z, a-z, 0-9, the dash (-), the underscore character (_), and the period (.). To include spaces, the label must be quoted (" ").
-B start_attrSpecifies the startup behavior of the virtual machine. For start_attr, enter one of the following keywords:

auto: Automatically starts the virtual machine when the VM Host is started.

manual: The virtual machine is not started automatically. Use the hpvmstart command to start the virtual machine manually.

-O os_type[:version]Specifies the type and version of the operating system running on the virtual machine. The os_type parameter can have the following (case-insensitive) values:

HPUX

Windows

-c number_vcpusSpecifies the number of vCPUs this virtual machine detects at boot time. If unspecified, the number defaults to one. The maximum number of vCPUs that you can allocate to a virtual machine is the number of physical processors on the VM Host system.
-e percent | -E cyclesSpecifies the virtual machine's CPU entitlement in CPU cycles. To specify the percentage of CPU power, enter the following option:
-e percent
To specify the clock cycles, enter one of the following options:
-E cyclesM (for megahertz)
-E cyclesG (for gigahertz)
-g group[:{admin|oper}]Specifies a group authorization. The specified administrative level (admin or oper) is applied to the specified user group.
-u user[:{admin|oper}]Specifies a user authorization. The specified administrative level (admin or oper) is applied to the specified user.
-a rsrcCreates a virtual device for the virtual machine. To create a virtual storage device, enter the rsrc as:
virtual_devicetype:scsi:[bus,device,target]:phstorage_type:physical_device

For information about forming a virtual storage device specification, see Chapter 6.

To create a virtual network device for a virtual machine, enter the rsrc as:
network:adaptertype:[bus,device,mac-addr]:vswitch:vswitch-name:portid:portnumber

For information about forming a virtual network device specification, see Chapter 7.

-r amountSpecifies the amount of memory available to this virtual machine. Specify the amount as either amountM (for megabtyes) or amountG (for gigabytes).
-i package-name
Specifies whether the virtual machine is managed by Serviceguard or gWLM (or both). The argument is one of the following:
  • SG indicates that the VM Host is a Serviceguard cluster node.

  • SG_pkgname indicates that the VM Host is a Serviceguard package.

  • GWLM indicates that the VM Host is managed by gWLM.

  • NONE indicates there are no external managers.

Do not specify this option. This option is used internally by Integrity VM.
-j [0|1]Specifies whether the virtual machine is a distributed guest (that is, managed by Serviceguard and can be failed over to another cluster member). Do not specify this option. This option is used internally by Integrity VM.

 

Example of Virtual Machine Creation

To create a virtual machine named compass1, enter the following command:

# hpvmcreate -P compass1

This command creates a virtual machine named compass1 with no network access and no allocated storage devices. To view the characteristics of the virtual machine, enter the hpvmstatus command. For example:

# hpvmstatus
[Virtual Machines]
Virtual Machine Name VM #  OS Type State     #VCPUs #Devs #Nets Memory  Runsysid
==================== ===== ======= ========= ====== ===== ===== ======= ========
config1                  1 HPUX    Off            1     5     1  512 MB        0
config2                  2 HPUX    Off            1     7     1    1 GB        0
winguest1                5 WINDOWS On (OS)        1     5     1    1 GB        0
winguest2                9 WINDOWS Off            1     3     1    2 GB        0
compass1                12 UNKNOWN Off            1     0     0    2 GB        0

The compass1 virtual machine has been assigned virtual machine number 12, has been created with an UNKNOWN operating system type, one vCPU, no storage devices, no network devices, and 2 GB of memory. The Runsysid column indicates the VM Host that runs the virtual machine in a Serviceguard cluster. If the virtual machine runs on the local VM Host, or if Serviceguard is not configured, the Runsysid is zero. For more information about running virtual machines under Serviceguard, see “Using HP Serviceguard with Integrity VM”.

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