HP Integrity Virtual Machines Installation, Configuration, and Administration
hpvmclone(1M)
NAME
hpvmclone -- Create a new virtual machine that is a copy of an existing virtual machine.
SYNOPSIS
hpvmclone { -P vm_name | -p vm_number } -N clone_name [ -F | -s ] [-l vm_label]
[-B start_attr] -O os_type:version [-c number_vcpus] [ -e percent | -E cycles
] [-r amount] [-S] [-g -group] [-g [+]group[: { admin | oper }]] [-u -user] [-u [+]user[:
{ admin | oper }]] [-a rsrc] [-m rsrc] [-d rsrc] [-b rsrc] [-x keyword=value]
DESCRIPTION
The hpvmclone command creates a copy of an existing virtual machine and its configuration
information. This command copies the configuration files of the existing guest. It does not copy
the actual data and software associated with the guest. The clone_vm_name must not already
exist on this host.
The new virtual machine's configuration information can be modified from the original
configuration file by using command options. If no options are specified, all original parameters
are retained. Note that this will cause resource conflicts if both the original and clone virtual machines
are booted together.
Resources will be checked to determine whether the virtual machine could boot by itself on the
server. Any problems will be reported as WARNINGS. These warnings will not prevent the new
virtual machine from being created.
Only superusers can execute the hpvmclone command.
Options
To print the warnings without creating a new virtual machine, use the -s option.
Because there is no guarantee that other virtual machines would be running at the same time
the new virtual machine would be running, you can use the following command to check a
device for dependents:
hpvmdevmgmt -l entry_name
where entry_name is the device name in the device-management database.
If you omit an option, the associated attribute remains unchanged.
-P vm_name
Specifies the name of the existing virtual machine to be cloned.
You must specify either the -P or the -p option.
-p vm_number
Specifies the number of the existing virtual machine to be cloned. You can obtain the
vm_number using the hpvmstatus command.
You must specify either the -P or the -p option.
-N clone_vm_name
Specifies the name to be assigned to the new virtual machine. The name can be composed of
up to 256 alphanumeric characters, including A-Z, a-z, 0-9, the dash (-), the underscore
character (_), and the period (.).
The virtual machine name must not start with a dash (-). You must specify the -N option.
170