diff --git a/xCAT-client/pods/man1/clonevm.1.pod b/xCAT-client/pods/man1/clonevm.1.pod new file mode 100644 index 000000000..e9b36c334 --- /dev/null +++ b/xCAT-client/pods/man1/clonevm.1.pod @@ -0,0 +1,70 @@ +=head1 NAME + +B - Create masters from virtual machines and virtual machines from masters. + +=head1 SYNOPSIS + +I | -b ] -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 + +Cleating 30 VMs from a master named appserver: +I + +=head1 FILES + +/opt/xcat/bin/clonevm + + +=head1 SEE ALSO + +L, L, L, L, L + + + + diff --git a/xCAT-client/pods/man1/mkvm.1.pod b/xCAT-client/pods/man1/mkvm.1.pod index 0ba418bf9..19ea48436 100644 --- a/xCAT-client/pods/man1/mkvm.1.pod +++ b/xCAT-client/pods/man1/mkvm.1.pod @@ -1,6 +1,6 @@ =head1 NAME -B - Creates HMC- and IVM-managed partitions. +B - Creates HMC- and IVM-managed partitions or other virtual machines. =head1 SYNOPSIS