Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP Integrity Virtual Machines Version 4.0 Installation, Configuration, and Administration > Integrity VM Manpages

hpvmmigrate(1M)

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

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] [ -e percent [:max_percent] | -E cycles[:max_cycles] ] [-r amount] [-m storage-resource [-C] [-t]]... [-b] [-D] [-d] [-s] [-T] [-F] [-q] [-n]

hpvmmigrate {-v}

hpvmmigrate {-H}

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:

  • M (megahertz)

  • 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:

  • M (megabytes)

  • G (gigabytes)

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.

  • The guest is running.

  • Invalid guest configuration.

  • Remote execution error.

  • Guest resource validation error.

  • The version of the hpvmmigrate command is incompatible with the version on the destination VM Host.

EXAMPLES

Display the version number of the hpvmmigrate command.

# hpvmmigrate -v hpvmmigrate: Version B.04.00

Migrate the virtual machine named compass1, to the host abc.def.com.

# hpvmmigrate -P compass1 -h abc.def.com

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
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.