Supplementary Tools

This page describes supplementary command-line tools available in Virtuozzo Server.

c2v-convert

The c2v-convert tool converts a Virtuozzo Server 7 system container to a virtual machine.

Find below a list of options you can use when running the c2v-convert command.

1
2
3

c2v-convert [-h] [--version] [-q] [-y] [-v] [-b] [--timeout TIMEOUT]
            [--swap SWAP] [--target-state {keep,start,stop}] [--log LOG]
            [--temp TEMP] [-f FROM_FILE] [ct [ct ...]]

For more information, refer to Converting Containers to Virtual Machines with the c2v-convert Tool.

pcompact

Utility to compact containers by removing unused blocks from their virtual disks. By compacting virtual disks, you can increase free disk space on the physical server.

1

pcompact [-v] [-n] [-s] [-t <timeout>[s|m|h]

pfcache

Memory and IOPS deduplication management utility that enables/disables caching for container directories and files, verifies cache integrity, checks containers for cache errors, and purges the cache if needed.

1

pfcache <command> {<file>|<dir> [<options>]

Subcommands:

pfcache check

Checks for and fixes memory and IOPS deduplication cache errors in the specified container root directory.

1

pfcache check <dir> [--dry-run]

pfcache dump

In addition to the summary provided by stat, shows detailed information on PFCache inodes of a running container. If no options are specified, outputs full information on checksummed peer inodes.

1

pfcache dump <dir> [--csummed{brvbar} -a, --all {brvbar} <csum>] [--column <col> [...]]

pfcache mark, unmark

Enables or disables caching of the specified files, directories or subdirectories in containers.

1
2
3
4

pfcache mark <file>
pfcache mark <dir> [<subdir> [...]] [--recursive]
pfcache unmark <file>
pfcache unmark <dir> [<subdir> [...]] [--recursive]

pfcache purge

Frees up space in the memory and IOPS deduplication cache image. If no options are specified, purges entire cache.

1

pfcache purge <cache_dir> [--unused | --size <size> | --expire <date>]

pfcache stat

Displays a summary of all files in the specified file system which have been accessed recently or are being accessed now.

1

pfcache stat <dir>

Displayed Information

pfcache verify

Verifies the integrity of the specified mounted memory and IOPS deduplication cache and deletes corrupt files.

1

pfcache verify <cache_dir>

Resizing pfcache

The default pfcache size limit is 10 gigabytes (GB). If the required pfcache size exceeds the default limit on the production host, the administrator must increase it. There is no single recommended pfcache size, as it depends on the workloads in containers. Thus, it is only required to expand the pfcache size when there is no space.

To add more space to pfcache:

1. Check space availability on the /vz partition:

   1	# df -h /vz

2. Resize the pfcache ploop device to a greater value by specifying its new full size:

   1	# ploop resize -s 50G /vz/pfcache.hdd/DiskDescriptor.xml

   50G is an example. Specify smaller or greater values depending on the current pfcache size and the amount of space you want to add.

prl_disk_tool

The prl_disk_tool utility is used to manage virtual hard disk drives.

prl_disk_tool compact

Removes all empty blocks from the expanding virtual disk to reduce its size on the physical hard disk. The virtual disk must be formatted to NTFS, ext2/ext3/ext4, btrfs, or xfs.

1
2

prl_disk_tool compact --hdd <disk_path> [--force]
prl_disk_tool compact -i, --info --hdd <disk_path>

prl_disk_tool merge

Merges all snapshots of the virtual hard disk.

1

prl_disk_tool merge --hdd <disk_path>

prl_disk_tool resize

Changes the capacity of the specified virtual disk. During resizing, all data present on the disk volumes are left intact. You can also resize the last partition using the --resize_partition option. The supported file systems are NTFS, ext2/ext3/ext4, btrfs, or xfs.

1
2
3

prl_disk_tool resize --size <size>[K|M|G|T] [--resize_partition]
                     --hdd <disk_path> [--force]
prl_disk_tool resize -i, --info [--units <K|M|G|T>] --hdd <disk_path>

vzpid

This utility prints the ID of the container where the process is running.

1

vzpid <pid> [...]

Multiple process IDs can be specified as arguments.

vzps, vztop

These two utilities can be run on the server just as the standard Linux ps and htop utilities. For information on the ps and htop utilities, consult their man pages. The vzps and vztop utilities provide certain additional functionality related to monitoring separate containers running on the server.

The vzps utility has the following functionality added: the -E <CT_name> command-line switch can be used to show only the processes running inside the container with the specified ID.

The vztop utility has the CTID column added to display the container UUID where a particular process is running (0 stands for the server itself).

vzsplit

This utility is used to generate a sample container configuration file with a set of system resource control parameters.

1

vzsplit [-n <num>] [-f <sample_name>] [-s <swap_size>]

This utility is used for dividing the server into equal parts. It generates a full set of containers system resource control parameters based on the total physical memory of the server it runs on and the number of containers the server shall be able to run even if the given number of containers consume all allowed resources.

Without any option the utility prompts for the desired number of containers and outputs the resulting resource control parameters to the screen.

The resulting sample configuration will be created in the /etc/vz/conf directory. The file name will be ve-<sample_name>.conf-sample. Now you can pass <sample_name> as an argument to the --config option of the prlctl create command. If a sample with this name already exists, the utility will output an error message and will not overwrite the existing configuration.