vzmigrate(8) Virtual Environments vzmigrate(8)

vzmigrate - utility for virtual environment migration between hardware nodes.

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

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.

-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 blowfishR 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.

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

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.

rsync(1)

Copyright (C) 2001-2006, SWsoft. Licensed under GNU GPL.
12 Sep 2006 OpenVZ