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 If you have more than one Ceph filesystem in the cluster, you need to set this
option. 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 .. code-block:: ini
@ -536,6 +543,10 @@ Allow a guest access to the share using ``ip`` access type.
Mounting CephFS shares 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 Mounting CephFS native share using FUSE client
---------------------------------------------- ----------------------------------------------