From 39d1afd830b2c43303e184dbd62fc6e677135164 Mon Sep 17 00:00:00 2001 From: Jos Collin Date: Wed, 4 Jan 2023 18:55:36 +0530 Subject: [PATCH] doc: document the relevance of mds_namespace mount option Fixes: https://tracker.ceph.com/issues/57673 Signed-off-by: Jos Collin (cherry picked from commit 86f8fa19e5ab1defea925e44b07bed11b2b4c7d4) --- doc/cephfs/mount-using-fuse.rst | 3 ++- doc/cephfs/mount-using-kernel-driver.rst | 22 ++++++++++++++++++++++ doc/man/8/mount.ceph.rst | 10 ++++++++++ 3 files changed, 34 insertions(+), 1 deletion(-) diff --git a/doc/cephfs/mount-using-fuse.rst b/doc/cephfs/mount-using-fuse.rst index 27768f5034a93..bd098dc91de32 100644 --- a/doc/cephfs/mount-using-fuse.rst +++ b/doc/cephfs/mount-using-fuse.rst @@ -53,7 +53,8 @@ If you have more than one FS on your Ceph cluster, use the option ceph-fuse --id foo --client_fs mycephfs2 /mnt/mycephfs2 -You may also add a ``client_fs`` setting to your ``ceph.conf`` +You may also add a ``client_fs`` setting to your ``ceph.conf``. Alternatively, the option +``--client_mds_namespace`` is supported for backward compatibility. Unmounting CephFS ================= diff --git a/doc/cephfs/mount-using-kernel-driver.rst b/doc/cephfs/mount-using-kernel-driver.rst index 5bd98dd51a7cb..4aaf480df9787 100644 --- a/doc/cephfs/mount-using-kernel-driver.rst +++ b/doc/cephfs/mount-using-kernel-driver.rst @@ -96,6 +96,28 @@ non-default FS as follows:: mount -t ceph :/ /mnt/mycephfs2 -o name=fs,fs=mycephfs2 +Backward Compatibility +====================== +The old syntax is supported for backward compatibility. + +To mount CephFS with the kernel driver:: + + mkdir /mnt/mycephfs + mount -t ceph :/ /mnt/mycephfs -o name=admin + +The key-value argument right after option ``-o`` is CephX credential; +``name`` is the username of the CephX user we are using to mount CephFS. + +To mount a non-default FS ``cephfs2``, in case the cluster has multiple FSs:: + + mount -t ceph :/ /mnt/mycephfs -o name=admin,fs=cephfs2 + + or + + mount -t ceph :/ /mnt/mycephfs -o name=admin,mds_namespace=cephfs2 + +.. note:: The option ``mds_namespace`` is deprecated. Use ``fs=`` instead when using the old syntax for mounting. + Unmounting CephFS ================= To unmount the Ceph file system, use the ``umount`` command as usual:: diff --git a/doc/man/8/mount.ceph.rst b/doc/man/8/mount.ceph.rst index 1c67a12f8fc45..41cbcaea2962f 100644 --- a/doc/man/8/mount.ceph.rst +++ b/doc/man/8/mount.ceph.rst @@ -110,6 +110,12 @@ Basic them. If an inode contains any stale file locks, read/write on the inode is not allowed until applications release all stale file locks. +:command: `fs=` + Specify the non-default file system to be mounted, when using the old syntax. + +:command: `mds_namespace=` + A synonym of "fs=" (Deprecated). + Advanced -------- :command:`cap_release_safety` @@ -236,6 +242,10 @@ history:: mount.ceph :/ /mnt/mycephfs -o name=fs_username,secretfile=/etc/ceph/fs_username.secret +To mount using the old syntax:: + + mount -t ceph 192.168.0.1:/ /mnt/mycephfs + Availability ============ -- 2.39.5