Virsh pool-define-as

External

• RHEL 7 Virtualization Administration Guide - virsh Storage Pool Commands

Internal

• virsh

Overview

Create, but do not start, a storage pool.

virsh pool-define-as <name> <type> --source-dev <source-dev> --target <target>

where:

name

The name of the storage pool.

type

Can be one of: "dir", "disk", "fs", "logical", "iscsi", "scsi", "mpath", "zfs", "sheepdog", "gluster", "netfs", "ceph", "rbd".

When using "pool-create-as" for a pool of type "disk", the existing partitions found on the --source-dev path will be used to populate the disk pool.

--print-xml

If specified, the command will print the XML of the pool object without defining the pool.

--source-path

Specifies the source directory path for directory-backed pools.

--target

The path for mapping of the storage pool into the host file system. For directory-backed pools, it is the same as the directory we're using as source.

Examples

Portion-based storage pool:

virsh pool-define-as main-storage-pool fs --source-dev /dev/sda7 --target /main-storage-pool

The corresponding XML is:

<pool type='fs'>
  <name>main-storage-pool</name>
  <source>
    <device path='/dev/sda7'/>
  </source>
  <target>
    <path>/main-storage-pool</path>
  </target>
</pool>

Directory-based storage pool:

virsh pool-define-as iso-images dir --source-path /iso-images --target /iso-images