<pool>

Edit online

Is the root element of a storage pool configuration-XML.

Text content

None.

Selected attributes

type=dir | fs | netfs | logical

where

dir: Specifies a directory. All image files located in this directory are volumes of the storage pool.
fs: Specifies a file system. The file system may be located on a DASD or SCSI disk or on a disk partition. libvirt will mount the file system and make all image files contained in the file system available as volumes of the storage pool.
netfs: Specifies a network file system, such as NFS or CIFS. libvirt will mount the file system and make all image files contained in the file system available as volumes of the storage pool.
logical: Specifies a volume group. Each logical volume of this volume group will be available as volume of the storage pool.

Usage

Configuring storage pools

Parent elements

None.

Child elements

Example

This example configures a storage pool backed by a directory as shown in Figure 1 in Storage pools:

<pool type="dir">
    <name>directoryPool</name>
    <target>
        <path>/var/lib/libvirt/images</path>
    </target>
</pool>

This example configures a storage pool backed by a file system:

<pool type="fs">
    <name>fspool01</name>
    <source>
        <device path="/dev/s356001/fspool"/>
    </source>
    <target>
        <path>/var/lib/libvirt/images/fspool01</path>
    </target>
</pool>

This example configures a storage pool backed by a network file system:

<pool type="netfs">
    <name>nfspool01</name>
    <source>
        <format type="nfs"/>
        <host name="sandbox.example.com"/>
        <dir path="/srv/nfsexport"/>
    </source>
    <target>
        <path>/var/lib/libvirt/images/nfspool01</path>
    </target>
</pool>

This example configures a storage pool backed by a volume group as shown in Figure 2 in Storage pools:

<pool type="logical">
    <name>lvPool01</name>
    <source>
        <name>lvpool01</name>
        <format type="lvm2"/>
    </source>
</pool>