Latest revision |
Your text |
Line 1: |
Line 1: |
| == NAME == | | == NAME == |
| | | |
− | <p style="margin-left:11%; margin-top: 1em">vzmigrate | + | <p style="margin-left:11%; margin-top: 1em">vzmigrate - |
− | − migrate a container between two OpenVZ servers</p>
| + | 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 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 </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 21: |
| 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 43: |
| 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 60: |
| 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 </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>
| |
− | • <b>cpu</b> − ignore cpu capabilities check;
| |
− | <br>
| |
− | • <b>ipv6</b> − 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 78: |
| | | |
| <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 148: |
| <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’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> |