NAME

rmvm - Removes HMC- and IVM-managed partitions.


SYNOPSIS

rmvm [-h| --help]

rmvm [-v| --version]

rmvm [-V| --verbose] noderange [-r] [--service]

rmvm [-p] [-f]


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.


OPTIONS

-h Display usage message.

-v Command Version.

-V Verbose output.

-r Retain the data object definitions of the nodes.

--service Remove the service partitions of the specified CECs.

-p Purge the existence of the VM from persistant storage. This will erase all storage related to the VM in addition to removing it from the active virtualization configuration.

-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 partition lpar3, enter:

rmvm lpar3

Output is similar to:

lpar3: Success

2. To remove all the partitions associated with CEC cec01, enter:

rmvm cec01

Output is similar to:

 lpar1: Success
 lpar2: Success
 lpar3: Success

3. To remove the service partitions of the specified CEC cec01 and cec02, enter:

rmvm cec01,cec02 --service

Output is similar to:

 cec01: Success
 cec02: Success

4. To remove the partition lpar1, but retain its definition, enter:

rmvm lpar1 -r

Output is similar to:

lpar1: Success


FILES

/opt/xcat/bin/rmvm


SEE ALSO

mkvm(1), lsvm(1), chvm(1)