vzmigrate(8)                Virtual Private Servers               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 VPSID


DESCRIPTION
       This utility is used to migrate a VPS from one (source) Hardware Node
       (HN) to another (destination) HN. The utility can migrate either
       stopped or running VPS. For stopped VPS, simple VPS private area
       transfer is performed (rsync(1) is used for file transfer). For running
       VPSs 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 VPS on source HN for successfully migrated
              VPS.


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


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


       --online
              Perform online (zero-downtime) migration: during the migration
              the VPS 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 VPS#101 to 192.168.1.130 with downtime:
            vzmigrate 192.168.1.130 101

       Online migration of VPS#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_VPS_STOPPED
              VPS is stopped.

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

       6 EXIT_COPY
              VPS private area copying/moving failed.

       7 EXIT_VPS_START
              Can't start or restore destination VPS.

       8 EXIT_VPS_STOP
              Can't stop or checkpoint source VPS.

       9 EXIT_EXISTS
              VPS already exists on destination HN.

       10 EXIT_NOTEXIST
              VPS does not exists on source HN.

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

       13 EXIT_QUOTA
              Operation with VPS quota failed.



SEE ALSO
       rsync(1)


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



OpenVZ                           17 April 2006                    vzmigrate(8)