hpvmstart(1M)

NAME

hpvmstart — Start a virtual machine.

SYNOPSIS

hpvmstart { -P vm-name -p vm-number } [ -F -s ] [-Q]

DESCRIPTION

The hpvmstart command causes the specified virtual machine to start. The virtual machine must exist and be in the off state. The hpvmstart command verifies that the starting virtual machine can be allocated all of the required resources defined by its configuration file. If not, the virtual machine is not started.

Any of the following conditions can prevent the virtual machine from starting:

The server has fewer CPUs than the virtual machine requires.
The server has insufficient free memory.
The server has insufficient CPU resources.
The server has insufficient swap resources.
Another virtual machine is using a specified nonshared backing device.
The server is using a specified backing device.
A specified backing device does not exist.
A specified vswitch is not available. The vswitch must be created using the hpvmnet command before the guests using it can be started.
The specified MAC address is in use.
The specified guest is a distributed guest.

Only superusers can execute the hpvmstart command.

Options

The following options can be specified only once.

The hpvmstart command recognizes the following command-line options and arguments:

-P vm-name

Specifies the name of the virtual machine to be started.

You must specify either the -P or the -p option.

-p vm-number

Specifies the number of the virtual machine to be booted. The vm-number is displayed by the hpvmstatus command.

You must specify either the -P or the -p option.

-F

Forces the virtual machine to skip all the resource checks. No warnings are issued.




	CAUTION: HP does not recommend using the `-F` option because it can result in poor virtual machine performance, oversubscription, or data corruption, or it can cause the virtual machine to hang.

-s

Examines the specified guest configuration and reports any errors or warnings that can prevent it from starting. The guest is not started.

-Q

Quietly performs the command. The default is to prompt for confirmation of the command before executing it.

RETURN VALUES

The command exits with one of the following values:

0: Successful completion.
1: One or more error conditions occurred.

DIAGNOSTICS

The hpvmstart command displays error messages on stderr for any of the following conditions:

An invalid option is specified.
The vm-name or vm-number does not exist, cannot be accessed, is not a virtual machine, or is corrupt.
The virtual machine is in a state other than off and cannot be started. Use the hpvmstop command to stop the virtual machine.
The virtual machine cannot boot at this time because of detected resource complaints.
The hpvmstart command and the Integrity VM software are at different version levels.

EXAMPLES

Start the virtual machine called myguest:

# hpvmstart -P myguest

The following are sample warning messages returned when hpvmstart is executed with various configuration problems on guest myguest:

Warning 1: Guest needs more vcpus than server supports.
Warning 2: Insufficient free memory for guest.
Warning 3: Insufficient swap resource for guest.
Warning 4: Insufficient cpu resource for guest.
Warning 5 on item /dev/rdisk/disk0: Device file '/dev/rdisk/disk0' in use by another guest.
Warning 6 on item /dev/vg00/rswap: Device file '/dev/vg00/rswap' in use by server.
Warning 7 on item /dev/rdisk/disk3 backing device does not exist.
Warning 8 on item /dev/rdisk/disk4: Device file '/dev/rdisk/disk4:' in use by another guest.
Warning 9 on item hostnet: MAC address in use for switch hostnet.
Warning 10 on item offnet: Vswitch offnet is not active.
Warning 11 on item badnet: 'badnet' backing device does not exist.
These problems will prevent HPVM guest myguest from booting.

AUTHORS

The hpvmstart command was developed by HP.

hpvmstart(1M)

Technical documentation

» Table of Contents

» Glossary

» Index