vzmigrate.8
Document Actions
vzmigrate - utility for virtual environment migration between hardware nodes.
Updated: 12 Sep 2006
Index
vzmigrate 192.168.1.130 101
Index
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 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.
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.
