 |
» |
|
|
|
NAMEhpvmmigrate — Migrate a virtual machine to a different
VM host. SYNOPSIShpvmmigrate { -P vm-name -p vm-number } -h dest-hostname-or-IP-addr [-l vm-label ] -N new-vm-name [-c number-vcpus] [ -e percent [:max_percent] | -E cycles[:max_cycles] ] [-r amount] [-m storage-resource [-C]
[-t]]... [-b] [-D] [-d] [-s] [-T] [-F] [-q] [-n]
DESCRIPTION
The hpvmmigrate command moves
an existing virtual machine to the destination VM Host. To move a
virtual machine from a source VM Host to a destination VM Host, both
hosts must be configured to allow common access to all of the required
resources of the migrating virtual machine.
The resources that are defined in the virtual
machine's configuration file are checked to determine whether
the migrated virtual machine can 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 option (force)
to suppress the errors and force the virtual machine migration to
the destination VM Host. | | | |  | CAUTION: Use the -F option with caution, because some
errors can prevent a virtual machine from booting on the destination
VM Host. | | | | |
To prevent the possibility of two virtual machines
using the same resources at the same time, Integrity VM disables the
virtual machine (that is, marked not runnable) on the source VM Host
when it is migrated to the destination VM Host system. | | | | | CAUTION: You can use the hpvmmodify -x command to mark virtual machines runnable, but a migrated virtual
machine should be marked runnable only in rare circumstances and with
great care. Inappropriate use can cause disk corruption. | | | | |
If you specify the —D option, the guest
is deleted from the source VM Host system after it is successfully
migrated to the destination VM Host.
If the virtual machines to be migrated is currently
running and you specify the -d option, the virtual
machine is stopped on the source VM Host before the migration. If
you specify the -b option, the virtual machine boots
on the destination VM Host system after the migration.
Only superusers can execute the hpvmmigrate command. In addition, the migration of a virtual machine is controlled
by a set of secure remote operations that must be enabled on both
systems. See the HP-UX ssh-keygen command.
Options
Only the -m option can be specified
more than once.
The hpvmmigrate command 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 (_),
and the period (.). To specify white space, the label must be quoted
(" "). - -N new-vm-name
Specifies the new name
for the virtual machine being migrated, assuming no virtual machine
with that name already exists. The name can consist of up to 256 alphanumeric
characters, including A-Z, a-z, 0-9, the dash (—), the underscore
(_), and period (.). The virtual machine name cannot start with a
dash (—). If the guest name exists
on the destination VM Host, the guest muse be the same as the guest
on the source (same UUID_ and the guest on the destination must be
disabled. - -c number-vcpus
Specifies the number of
virtual CPUs this virtual machine sees at boot time. - -e percent[:max_percent]
Specifies the percentage
of CPU resources to which each of the guest's virtual CPUs is
entitled. During peak system CPU load, the
entitlement is the guaranteed minimum allocation of CPU resources
for this virtual machine. The percent can be set to an integral value between
0 and 100. If the value specified is less than 5, the virtual machine
is allocated the minimum percentage of 5%. The default is 10%. In addition to the guest calculation, Integrity
VM reserves processing power for essential system functions such as
logging, networking, and file system daemons. The -e and the -E options are mutually exclusive. - -E cycles[:max_cycles]
Specifies the virtual
machine's CPU entitlement in CPU cycles. The cycles are expressed as an integer, followed optionally by one
of these units: G (gigahertz) If no letter is specified, the default unit is megahertz.
The -e and the -E options are mutually exclusive. - -r amount
Specifies the amount of
memory available to this virtual machine. The size is expressed as an integer, optionally followed by one of
these units: If the letter is omitted, the default unit is
megabytes. - -m rsrc-with-absolute-path
Specifies a resource of
a virtual machine for copying, translation, and so on. The resource
is specified as described in hpvmresources(5). For
example: # disk:scsi::bus,device,target:disk:host-device-path |
If the :disk:host-device-path is specified, this path is used to
modify the device.This option can be specified
more than once. For information about specifying storage and network
resources for guests, see hpvmresources(5). - -C
Physically copies the
storage device specified with the -m option to the
destination VM Host during the migration process. If specified before
the -m option, the virtual machine is disabled on
the source VM Host after migration. - -t
Translates the storage
device names specified with the -m option by comparing
WWIDs. If you specify the -t option before the first -m option, the -t option applies to all -m options. The -t option overrides the -T option for storage resources specified with the -m option. To compare WWIDs, the storage resources must
be present and available on both the source and the destination VM
Hosts. - -b
Causes the hpvmmigrate command to boot the target guest automatically after the migration
process is complete. - -D
Deletes the virtual machine
from the source VM host after migrating the virtual machine to the
destination VM Host system. If not specified, the virtual machine
is disabled on the source VM Host after migration. - -d
Causes hpvmmigrate to automatically shut down the target guest before the migration
process, after the resource test in the target host. - -s
Indicates that the migration
should not occur, but the hpvmmigrate command should
check whether or not the migration is possible. Because VM Hosts and
guests are dynamic, a successful -s trial does not
guarantee a subsequent successful migration. - -T
Specifies not to translate
devices. - -F
Forces the migration of
a virtual machine, whether or not there are resource validation errors
(such as resource conflict resource nonexistence, and so forth). Use
the -F option only rarely and with caution. This option ignores
all resource validation errors, including oversubscribing of resources.
It is important to note that these errors can prevent the virtual
machine from booting on the destination VM Host. Any validation errors
are logged in the Integrity VM command log. - -q
Displays fewer informative
messages. Some potential error conditions are still reported. - -n
Quits after starting the
destination of a migration. If not specified, the hpvmmigrate command continues to run and reports the migration status. - -v
Displays the version number
of the hpvmmigrate command. - -H
Displays the usage of
the hpvmmigrate command.
RETURN VALUES
The hpvmmigrate command exits
with one of the following values:
- 0: Successful completion.
- 1: One or more error
conditions occurred.
DIAGNOSTICS
The hpvmmigrate command displays
error messages on stderr for any of the following conditions:
An invalid option is specified. An invalid value is specified
for an option. A value is omitted for
an argument that requires one, or a value is supplied for an argument
that does not take one. The source-vm-name or source-vm-number attribute does not
exist, cannot be accessed, is not a virtual machine, or is corrupt. The hpvmmigrate command and Integrity Virtual Machines are at different revision
levels. The guest already exists
on the destination VM Host. Invalid guest configuration. Guest resource validation
error. The version of the hpvmmigrate command is incompatible with the version on
the destination VM Host.
AUTHORS
The hpvmmigrate command was
developed by HP.
SEE ALSO
On the VM Host:
hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), hpvmresources(5), hpvmsar(1M), hpvmstart(1M), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M), p2vassist(1M)
On the Integrity VM guest:
hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
|
Printable version
