Editing Man/vzcptcheck.8

== NAME ==

<p style="margin-left:11%; margin-top: 1em">vzcptcheck
&minus; show/test CPT properties</p>

== SYNOPSIS ==

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p style="margin-top: 1em"><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="35%">

<p style="margin-top: 1em"><i>property</i>
[<b>argument&nbsp;</b><i>...</i>]</p> </td>
<td width="37%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="35%">

<p><b>help</b></p></td>
<td width="37%">
</td></tr>
</table>

== DESCRIPTION ==

<p style="margin-left:11%; margin-top: 1em">This low-level
utility is used by [[Man/vzmigrate.8|<b>vzmigrate</b>(8)]] to check if a
container can be succesfully restored on a destination
system before performing live migration. Currently, it is
able to check CPT version and CPU flags compatibility.</p>

<p style="margin-left:11%; margin-top: 1em">There are two
modes of operation: to show a property and to test a
property. Showing mode is invoked if a property specified
with no arguments; testing mode requires one or many
arguments after a property name. Generally, one runs
<b>vzcptcheck</b> on one node to get a property, and on the
other node to check for the property.</p>

<p style="margin-left:11%; margin-top: 1em">Note that this
utility does not guarantee that migration will succeed even
if all tests are passed. It merely gives a way to prevent
migration which will definitely fail.</p>

== OPTIONS ==

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p style="margin-top: 1em"><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="17%">

<p style="margin-top: 1em"><b>version</b></p></td>
<td width="55%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="17%">

<p><b>version</b> <i>num</i></p></td>
<td width="55%">
</td></tr>
</table>

<p style="margin-left:11%;">To get CPT version number, run
<b>vzcptcheck version</b> on the source node. Then, to check
if this version number is supported, run <b>vzcptcheck
version</b> <i>num</i> on the destination node.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p style="margin-top: 1em"><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="24%">

<p style="margin-top: 1em"><b>caps</b></p></td>
<td width="48%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="15%">

<p><b>vzcptcheck</b></p></td>
<td width="2%"></td>
<td width="24%">

<p><b>caps</b> <i>ctid capnum</i></p></td>
<td width="48%">
</td></tr>
</table>

<p style="margin-left:11%;">To get CPU capabilities number,
run <b>vzcptcheck caps</b> on the destination node. Then, to
check if a CT can be migrated to node with such a CPU, run
<b>vzcptcheck caps</b> <i>ctid capnum</i> on the source
node.</p>

== EXIT STATUS ==

<p style="margin-left:11%; margin-top: 1em">In showing
mode, returns <b>0</b> upon success, or <b>1</b> in case of
an error.</p>

<p style="margin-left:11%; margin-top: 1em">In testing
mode, returns <b>0</b> if migration is possible (test
passed), <b>1</b> in case of an error, or <b>2</b> if
migration is not possible (test failed).</p>

== EXAMPLES ==

<p style="margin-left:11%; margin-top: 1em">To check if a
CT 123 can be migrated to $DEST, run the following commands
on the source node. Note that error checking is omitted for
brevity.</p>

<pre style="margin-left:11%; margin-top: 1em">   VEID=123
   VERSION=$(vzcptcheck version)
   echo Got CPT version: $VERSION
   ssh root@$DEST vzcptcheck version $VERSION
   echo Version check result: $?
   CAPS=$(ssh root@$DEST vzcptcheck caps)
   echo Got caps: $CAPS
   vzcptcheck caps $VEID $CAPS
   echo Caps check result: $?</pre>

<p style="margin-left:11%; margin-top: 1em">If both tests
pass, you should get 0 as a result for both checks.</p>

== SEE ALSO ==

<p style="margin-left:11%; margin-top: 1em">[[Man/vzmigrate.8|<b>vzmigrate</b>(8)]].</p>

== LICENSE ==

<p style="margin-left:11%; margin-top: 1em">Copyright (C)
2013, Parallels, Inc. Licensed under GNU GPL v2.</p>