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

hpvmmigrate(1M)
NAME
hpvmmigrate -- Migrate a virtual machine to a different VM host.
SYNOPSIS
hpvmmigrate { -P vm-name | | -p vm-number } -h dest-hostname-or-IP-addr [-l
vm-label ] -N new-vm-name [-c number-vcpus] [-r ] [ -e percent | | -E cycles ] [-m
storage-resource] [-C] [-b] [-d] [-F] [-q]
hpvmmigrate {-v}
hpvmmigrate {-H}
DESCRIPTION
Thehpvmmigrate command moves an existing virtual machine to the destination VM Host.
In order to move a virtual machine from a source VM Host to a destination VM Host, both VM
Hosts must be configured to allow common access to all of the required resources of the migrating
virtual machine. In addition, the migration of a virtual machine is controlled by a set of secure
remote operations which must be enabled on both systems. After the VM Host makes sure that
the virtual machine has the resources to start on the destination host, it is stopped on the source
VM Host.
If the virtual machine is not set up as a distributed guest (that is, as a Serviceguard package), it
is deleted on the VM Host system after it is successfully started on the destination VM Host.
The resources that are defined in the virtual machine's configuration file are checked to determine
whether the migrated virtual machine could boot on the destination VM Host. If there is a
problem, it is reported and the virtual machine is not migrated. You can specify the -F (force)
option to suppress the errors and force the virtual machine migration to the destination VM
Host. The -F option should be used with caution; some errors can prevent a virtual machine
from booting on the destination VM Host.
Only superusers can execute the hpvmmigrate command.
Options
Only the -m option can be specified more than once.
hpvmmigrate recognizes the following command-line options and arguments:
-P source-vm-name
Specifies the unique name of the virtual machine to be
migrated.
You must specify either the -P option or the -p option.
-p source-vm-number
Specifies the unique number of the virtual machine to be
migrated. The vm_number is reported via the hpvmstatus
command.
You must specify either the -P option or the -p option.
-h dest-hostname-or-IP-addr
Specifies the host name or IP address of the destination
machine to which the virtual machine is being migrated.
The destination machine must be a valid VM Host and
must be accessible by the source VM Host.
-l vm-label
Specifies a descriptive label for the virtual machine, which
can be useful in identifying a specific virtual machine in
the hpvmstatus verbose display. The label can contain
up to 256 alphanumeric characters, including A-Z, a-z, 0-9,
the dash (-), the underscore character (_), and the period
(.). If white space is desired, the label must be quoted ("").
210