openstack/manila
Code Issues Proposed changes

[doc] Mount options in the ceph native driver

Browse Source 
CephFS native shares will now have the cephfs filesystem name
added to its metadata through `__mount_opts`.

We are also warning and instructing administrators how to prevent
less privileged users to update such metadata.

Signed-off-by: silvacarloss <ces.eduardo98@gmail.com>

Closes-Bug: #2057707
Change-Id: Ica80d80d9a3709814c1ba1c9e5d942ab0c97aec7
This commit is contained in:
silvacarloss 2024-03-20 17:46:36 -03:00 committed by Carlos Eduardo
parent e5e3b10656
commit dd615466ef
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/source/configuration/shared-file-systems/drivers/cephfs_driver.rst
View File

@ -314,6 +314,13 @@ Finally, edit ``cephfs_filesystem_name`` with the name of the Ceph filesystem
If you have more than one Ceph filesystem in the cluster, you need to set this
option.
.. important::
For Native CephFS shares, the backing ``cephfs_filesystem_name`` is visible
to end users through the ``__mount_options`` metadata. Make sure to add
the ``__mount_options`` metadata key to the list of admin only modifiable
metadata keys (``admin_only_metadata``), as explained in the
:ref:`additional configuration options page <manila-common>`.
.. code-block:: ini
@ -536,6 +543,10 @@ Allow a guest access to the share using ``ip`` access type.
Mounting CephFS shares
~~~~~~~~~~~~~~~~~~~~~~
.. note::
The cephfs filesystem name will be available in the ``__mount_options``
share's metadata.
Mounting CephFS native share using FUSE client
----------------------------------------------