openstack/openstack-manuals
Code Issues Proposed changes

Merge "Fixes for the GlusterFS driver"

Browse Source
This commit is contained in:
Jenkins
2013-05-21 01:21:21 +00:00
committed by Gerrit Code Review
parent 960cab5f47 b5ccfabe17
commit c9920b74ad
1 changed files with 64 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
doc/src/docbkx/openstack-block-storage-admin/drivers/glusterfs-driver.xml
View File

@@ -4,14 +4,24 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0">
<title>GlusterFS Driver</title>
<para>GlusterFS is an open-source scalable distributed filesystem that is able
to grow to petabytes and beyond in size. More information can be found on
<link xlink:href="http://www.gluster.org/">Gluster's homepage</link>.</para>
<para>This driver enables use of GlusterFS in a similar fashion as the NFS driver.
It supports basic volume operations, and like NFS, does not support snapshot/clone.
</para>
<para>To use Cinder with GlusterFS, first set the <literal>volume_driver</literal>
in <literal>cinder.conf</literal>:</para>
<para>GlusterFS is an open-source scalable distributed filesystem
that is able to grow to petabytes and beyond in size. More
information can be found on <link
xlink:href="http://www.gluster.org/">Gluster's
homepage</link>.</para>
<para>This driver enables use of GlusterFS in a similar fashion as
the NFS driver. It supports basic volume operations, and like
NFS, does not support snapshot/clone. </para>
<note>
<para>You must use a Linux kernel of version 3.4 or greater
(or version 2.6.32 or greater in RHEL/CentOS 6.3+) when
working with Gluster-based volumes. See <link
xlink:href="https://bugs.launchpad.net/nova/+bug/1177103"
>Bug 1177103</link> for more information. </para>
</note>
<para>To use Cinder with GlusterFS, first set the
<literal>volume_driver</literal> in
<literal>cinder.conf</literal>:</para>
<programlisting>
volume_driver=cinder.volume.drivers.glusterfs.GlusterfsDriver
</programlisting>
@@ -31,28 +41,65 @@ volume_driver=cinder.volume.drivers.glusterfs.GlusterfsDriver
</thead>
<tbody>
<tr>
<td><para><literal>glusterfs_shares_config</literal></para></td>
<td>
<para>
<literal>glusterfs_shares_config</literal>
</para>
</td>
<td><para>Mandatory</para></td>
<td><para></para></td>
<td><para>File with the list of available gluster shares.</para></td>
<td>
<para>
File with the list of available gluster
shares.
</para>
</td>
</tr>
<tr>
<td><para><literal>glusterfs_mount_point_base</literal></para></td>
<td>
<para>
<literal>glusterfs_mount_point_base</literal>
</para>
</td>
<td><para>Optional</para></td>
<td><para><literal>$state_path/mnt</literal></para></td>
<td><para>Base dir where gluster expected to be mounted.</para></td>
<td>
<para>
<literal>$state_path/mnt</literal>
</para>
</td>
<td>
<para>
Base dir where gluster expected to be mounted.
</para>
</td>
</tr>
<tr>
<td><para><literal>glusterfs_disk_util</literal></para></td>
<td>
<para>
<literal>glusterfs_disk_util</literal>
</para>
</td>
<td><para>Optional</para></td>
<td><para><literal>df</literal></para></td>
<td><para>Use <literal>du</literal> or <literal>df</literal> for free space calculation.</para></td>
<td>
<para>
Use <literal>du</literal> or
<literal>df</literal>
for free space calculation.
</para>
</td>
</tr>
<tr>
<td><para><literal>glusterfs_sparsed_volumes</literal></para></td>
<td>
<para>
<literal>glusterfs_sparsed_volumes</literal>
</para>
</td>
<td><para>Optional</para></td>
<td><para>True</para></td>
<td><para>Create volumes as sparsed files which take no space. If set to
<td>
<para>Create volumes as sparsed files which take
no space. If set to
False, volume is created using
"<command>dd</command>" or a similar
command to create the full-sized file, so