hpvmmigrate — Migrate a virtual machine to a different VM host.



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

Log in to reply
 

© Lightnetics 2024