Editing Man/vzmigrate.8

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 2: Line 2:
  
 
<p style="margin-left:11%; margin-top: 1em">vzmigrate
 
<p style="margin-left:11%; margin-top: 1em">vzmigrate
−
&minus; migrate a container between two OpenVZ servers</p>
+
&minus; utility for container migration between hardware
 +
nodes.</p>
  
 
== SYNOPSIS ==
 
== SYNOPSIS ==
  
−
<table width="100%" border="0" rules="none" frame="void"
+
<p style="margin-left:11%; margin-top: 1em"><b>vzmigrate</b>
−
      cellspacing="0" cellpadding="0">
+
[<b>-r</b>|<b>--remove-area yes</b>|<b>no</b>]
−
<tr valign="top" align="left">
+
[<b>--ssh=</b><i>ssh_options</i>] <br>
−
<td width="11%"></td>
 
−
<td width="14%">
 
−
 
 
−
<p style="margin-top: 1em"><b>vzmigrate</b></p></td>
 
−
<td width="1%"></td>
 
−
<td width="74%">
 
−
 
 
−
<p style="margin-top: 1em">[<b>-r</b>|<b>--remove-area&nbsp;yes</b>|<b>no</b>]
 
−
[<b>--ssh=</b><i>ssh_options</i>] [<b>--ssh-mux</b>]
 
 
[<b>--rsync=</b><i>rsync_options</i>] [<b>--keep-dst</b>]
 
[<b>--rsync=</b><i>rsync_options</i>] [<b>--keep-dst</b>]
−
[<b>--live</b>] [<b>-c</b>|<b>--compact</b>]
+
[<b>--online</b>] [<b>-v</b>] <i><br>
−
[<b>-s</b>|<b>--snapshot</b>]
+
destination_address CTID</i></p>
−
[<b>--check-only</b>|<b>--dry-run</b>]
 
−
[<b>-f</b>|<b>--nodeps</b>[<b>=</b><i>check</i>[<b>,</b><i>check&nbsp;</i>...]]]
 
−
[<b>-t</b>|<b>--times</b>] [<b>-v</b>]
 
−
<i>destination_address CTID</i></p></td></tr>
 
−
<tr valign="top" align="left">
 
−
<td width="11%"></td>
 
−
<td width="14%">
 
−
 
 
−
<p><b>vzmigrate</b></p></td>
 
−
<td width="1%"></td>
 
−
<td width="74%">
 
−
 
 
−
<p><b>-h</b>|<b>--help</b>|<b>--usage</b></p></td></tr>
 
−
</table>
 
  
 
== DESCRIPTION ==
 
== DESCRIPTION ==
Line 44: Line 22:
 
container, simple CT private area transfer is performed
 
container, simple CT private area transfer is performed
 
(<b>rsync</b>(1) is used for file transfer). For running
 
(<b>rsync</b>(1) is used for file transfer). For running
−
containers, either traditional (with CT stop and start) or
+
containers, migration may be offline (default) or
−
live migration is possible.</p>
+
online.</p>
  
 
<p style="margin-left:11%; margin-top: 1em">This program
 
<p style="margin-left:11%; margin-top: 1em">This program
Line 66: Line 44:
 
will be passed to ssh while establishing connection to
 
will be passed to ssh while establishing connection to
 
destination HN.</p>
 
destination HN.</p>
−
 
−
<p style="margin-left:11%;"><b>--ssh-mux</b></p>
 
−
 
−
<p style="margin-left:22%;">Enable ssh channel
 
−
multiplexing, establishing and reusing a single ssh
 
−
connection to remote server. This speeds up live
 
−
migration.</p>
 
  
 
<p style="margin-left:11%;"><b>--rsync=</b><i>options</i></p>
 
<p style="margin-left:11%;"><b>--rsync=</b><i>options</i></p>
Line 90: Line 61:
 
attempt.</p>
 
attempt.</p>
  
−
<table width="100%" border="0" rules="none" frame="void"
+
<p style="margin-left:11%;"><b>--online</b></p>
−
      cellspacing="0" cellpadding="0">
 
−
<tr valign="top" align="left">
 
−
<td width="11%"></td>
 
−
<td width="9%">
 
−
 
 
−
<p><b>--live</b></p></td>
 
−
<td width="2%"></td>
 
−
<td width="78%">
 
−
 
 
−
<p>Perform live migration: instead of restarting a
 
−
container, checkpoint and restore are used, so there is no
 
−
container downtime or service interruption. Additional steps
 
−
are performed to minimize the time when a container is in
 
−
suspended state. Option <b>--online</b> can be used as a
 
−
backward-compatible alias.</p></td></tr>
 
−
</table>
 
−
 
 
−
<p style="margin-left:11%;"><b>-c</b>, <b>--compact</b></p>
 
−
 
 
−
<p style="margin-left:22%;">Compact a container image (i.e.
 
−
run <b>vzctl compact</b>) before migration. Works for ploop
 
−
only, ignored otherwise.</p>
 
−
 
 
−
<p style="margin-left:11%;"><b>-s</b>,
 
−
<b>--snapshot</b></p>
 
−
 
 
−
<p style="margin-left:22%;">Create a container snapshot
 
−
(i.e. run <b>vzctl snapshot</b>) before migration. Works for
 
−
ploop only, ignored otherwise.</p>
 
−
 
 
−
<p style="margin-left:11%;"><b>--check-only</b>,
 
−
<b>--dry-run</b></p>
 
−
 
 
−
<p style="margin-left:22%;">Do not perform actual
 
