rmvm.1
NAME
rmvm - Removes HMC-, DFM-, IVM-, KVM-, VMware- and zVM-managed partitions or virtual machines.
SYNOPSIS
rmvm [-h| --help]
rmvm [-v| --version]
rmvm [-V| --verbose] noderange [-r] [--service]
For KVM and VMware:
rmvm [-p] [-f] noderange
PPC (using Direct FSP Management) specific:
rmvm [-p] noderange
DESCRIPTION
The rmvm command removes the partitions specified in noderange. If noderange is an CEC, all the partitions associated with that CEC will be removed. Note that removed partitions are automatically removed from the xCAT database. For IVM-managed systems, care must be taken to not remove the VIOS partition, or all the associated partitions will be removed as well.
For DFM-managed (short For Direct FSP Management mode) normal Power machines, only partitions can be removed. No options are needed.
OPTIONS
-h|--help
Display usage message.
-v|--version
Command Version.
-V|--verbose
Verbose output.
-r
Retain the data object definitions of the nodes.
--service
Remove the service partitions of the specified CECs.
-p
KVM: Purge the existence of the VM from persistent storage. This will erase all storage related to the VM in addition to removing it from the active virtualization configuration. Storage devices of “raw” or “block” type are not removed.
PPC: Remove the specified partition on normal Power machine.
-f
Force remove the VM, even if the VM appears to be online. This will bring down a live VM if requested.
RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
EXAMPLES
To remove the HMC-managed partition lpar3, enter:
rmvm lpar3
Output is similar to:
lpar3: Success
To remove all the HMC-managed partitions associated with CEC cec01, enter:
rmvm cec01
Output is similar to:
lpar1: Success
lpar2: Success
lpar3: Success
To remove the HMC-managed service partitions of the specified CEC cec01 and cec02, enter:
rmvm cec01,cec02 --service
Output is similar to:
cec01: Success
cec02: Success
To remove the HMC-managed partition lpar1, but retain its definition, enter:
rmvm lpar1 -r
Output is similar to:
lpar1: Success
To remove a zVM virtual machine:
rmvm gpok4
Output is similar to:
gpok4: Deleting virtual server LNX4... Done
To remove a DFM-managed partition on normal Power machine:
rmvm lpar1
Output is similar to:
lpar1: Done
FILES
/opt/xcat/bin/rmvm
SEE ALSO
mkvm(1)|mkvm.1, lsvm(1)|lsvm.1, chvm(1)|chvm.1