HP Integrity Virtual Machines Installation, Configuration, and Administration
hpvmmigrate(1M)
NAME
hpvmmigrate -- Migrate a virtual machine to a different VM host.
SYNOPSIS
hpvmmigrate { -P vm-name | -p vm-number } [-h { dest-hostname | dest-IP-addr }] -l
dest-vm-label -N new-vm-name [ -e percent | -E cycles ] [-m storage-resource]
[-C] [-b] [-d] [-F]
hpvmmigrate [-v]
hpvmmigrate [-H]
DESCRIPTION
The hpvmmigrate 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
No options 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 | dest-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 dest-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 ("").
192