Difference between revisions of "Man/vzmigrate.8"

From OpenVZ Virtuozzo Containers Wiki
< Man
Jump to: navigation, search
(Automated import of articles *** existing text overwritten ***)
(Automated import of articles *** existing text overwritten ***)
Line 89: Line 89:
 
<p>Verbose mode. Causes <b>vzmigrate</b> to print debugging
 
<p>Verbose mode. Causes <b>vzmigrate</b> to print debugging
 
messages about its progress. Multiple <b>-v</b> options
 
messages about its progress. Multiple <b>-v</b> options
increase the verbosity. The maximum is 3.</p></td></tr>
+
increase the verbosity.</p></td></tr>
 
</table>
 
</table>
  
Line 160: Line 160:
 
<p style="margin-left:22%;">Operation with CT quota
 
<p style="margin-left:22%;">Operation with CT quota
 
failed.</p>
 
failed.</p>
 +
 +
<p style="margin-left:11%;"><b>14
 +
EXIT_OVZ_NOT_RUNNING</b></p>
 +
 +
<p style="margin-left:22%;">OpenVZ is not running, or some
 +
required kernel modules are not loaded.</p>
 +
 +
<p style="margin-left:11%;"><b>15 EXIT_APPLY_CONFIG</b></p>
 +
 +
<p style="margin-left:22%;">Unable to set CT name on
 +
destination node.</p>
  
 
== SEE ALSO ==
 
== SEE ALSO ==
Line 168: Line 179:
  
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
2001-2010, Parallels, Inc. Licensed under GNU GPL.</p>
+
2001-2012, Parallels, Inc. Licensed under GNU GPL.</p>

Revision as of 11:03, 3 May 2012

NAME

vzmigrate − migrate a container between two OpenVZ servers

SYNOPSIS

vzmigrate

[-r|--remove-area yes|no] [--ssh=ssh_options] [--rsync=rsync_options] [--keep-dst] [--online] [-v] destination_address CTID

DESCRIPTION

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.

OPTIONS

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

EXAMPLES

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

EXIT STATUS

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.

14 EXIT_OVZ_NOT_RUNNING

OpenVZ is not running, or some required kernel modules are not loaded.

15 EXIT_APPLY_CONFIG

Unable to set CT name on destination node.

SEE ALSO

rsync(1).

COPYRIGHT

Copyright (C) 2001-2012, Parallels, Inc. Licensed under GNU GPL.