NAME

       vzcptcheck - show/test CPT properties

SYNOPSIS

       vzcptcheck property [argument ...]
       vzcptcheck help

DESCRIPTION

       This  low-level  utility is used by vzmigrate(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.

       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 vzcptcheck on one node to get a property, and on the other  node  to  check  for  the
       property.

       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.

OPTIONS

       vzcptcheck version
       vzcptcheck version num
       To get CPT version number, run vzcptcheck version on the source node.  Then, to  check  if  this  version
       number is supported, run vzcptcheck version num on the destination node.

       vzcptcheck caps
       vzcptcheck caps ctid capnum
       vzcptcheck caps capnum
       To  get CPU capabilities number, run vzcptcheck caps on the destination node. Then, to check if a running
       CT can be live migrated to a node with such a CPU, run vzcptcheck caps ctid capnum on  the  source  node.
       To  check if a suspended container can be migrated (i.e. it can be restored on the destination node), use
       the form without ctid: vzcptcheck caps capnum.

EXIT STATUS

       In showing mode, returns 0 upon success, or 1 in case of an error.

       In testing mode, returns 0 if migration is possible (test passed), 1  in  case  of  an  error,  or  2  if
       migration is not possible (test failed).

EXAMPLES

       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.

          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: $?

       If both tests pass, you should get 0 as a result for both checks.

SEE ALSO

       vzmigrate(8).

LICENSE

       Copyright (C) 2013-2015, Parallels, Inc. Licensed under GNU GPL v2.

OpenVZ                                             21 Apr 2015                                     vzcptcheck(8)