vzmigrate - utility for virtual environment migration between hardware nodes.
- vzmigrate [-r|--remove-area yes|no]
[--ssh=ssh_options] [--keep-dst] [--online]
[-v] destination_address VPSID
-
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.
- -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.
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
- 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.
Copyright (C) 2001-2006, SWsoft. Licensed under GNU GPL.