xcat-core/xCAT-client/pods/man1/rmvm.1.pod

=head1 NAME

B<rmvm> - Removes HMC-, IVM-, and zVM-managed partitions or virtual machines.

=head1 SYNOPSIS

I<rmvm [-h| --help]>

I<rmvm [-v| --version]>


I<rmvm [-V| --verbose] noderange [-r] [--service]>

I<rmvm [-p] [-f]>

=head1 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.

=head1 OPTIONS


B<-h>          Display usage message.

B<-v>          Command Version.

B<-V>          Verbose output.

B<-r>          Retain the data object definitions of the nodes.

B<--service>   Remove the service partitions of the specified CECs.

B<-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.  

B<-f>          Force remove the VM, even if the VM appears to be online.  This will bring down a live VM if requested. 

=head1 RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

=head1 EXAMPLES

1. To remove the partition lpar3, enter:

I<rmvm lpar3>

Output is similar to:

lpar3: Success

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

I<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:

I<rmvm cec01,cec02 --service>

Output is similar to:

 cec01: Success
 cec02: Success

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

I<rmvm lpar1 -r>

Output is similar to:

lpar1: Success

5. To remove a zVM virtual machine:

I<rmvm gpok4>

Output is similar to:

 gpok4: Deleting virtual server LNX4... Done

=head1 FILES

/opt/xcat/bin/rmvm


=head1 SEE ALSO

L<mkvm(1)|mkvm.1>, L<lsvm(1)|lsvm.1>, L<chvm(1)|chvm.1>