vzmigrate(8)                 Virtual Environments                 vzmigrate(8)





NAME
       vzmigrate - utility for virtual environment migration between hardware
       nodes.


SYNOPSIS
       vzmigrate [-r|--remove-area yes|no] [--ssh=ssh_options] [--keep-dst]
       [--online] [-v] destination_address veid


DESCRIPTION
       This utility is used to migrate a VE from one (source) Hardware Node
       (HN) to another (destination) HN. The utility can migrate either
       stopped or running VE. For a stopped VE, simple VE private area
       transfer is performed (rsync(1) is used for file transfer). For running
       VEs, migration may be offline (default) or online.

       This program uses ssh as a transport layer. You will need to put ssh
       public key to destination node and be able to connect to node without
       entering password.


OPTIONS
       -r, --remove-area yes|no
              Whether to remove a VE area on source HN for the successfully
              migrated VE.


       --ssh=options
              Additional options that will be passed to ssh while establishing
              connection to destination HN. You may add options like -c
              blowfish or the like.


       --keep-dst
              Do not clean synced destination VE private area in case of some
              error. It makes sense to use this option on big VE migration to
              avoid syncing VE private area again in case some error (on VE
              stop for example) occurs during first migration attempt.


       --online
              Perform online (zero-downtime) migration: during the migration
              the VE hangs for a while and after the migration it continues
              working as though nothing has happened.


       -v     Verbose mode. Causes vzmigrate to print debugging messages about
              its progress.


EXAMPLES
       Migration of VE #101 to 192.168.1.130 with downtime:
            vzmigrate 192.168.1.130 101

       Online migration of VE#102 to 192.168.1.130:
            vzmigrate --online 192.168.1.130 102


EXIT STATUS
       0 EXIT_OK
              Command completed successfully.

       1 EXIT_USAGE
              Bad command line options.

       2 EXIT_VE_STOPPED
              VE is stopped.

       4 EXIT_CONNECT
              Can't connect to destination (source) HN.

       6 EXIT_COPY
              VE private area copying/moving failed.

       7 EXIT_VE_START
              Can't start or restore destination VE.

       8 EXIT_VE_STOP
              Can't stop or checkpoint source VE.

       9 EXIT_EXISTS
              VE already exists on destination HN.

       10 EXIT_NOTEXIST
              VE does not exists on source HN.

       12 EXIT_IP_INUSE
              You attempt to migrate VE which IP address(es) are already in
              use on the destination node.

       13 EXIT_QUOTA
              Operation with VE quota failed.



SEE ALSO
       rsync(1)


COPYRIGHT
       Copyright (C) 2001-2006, SWsoft. Licensed under GNU GPL.



OpenVZ                            12 Sep 2006                     vzmigrate(8)