---
name: "vzcptcheck"
section: "8"
platform: "linux"
package: "vzctl"
version: "4.9.4-6"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/vzcptcheck"
---

# vzcptcheck(8)

show/test CPT properties

## NAME

vzcptcheck - show/test CPT properties

## SYNOPSIS

**vzcptcheck** *property* \[**argument** *...*\]\

**vzcptcheck** **help**

## DESCRIPTION

This low-level utility is used by [**vzmigrate**(8)](/vzmigrate/8.md) 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)](/vzmigrate/8.md).

## LICENSE

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