hpvmremove — Remove an Integrity VM virtual machine.
-
NAME hpvmremove — Remove an Integrity VM virtual machine. SYNOPSIS hpvmremove { -P vm_name -p vm_number } [-F] DESCRIPTION The hpvmremove command deletes a virtual machine's configuration information and frees any resources associated with it. Once the virtual machine has been removed all resources associated with the virtual machine become available for allocation to other virtual machines. Unintentional use of this command has serious consequences; therefore, the user is prompted to confirm this operation unless the -F (force) option is specified. The virtual machine must be in the Off state to be removed: It is an error to remove a running virtual machine. Only superusers can execute the hpvmremove command. Options The following options can be specified only once. The hpvmremove command recognizes the following command-line options and arguments: -P vm_name Specifies the unique name of the virtual machine to be removed. You must specify either the -P or the -p option. -p vm_number Specifies the unique number of the virtual machine to be removed. The vm_number is reported by the hpvmstatus command. You must specify either the -P or the -p option. -F Omits the confirmation dialog before removing the virtual machine. This option is intended for use by scripts and other noninteractive applications (Force mode). -Q Quietly performs the command. The default is to prompt for confirmation of the command before performing it. RETURN VALUES The hpvmremove command exits with one of the following values: 0: Successful completion. 1: One or more error conditions occurred. DIAGNOSTICS The hpvmremove 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 or value is omitted. A value was omitted for an argument that requires one, or a value was supplied for an argument that does not take one. The vm_name or vm_number argument does not exist, cannot be accessed, is not a virtual machine, or is corrupt. The vm_name argument is in some state other than Off. The hpvmremove command and Integrity VM are at different revision levels. EXAMPLES Delete the virtual machine myguest: # hpvmremove -P myguest hpvmremove: Remove the virtual machine myguest? [n/y]: y Delete a virtual machine using its unique identifier using the force option: # hpvmremove -F -p 333 Remove a running guest: # hpvmremove -P hpux1 hpvmremove: The guest is currently running, not able to remove. hpvmremove: Unable to continue. AUTHORS The hpvmremove command was developed by HP. SEE ALSO On the VM Host: hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmresources(5), hpvmsar(1M), hpvmstart(1M), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M), p2vassist(1M) On the Integrity VM guest: hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
© Lightnetics 2024