−
migration, stop after preliminary checks. This is used to
 
−
check if a CT can possibly be migrated. Combine with
 
−
<b>--live</b> to enable more checks for live migration
 
−
case.</p>
 
−
 
 
−
<p style="margin-left:11%;"><b>-f</b>|<b>--nodeps</b>[<b>=</b><i>check</i>[<b>,</b><i>check&nbsp;</i>...]]</p>
 
−
 
 
−
<p style="margin-left:22%;">Continue migration, ignoring
 
−
some or all preliminary check failures. Particular checks
 
−
can be ignored by providing an argument to <b>--nodeps</b>
 
−
option. The following options can be used (comma-separated):
 
−
<br>
 
−
&bull; <b>cpu</b> &minus; ignore cpu capabilities check;
 
−
<br>
 
−
&bull; <b>ipv6</b> &minus; ignore ipv6 module check.</p>
 
−
 
 
−
<p style="margin-left:11%;"><b>-t</b>, <b>--times</b></p>
 
  
−
<p style="margin-left:22%;">At the end of live migration,
+
<p style="margin-left:22%;">Perform online (zero-downtime)
−
output various timings for migration stages that affect
+
migration: during the migration the container hangs for a
−
total suspended CT time. Note that it only makes sense with
+
while and after the migration it continues working as though
−
<b>--live</b>.</p>
+
nothing has happened.</p>
  
 
<table width="100%" border="0" rules="none" frame="void"
 
<table width="100%" border="0" rules="none" frame="void"
Line 159: Line 79:
  
 
<p>Verbose mode. Causes <b>vzmigrate</b> to print debugging
 
<p>Verbose mode. Causes <b>vzmigrate</b> to print debugging
−
messages about its progress. Note that <b>-v</b>
+
messages about its progress. Multiple <b>-v</b> options
−
automatically implies <b>-t</b>. Multiple <b>-v</b> options
+
increase the verbosity. The maximum is 3.</p></td></tr>
−
increase the verbosity.</p></td></tr>
 
 
</table>
 
</table>
−
 
−
<p style="margin-left:11%;"><b>-h</b>|<b>--help</b>|<b>--usage</b></p>
 
−
 
−
<p style="margin-left:22%;">Print usage info and exit.</p>
 
  
 
== EXAMPLES ==
 
== EXAMPLES ==
  
 
<p style="margin-left:11%; margin-top: 1em">Migration of CT
 
<p style="margin-left:11%; margin-top: 1em">Migration of CT
−
101 to <b>192.168.1.130</b> with downtime:</p>
+
#101 to <i>192.168.1.130</i> with downtime: <br>
−
 
+
vzmigrate 192.168.1.130 101</p>
−
<pre style="margin-left:11%; margin-top: 1em">  vzmigrate 192.168.1.130 101</pre>
 
  
 
<p style="margin-left:11%; margin-top: 1em">Online
 
<p style="margin-left:11%; margin-top: 1em">Online
−
migration of CT 102 to <b>192.168.1.130</b>:</p>
+
migration of CT #102 to <i>192.168.1.130</i>: <br>
−
 
+
vzmigrate --online 192.168.1.130 102</p>
−
<pre style="margin-left:11%; margin-top: 1em">  vzmigrate --live 192.168.1.130 102</pre>
 
  
 
== EXIT STATUS ==
 
== EXIT STATUS ==
Line 236: Line 149:
 
<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>
 
−
 
−
<p style="margin-left:11%;"><b>16 EXIT_PLOOP_UNSUP</b></p>
 
−
 
−
<p style="margin-left:22%;">Ploop is not supported by
 
−
destination node.</p>
 
−
 
−
<p style="margin-left:11%;"><b>17
 
−
EXIT_UNSUP_CPT_VER</b></p>
 
−
 
−
<p style="margin-left:22%;">CPT version incompatibility
 
−
with the destination node.</p>
 
−
 
−
<p style="margin-left:11%;"><b>18 EXIT_UNSUP_CPU</b></p>
 
−
 
−
<p style="margin-left:22%;">Destination node CPU
 
−
incompatibility.</p>
 
−
 
−
<p style="margin-left:11%;"><b>19
 
−
EXIT_CANT_READ_REMOTE_CONFIG</b></p>
 
−
 
−
<p style="margin-left:22%;">Unable to read remote
 
−
vz.conf.</p>
 
−
 
−
<p style="margin-left:11%;"><b>20 EXIT_LOCKED</b></p>
 
−
 
−
<p style="margin-left:22%;">Can&rsquo;t lock container
 
−
(already locked).</p>
 
  
 
== SEE ALSO ==
 
== SEE ALSO ==
  
−
<p style="margin-left:11%; margin-top: 1em"><b>rsync</b>(1),
+
<p style="margin-left:11%; margin-top: 1em"><b>rsync</b>(1).</p>
−
[[Man/vzcptcheck.8|<b>vzcptcheck</b>(8)]].</p>
 
  
 
== COPYRIGHT ==
 
== COPYRIGHT ==
  
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
 
<p style="margin-left:11%; margin-top: 1em">Copyright (C)
−
2001-2013, Parallels, Inc. Licensed under GNU GPL.</p>
+
2001-2010, Parallels, Inc. Licensed under GNU GPL.</p>

Please note that all contributions to OpenVZ Virtuozzo Containers Wiki may be edited, altered, or removed by other contributors. If you don't want your writing to be edited mercilessly, then don't submit it here.
 If you are going to add external links to an article, read the External links policy first!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)
Retrieved from "https://wiki.openvz.org/Man/vzmigrate.8"