hpvmstop — Stop a virtual machine.
-
NAME hpvmstop — Stop a virtual machine. SYNOPSIS hpvmstop { -P vm-name -p vm-number -a } [ -h -g ] [-F] [-q] [-Q] DESCRIPTION The hpvmstop command stops a running virtual machine by simulating the operations performed at the system console on a physical system. The command can perform a hard stop, which functions like a power failure, or a graceful stop, in which the guest operating system receives notification and time to perform cleanup operations before the stop. If the hpvmstop command returns an error message, the specified virtual machine is shut down. The hpvmstop command does not create a crash dump, and automatic restart is not performed. Unintentional use of the hpvmstop command has serious consequences; therefore, the user is prompted to confirm the operation unless the -F (force) option is specified. Only superusers can execute the hpvmstop command. Options The following options can be specified only once. The hpvmstop command recognizes the following command-line option and argument: -P vm-name Specifies the unique name of the virtual machine to be stopped. You must specify the -P , -p, or -a option. -p vm-number Specifies the unique number of the virtual machine to be stopped. The vm_number is displayed by the hpvmstatus command. You must specify the -P , -p, or -a option. -a Stops all active guests. You must specify the -P , -p, or -a option. When you specify the -a option, you must also specify the -F option. -g Performs a graceful shutdown. The guest operating system is notified of an imminent power failure, which gives it time to perform cleanup operations. HP recommends stopping virtual machines using their native operating system commands. The -h and -g options are mutually exclusive. -h Performs a hard stop, which is equivalent to a power failure. This is the default action. The guest operating system receives no notice and thus no opportunity to clean up. In these circumstances, the guest operating system does not create a crash dump, and automatic restart is not performed. HP recommends that you stop virtual machines by using their native operating system commands. NOTE: If neither -g nor -h are specified, a hard stop is performed. The -h and -g options are mutually exclusive. -F Specifies the force option. Omits the confirmation dialog before resetting the virtual machine. This option is intended for use by scripts and other noninteractive applications. -q Makes certain scripted operations less verbose (quiet mode). -Q Quietly performs the command. The default is to prompt for confirmation of the command before performing it. 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. RETURN VALUES The hpvmstop command exits with one of the following values: 0: Successful completion. 1: One or more error conditions occurred. DIAGNOSTICS The hpvmstop command displays error messages on stderr for any of the following conditions: An invalid option is specified. An invalid value is specified for an option. The vm-name or vm-number does not exist, cannot be accessed, is not a virtual machine, or is corrupt. A value was omitted for an argument that requires one, or a value was supplied for an argument that does not take one. The hpvmstop command and Integrity VM software are at different revision levels. The specified guest is a distributed guest. EXAMPLES Perform a graceful shutdown of the virtual machine called compass1: # hpvmstop -P compass1 -g AUTHORS The hpvmstop command was developed by the HP. SEE ALSO On the VM Host: hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvminfo(5), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), hpvmresources(5), hpvmstart(1M), hpvmstatus(1M), p2vassist(1M) On the Integrity VM guest: hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
© Lightnetics 2024