prl_disk_tool

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
OPTIONS
AUTHOR
SEE ALSO
COPYRIGHT

NAME

prl_disk_tool − utility for managing virtual machine and Container disks.

SYNOPSIS

prl_disk_tool [−−help] <COMMAND> [OPTIONS] −−hdd <disk_name> [−−comm <memory_name>]

prl_disk_tool resize −−size <size>[K|M|G|T] [−−resize_partition] −−hdd <disk_name> [−−force] [−−comm <memory_name>]

prl_disk_tool resize −i,−−info [−−units <K|M|G|T>] −−hdd <disk_name> [−−comm <memory_name>]

prl_disk_tool compact −−hdd <disk_name> [−−force] [−−comm <memory_name>]

prl_disk_tool compact −i,−−info −−hdd <disk_name> [−−comm <memory_name>]

prl_disk_tool merge −−hdd <disk_name> [−−external]

prl_disk_tool convert −−hdd <disk_name> <−−expanding|−−plain>

prl_disk_tool −−help

DESCRIPTION

The prl_disk_tool utility is used to manage virtual disks.

COMMANDS

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, xfs.

compact

Removes all empty blocks from expanding virtual disks and reduces their size on your real disk. Compacting is performed by scanning file systems for unused clusters, zeroing and discarding corresponding disk blocks. The supported file systems are NTFS, ext2/ext3/ext4, btrfs, xfs.

merge

Merges all snapshots of the virtual hard disk. By default, merges internal snapshots. Use −−external to merge external snapshots.

convert

Converts the virtual hard disk into another format (plain or expanding).

OPTIONS

Common options:
The following options can be used with the majority of prl_disk_tool commands.
−−hdd
<disk_name>

This option is mandatory and specifies the full path to the disk to be configured or compacted.

−v,−−verbose

Verbose mode: print actions performed and status information (useful with −n).

−n,−−dry−run

Do not actually do anything.

−−comm <memory_name>

This parameter is not currently used.

Disk resizing:
−−size
<size>[K|M|G|T]

Set the virtual hard disk size in KB, MB (by default), GB or TB (this number is rounded up to MB).

−−resize_partition

Resize the last partition and its file system while resizing the disk. The supported file system types are NTFS, ext2/ext3/ext4, btrfs, xfs.

−−force

Forcibly drop the suspended state before resizing the disk (ignored).

−i,−−info

Display the capacity of the specified virtual disk as it is seen from inside the virtual machine or Container, without resizing the disk. The information is shown as a table with the following columns:

Size: <size>M
The current virtual disk capacity.
Minimum: <size>M

The minimum possible capacity of the virtual disk after resizing the disk using the −−resize_partition option.
Minimum: <size>M (without resizing the last partition)

The minimum possible capacity of the virtual disk after resizing the disk without using the −−resize_partition option.

Keep in mind that for an expanding virtual disk the capacity shown from inside the virtual machine and the size the disk occupies on the real physical disk may differ.

−−units <K|M|G|T>

Used with the −−info option, shows the disk size in KB, MB, GB or TB.

Disk compacting:
−−force

Forcibly drop the suspended state before compacting the disk (ignored).

−i,−−info

Show the estimated disk size after the compaction without compacting the disk. The results will be shown as:

Block size: <size>
Block size, in sectors. Each sector is 512 bytes.
Total blocks: <sectors_count>

Total blocks in the disk image (according to the virtual disk image capacity).
Allocated blocks: <sectors_count>

The number of blocks that are actually allocated to and keeping space on your hard drive.
Used blocks: <sectors_count>

The number of blocks actually used in the disk image. This number of blocks will be left after compacting the disk.

Snapshot merge
−−external

Merge external snapshots instead of internal (by default).

Conversion
−−expanding

reduce the size of a plain disk to the actual amount of data stored on it and make it expandable allowing it to grow in size as the amount of data grows.

−−plain

convert an expandable disk to a disk of fixed capacity that cannot grow in size.

Other:
−−help
[−−usage]

Print usage.

AUTHOR

Parallels Holdings, Ltd. and its affiliates. http://www.parallels.com

SEE ALSO

prlctl(8),qemu-img(1),guestfs(3),virt-sparsify(1),virt-resize(1)

COPYRIGHT

Copyright (C) 2005−2015 Parallels Holdings, Ltd. and its affiliates.