529c185e72
Add doc for glusterfs driver specifying requirements, configuration instructions, and limitations. Change-Id: I5cea3aedcf6da312eb46e4fe47ba26b303d0c676
2.8 KiB
2.8 KiB
GlusterFS driver
GlusterFS driver uses GlusterFS, an open source distributed file system, as the storage backend for serving file shares to Manila clients.
Supported shared filesystems
- NFS (access by IP)
Supported Operations
- Create NFS Share
- Delete NFS Share
- Allow NFS Share access
- Deny NFS Share access
Requirements
- Install glusterfs-server package, version >= 3.5.x, on the storage backend.
- Install glusterfs and glusterfs-fuse package, version >=3.5.x, on the Manila host.
- Establish network connection between the Manila host and the storage backend.
Manila driver configuration setting
The following parameters in the Manila's configuration file need to be set:
- share_driver = manila.share.drivers.glusterfs.GlusterfsShareDriver
- If the backend GlusterFS server runs on the Manila host machine,
-
- glusterfs_target = <glustervolserver>:/<glustervolid>
- And if the backend GlusterFS server runs remotely,
-
- glusterfs_target = <username>@<glustervolserver>:/<glustervolid>
The following configuration parameters are optional:
- glusterfs_mount_point_base = <base path of GlusterFS volume mounted on
-
Manila host>
- glusterfs_path_to_private_key = <path to Manila host's private key file>
- glusterfs_server_password = <password of remote GlusterFS server machine>
Known Restrictions
- The driver does not support network segmented multi-tenancy model instead works over a flat network, where the tenants share a network.
- NFSv3 is the only protocol that can be used to access the shares. This is because the shares are mediated in the backend GlusterFS by the Gluster-NFS server that supports only NFSv3 protocol.
- All Manila shares, which map to subdirectories within a GlusterFS volume, are currently created within a single GlusterFS volume of a GlusterFS storage pool.
The manila.share.drivers.glusterfs Module
manila.share.drivers.glusterfs