4077e24f85
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@7649 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
71 lines
2.0 KiB
Plaintext
71 lines
2.0 KiB
Plaintext
=head1 NAME
|
|
|
|
B<clonevm> - Create masters from virtual machines and virtual machines from masters.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
I<clonevm noderange [ -t <mastertobemade> | -b <master to base vms upon> ] -d|--detached -f|--force>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
Command to promote a VM's current configuration and storage to a master as well as
|
|
performing the converse operation of creating VMs based on a master.
|
|
|
|
By default, attempting to create a master from a running VM will produce an error.
|
|
The force argument will request that a master be made of the VM anyway.
|
|
|
|
Also, by default a VM that is used to create a master will be rebased as a thin
|
|
clone of that master. If the force argument is used to create a master of a powered
|
|
on vm, this will not be done. Additionally, the detached option can be used to
|
|
explicitly request that a clone not be tethered to a master image, allowing the
|
|
clones to not be tied to the health of a master, at the cost of additional storage.
|
|
|
|
When promoting a VM's current state to master, all rleated virtual disks will be
|
|
copied and merged with any prerequisite images. A master will not be tethered to
|
|
other masters.
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
B<-h|--help> Display usage message.
|
|
|
|
B<-b> The master to base the clones upon
|
|
|
|
B<-t> The target master to copy a single VM's state to
|
|
|
|
B<-d> Explicitly request that the noderange be untethered from any masters.
|
|
|
|
B<-f> Force cloning of a powered on VM. Implies -d if the VM is on.
|
|
|
|
B<-v|--version> Command Version.
|
|
|
|
B<-V|--verbose> Verbose output.
|
|
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0: The command completed successfully.
|
|
|
|
Any other value: An error has occurred.
|
|
|
|
=head1 EXAMPLES
|
|
|
|
Creating a master named appserver from a node called vm1:
|
|
I<clonevm vm1 -t appserver>
|
|
|
|
Cleating 30 VMs from a master named appserver:
|
|
I<clonevm vm1-vm30 -b appserver>
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/bin/clonevm
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<chvm(1)|chvm.1>, L<lsvm(1)|lsvm.1>, L<rmvm(1)|rmvm.1>, L<mkvm(1)|mkvm.1>, vmmaster(5)
|
|
|
|
|
|
|
|
|