Using the hpvmcreate Command

To create a virtual machine, enter the hpvmcreate command. Enter the -P option to specify the virtual machine name (up to 256 alphanumeric characters). All other options are optional and may be added to the virtual machine configuration later using the hpvmmodify command.

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

Table 3-4 Options to the hpvmcreate Command

Option Description

-P vm-name Virtual machine name. You must specify a name when you create or modify the virtual machine. You cannot modify this characteristic.

-O os_type Operating system. If you do not specify the operating system type, it is set to UNKNOWN.

-c number_vcpus Virtual CPUs (vCPUs) allocated. If you omit this option when you create the virtual machine, the default is one vCPU.

-e percent[:max_percent]

-E cycles[:max_cycles]

CPU entitlement allocated. If you omit this option when you create the virtual machine, the default is 10%.

-r amount Memory allocated. If you omit this option when you create the virtual machine, the default is 2 GB.

-a rsrc Virtual devices created. If you omit this option when you create the virtual machine, it has access to no network and storage devices.

-l vm_label The label for the virtual machine (an optional text string associated with the virtual machine).

-B start_attribute

The startup behavior of the virtual machine (auto or manual).

-x keyword=parameter

Specifies values for dynamic memory setting associated with the guest, including:

dynamic_memory_control
ram_dyn_type
ram_dyn_min
ram_dyn_max
ram_dyn_target_start

For more information about dynamic memory, see Section .

-F Suppresses all resource conflict checks and associated warning messages (force mode). This option is primarily intended for use by scripts and other noninteractive applications. Note that you will receive no notification of potential resource problems for a virtual machine created with the F option.

-s

Verifies the virtual machine configuration and returns warnings or errors, but does not create the virtual machine.

This option is used to invoke the hpvmcreate command's resource checking for a virtual machine configuration without actually creating the virtual machine. If the -s option is not specified, the virtual machine is created even if resource warnings occur.

-g group[:kind] Group with administrator or operator privileges over the virtual machine. Enter the group name for group, and for kind enter either admin or oper.

-u user[:kind] User with administrator or operator privileges over the virtual machine. Enter the user name for user, and for kind enter either admin or oper.

-ipackage-name

Specifies whether the virtual machine is managed by Serviceguard or gWLM (or both). For the argument, specify the Serviceguard package name, gWLM or both.




	CAUTION: This option is used by Integrity VM software; do not use this option without express instruction by HP.

-j {0 | 1}

Specified whether the virtual machine is a distributed guest (that is, managed by Serviceguard and can be failed over to another cluster member).




	CAUTION: This option is used by Integrity VM software; do not use this option without express instruction by HP.

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 Chapter 11: “Using HP Serviceguard with Integrity VM”.

Using the hpvmcreate Command

Technical documentation

» Table of Contents

» Glossary

» Index

Example of Virtual Machine Creation