vzmigrate - utility for container migration between hardware nodes.
- vzmigrate [-r|--remove-area yes|no]
[--ssh=ssh_options] [--rsync=rsync_options]
[--keep-dst] [--online] [-v] destination_address
CTID
-
This utility is used to migrate a container from one (source) Hardware Node (HN)
to another (destination) HN. The utility can migrate either stopped or running
container. For a stopped container, simple CT private area transfer is
performed (rsync(1) is used for file transfer). For running containers,
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 container area on source HN for the successfully
migrated container. Default is yes.
- --ssh=options
- Additional options that will be passed to ssh while establishing
connection to destination HN.
- --rsync=options
- Additional options that will be passed to rsync(8). You may
add options like -z to enable data compression if you are migrating
over a slow link.
- --keep-dst
- Do not clean synced destination container private area in case of some
error. It makes sense to use this option on big container migration to
avoid syncing container private area again in case some error (on
container stop for example) occurs during first migration attempt.
- --online
- Perform online (zero-downtime) migration: during the migration the
container 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. Multiple -v options increase the verbosity. The
maximum is 3.
Migration of CT #101 to 192.168.1.130 with downtime:
vzmigrate 192.168.1.130 101
Online migration of CT #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
- Container is stopped.
- 4 EXIT_CONNECT
- Can't connect to destination (source) HN.
- 6 EXIT_COPY
- Container private area copying/moving failed.
- 7 EXIT_VE_START
- Can't start or restore destination CT.
- 8 EXIT_VE_STOP
- Can't stop or checkpoint source CT.
- 9 EXIT_EXISTS
- Container already exists on destination HN.
- 10 EXIT_NOTEXIST
- Container does not exists on source HN.
- 12 EXIT_IP_INUSE
- You attempt to migrate CT which IP address(es) are already in use on the
destination node.
- 13 EXIT_QUOTA
- Operation with CT quota failed.
Copyright (C) 2001-2010, Parallels, Inc. Licensed under GNU GPL.