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

  1. To remove the HMC-managed partition lpar3, enter:

rmvm lpar3

Output is similar to:

lpar3: Success
  1. To remove all the HMC-managed partitions associated with CEC cec01, enter:

rmvm cec01

Output is similar to:

lpar1: Success
lpar2: Success
lpar3: Success
  1. 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
  1. To remove the HMC-managed partition lpar1, but retain its definition, enter:

rmvm lpar1 -r

Output is similar to:

lpar1: Success
  1. To remove a zVM virtual machine:

rmvm gpok4

Output is similar to:

gpok4: Deleting virtual server LNX4... Done
  1. 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