Virsh vol-create-as

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

Internal

Overview

Creates a storage volume from the given set of command-line arguments, unlike vol-create, which requires an XML file configuration.

virsh vol-create-as --pool <pool-name> --name <volume-name> --capacity <capacity> --format <fomat>

The --format is important, it could be "raw" or "qcow2". However, "qcow2" volumes are usually not required to be created manually, they can be create as part of the virtual machine provisioning with virt-install.

Before creating the volume, see:

Storage Volume Naming Convention

For command line examples, see Examples below.

After creation, the corresponding virtualization host filesystem file should be visible in the directory corresponding to the storage pool (ex. /main-storage-pool/docker-backend-storage.raw or /main-storage-pool/dp.qcow2).

Naming Convention

Storage Volume Naming Convention

Options

--pool

The pool name or pool UUID. The "--pool" label is optional if the pool name is specified as the first argument.

--name

The storage volume name. The "--name" label is optional if the storage volume name is specified as the second argument.

--capacity

The capacity, followed by one of the suffixes 'b', 'k', 'M', 'G', 'T'. The capacity is specified in bytes if there is no suffix. The "--capacity" label is optional if the capacity is specified as the third argument.

--print-xml

If specified, the volume is not created, only the XML of the volume object is printed out.

--allocation

The initial size to be allocated in the volume, as a scaled integer defaulting to bytes.

--format

Acceptable format types: "raw", "bochs", "qcow", "qcow2", "qed", "host_device", and "vmdk". These are, however, only meant for file based storage pools. By default the qcow version that is used is version 3.

--backing-vol

The source backing volume to be used if taking a snapshot of an existing volume.

--backing-vol-format

The format of the snapshot backing volume; raw, bochs, qcow, qcow2, qed, vmdk, host_device.

--prealloc-metadata

Preallocate metadata for qcow2 images that don't support full allocation. This option creates a sparse image file with metadata, resulting in higher performance compared to images with no preallocation and only slightly higher initial disk space usage.

Examples

Create a New Raw Block Storage Volume

virsh vol-create-as --pool main-storage-pool --name test-nfs.raw --capacity 1G --format raw