View source for Virsh pool-define-as

=External=

* [https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/sect-Managing_guest_virtual_machines_with_virsh-Storage_pool_commands.html#sect-Storage_pool_commands-Creating_defining_and_starting_storage_pools RHEL 7 Virtualization Administration Guide - virsh Storage Pool Commands]

=Internal=

* [[Virsh#Commands|virsh]]

=Overview=

Create, but do not start, a [[Linux_Virtualization_Concepts#Storage_Pool|storage pool]].

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

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|--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-dev====

====--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:

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

The corresponding XML is:

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

Directory-based storage pool:

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