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