Stopping Virtual Machines

To stop a running virtual machine, use the hpvmstop command. You must confirm this command. Table 3-8 describes the options to the hpvmstop command:

Table 3-8 Options to the hpvmstop Command

Option	Description
`-P vm-name`	Specifies the name of the virtual machine.
`-p vm_number`	Specifies the number of the virtual machine. To display the virtual machine number, enter the hpvmstatus command.
`-a`	Specifies all the virtual machines that are running. You must also specify the `-F` option.
`-h`	Performs a hard stop on the virtual machine, similar to a power failure.
`-g`	Performs a graceful shutdown on the virtual machine. This is the default.
`-F`	Forces the command to act without requiring confirmation.
`-Q`	Performs the operation without requiring you to confirm the command.
`-q`	Makes certain scripted operations less verbose (quiet mode).

For example, the following command stops the virtual machine named compass1. The hpvmstatus command shows that the virtual machine is Off.

# hpvmstop -P compass1
hpvmstop: Stop the virtual machine 'compass1'? [n/y]: y

# 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 default action of this command (if you press Enter) is to not perform the command operation. To continue the operation, you must enter y.

To enter the command without requiring a confirmation (for example, in a script), enter the following command:

# hpvmstop -P compass1 -Q
#

To quickly shut down all three virtual machines that are running on the VM Host, enter the following command:

# hpvmstop -a -F
Stopping virtual machine compass1
Stopping virtual machine compass2
Stopping virtual machine compass3




	NOTE: When stopping a guest that is running a heavy I/O load, the hpvmstop command can exhaust its timeout allotted for the stop and exit. When this happens, the SIGKILL has been sent to the running hpvmapp process and will be received by that process when pending I/Os complete. The SIGKILL then terminates the guest. This is expected behavior for an I/O intensive process receiving a SIGKILL. This behavior is not specific to Integrity VM, but is how the signal-delivery mechanism works in the HP-UX operating system.

You can also use the hpvmconsole command to force the virtual machine to shut down. However, after you install the guest operating system, you should use the standard operating system commands and procedures on the guest to shut it down.




	NOTE: It is important to shut down guests gracefully before stopping Integrity VM by specifying the `-g` option with the hpvmstop command. The guest operating system is notified of an imminent power failure, which gives it time to perform cleanup operations. Because behavior of guest shutdown can vary, HP recommends stopping virtual machines using their native operating system commands.

Stopping Virtual Machines

Technical documentation

» Table of Contents

» Glossary

» Index