[libvirt] [PATCH 1/1] Add detail to documentation on storage pools and volumes.

Eric Blake eblake at redhat.com
Thu Feb 2 22:26:28 UTC 2012

On 02/02/2012 03:06 PM, Dave Allan wrote:
> The storage pools page contains details about the capabilities of the
> various pool types, but not an overview of how they are intended to be
> used.  This patch adds some explanation of what pools and volumes can
> be used for and why an administrator might want to use them.
> ---
>  docs/storage.html.in |   82 ++++++++++++++++++++++++++++++++++++++++++++++++--
>  1 files changed, 79 insertions(+), 3 deletions(-)

More documentation is always a good thing!

> +    <p>
> +      Once the pool is started, the files in the NFS share are
> +      reported as volumes, and the storage volumes' paths may be
> +      queried using the libvirt APIs.  The volumes' paths can then be
> +      copied into the section of a VM's XML definition describing the
> +      source storage for the VM's block devices.

This almost makes it sound like we could use domain XML to refer to
pool='p' volume='v' instead of file='/path/to/p/v'.  Someday, I'd really
like to extend the XML to support that, as well as to extend the notion
of storage pools to create a transient pool for any /path/to/file used
by a domain but not otherwise tied to a pool, so that you can query a
domain for all of its storage volumes.  Oh well, that's on my wish list,
and I think your wording is okay as is for now.

> +    <p>
> +      If at this point the value of pools and volumes over traditional
> +      system administration tools is unclear, note that one of the
> +      features of libvirt is its remote protocol, so it's possible to
> +      manage all aspects of a virtual machine's lifecycle as well as
> +      the configuration of the resources required by the VM.  These
> +      operations can be performed on a remote host entirely within the
> +      libvirt API.  In other words, a management application using
> +      libvirt can enable a user to perform all the required tasks for
> +      configuring the host for a VM: allocating resources, running the
> +      VM, shutting it down and deallocating the resources, without
> +      requiring shell access or any other control channel.

That is indeed true!  I love how virt-manager can let me create or
remove files within a pool while connected to a remote connection, but
won't let me browse the remote machine's file system outside of the pool.

ACK, and I'll push this shortly.

Eric Blake   eblake at redhat.com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 620 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20120202/f410aa81/attachment-0001.sig>

More information about the libvir-list mailing list