fae499cb73
In accord with the OpenStack documentation migration spec [1], this patch pulls over material from the centralized Configuration Reference so that it will not be lost. As indicated in the spec, dynamic generation of this material will be left for later work. [1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html Closes-Bug: #1706181 Depends-On: Ib0fca0c16e14c05307bfc31ae50c65271b7402f1 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Change-Id: I7f3b584ac9907da1f07dedd26324cf4703bc7e6c
93 lines
2.4 KiB
ReStructuredText
93 lines
2.4 KiB
ReStructuredText
================
|
|
GlusterFS driver
|
|
================
|
|
|
|
GlusterFS driver uses GlusterFS, an open source distributed file system,
|
|
as the storage back end for serving file shares to the Shared File
|
|
Systems clients.
|
|
|
|
Supported shared filesystems and operations
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The driver supports NFS shares.
|
|
|
|
The following operations are supported:
|
|
|
|
- Create a share.
|
|
|
|
- Delete a share.
|
|
|
|
- Allow share access.
|
|
|
|
Note the following limitations:
|
|
|
|
- Only IP access type is supported
|
|
|
|
- Only read-write access is supported.
|
|
|
|
- Deny share access.
|
|
|
|
Requirements
|
|
~~~~~~~~~~~~
|
|
|
|
- Install glusterfs-server package, version >= 3.5.x, on the storage
|
|
back end.
|
|
|
|
- Install NFS-Ganesha, version >=2.1, if using NFS-Ganesha as the NFS
|
|
server for the GlusterFS back end.
|
|
|
|
- Install glusterfs and glusterfs-fuse package, version >=3.5.x, on the
|
|
Shared File Systems service host.
|
|
|
|
- Establish network connection between the Shared File Systems service
|
|
host and the storage back end.
|
|
|
|
Shared File Systems service driver configuration setting
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The following parameters in the Shared File Systems service's
|
|
configuration file ``manila.conf`` need to be set:
|
|
|
|
.. code-block:: ini
|
|
|
|
share_driver = manila.share.drivers.glusterfs.GlusterfsShareDriver
|
|
|
|
If the back-end GlusterFS server runs on the Shared File Systems
|
|
service host machine:
|
|
|
|
.. code-block:: ini
|
|
|
|
glusterfs_target = <glustervolserver>:/<glustervolid>
|
|
|
|
If the back-end GlusterFS server runs remotely:
|
|
|
|
.. code-block:: ini
|
|
|
|
glusterfs_target = <username>@<glustervolserver>:/<glustervolid>
|
|
|
|
Known restrictions
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
- The driver does not support network segmented multi-tenancy model,
|
|
but instead works over a flat network, where the tenants share a
|
|
network.
|
|
|
|
- If NFS Ganesha is the NFS server used by the GlusterFS back end, then
|
|
the shares can be accessed by NFSv3 and v4 protocols. However, if
|
|
Gluster NFS is used by the GlusterFS back end, then the shares can
|
|
only be accessed by NFSv3 protocol.
|
|
|
|
- All Shared File Systems service shares, which map to subdirectories
|
|
within a GlusterFS volume, are currently created within a single
|
|
GlusterFS volume of a GlusterFS storage pool.
|
|
|
|
- The driver does not provide read-only access level for shares.
|
|
|
|
Driver options
|
|
~~~~~~~~~~~~~~
|
|
|
|
The following table contains the configuration options specific to the
|
|
share driver.
|
|
|
|
.. include:: ../../tables/manila-glusterfs.inc
|