manila/doc/source/configuration/shared-file-systems/drivers.rst
Goutham Pacha Ravi 26ec5dadb6 [doc] Update CephFS admin guide
There's a new driver mode supported since
Antelope (introduced in Zed) that supports
ceph orchestrator deployed CephFS NFS clusters.
We were missing documentation regarding this.

Also consolidate the admin/configuration references
for this driver; this deletes all the outdated
information in the existing config guide.

Partially-implements: bp use-cephadm-nfs-ganesha
Change-Id: I43952d890629e60465059a5b4242817becb198b1
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2024-03-11 20:38:10 +00:00

2.3 KiB

Share drivers

drivers/generic-driver.rst drivers/cephfs_driver.rst drivers/dell-emc-powerflex-driver.rst drivers/dell-emc-powermax-driver.rst drivers/dell-emc-unity-driver.rst drivers/dell-emc-vnx-driver.rst drivers/dell-emc-powerstore-driver.rst drivers/glusterfs-driver.rst drivers/glusterfs-native-driver.rst drivers/hdfs-native-driver.rst drivers/lvm-driver.rst drivers/zfs-on-linux-driver.rst drivers/zfssa-manila-driver.rst drivers/emc-isilon-driver.rst drivers/hitachi-hnas-driver.rst drivers/hitachi-hsp-driver.rst drivers/hpe-3par-share-driver.rst drivers/huawei-nas-driver.rst drivers/ibm-spectrumscale-driver.rst drivers/infinidat-share-driver.rst drivers/infortrend-nas-driver.rst drivers/maprfs-native-driver.rst drivers/netapp-cluster-mode-driver.rst drivers/quobyte-driver.rst drivers/windows-smb-driver.rst drivers/nexentastor5-driver.rst drivers/purestorage-flashblade-driver.rst

To use different share drivers for the Shared File Systems service, use the parameters described in these sections.

The Shared File Systems service can handle multiple drivers at once. The configuration for all of them follows a common paradigm:

  1. In the configuration file manila.conf, configure the option enabled_backends with the list of names for your configuration.

    For example, if you want to enable two drivers and name them Driver1 and Driver2:

    [Default]
    # ...
    enabled_backends = Driver1 Driver2
  2. Configure a separate section for each driver using these names. You need to define in each section at least the option share_driver and assign it the value of your driver. In this example it is the generic driver:

    [Driver1]
    share_driver = manila.share.drivers.generic.GenericShareDriver
    # ...
    
    [Driver2]
    share_driver = manila.share.drivers.generic.GenericShareDriver
    # ...

The share drivers are included in the Shared File Systems repository.