HP Integrity Virtual Machines Installation, Configuration, and Administration Version A.03.50

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 are checked to determine whether the virtual machine can boot by itself on the server.
Any problems are 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 are running at the same time as the
new virtual machine is running, 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.
-e percent
Specifies the percentage of CPU resources to which each
of the new guest's virtual CPUs is entitled. If the
entitlement is not specified with this option or the -E
186