doc/cephfs: improve wording in mount-prerequisites.rst

Signed-off-by: Rishabh Dave <ridave@redhat.com>

diff --git a/doc/cephfs/index.rst b/doc/cephfs/index.rst
index 0b353a8814bfff33ed466bf61545729a9198fd52..fd0b3ddb4c2c715db4550ea86af53765c124b214 100644 (file)
--- a/doc/cephfs/index.rst
+++ b/doc/cephfs/index.rst
@@ -106,7 +106,7 @@ Mounting CephFS
    :hidden:
 
     Client Configuration Settings <client-config-ref>
-    Client authentication <client-auth>
+    Client Authentication <client-auth>
     Mount CephFS: Prerequisites <mount-prerequisites>
     Mount CephFS using Kernel Driver <mount-using-kernel-driver>
     Mount CephFS using FUSE <mount-using-fuse>

diff --git a/doc/cephfs/mount-prerequisites.rst b/doc/cephfs/mount-prerequisites.rst
index 9aa07d5bb4b3f2f2bae13eeac359d48ff41bbf8f..f5a14345589b4968def60ed36a81a31a3db02a50 100644 (file)
--- a/doc/cephfs/mount-prerequisites.rst
+++ b/doc/cephfs/mount-prerequisites.rst
@@ -11,7 +11,7 @@ Which CephFS Client?
 
 The FUSE client is the most accessible and the easiest to upgrade to the
 version of Ceph used by the storage cluster, while the kernel client will
-often gives better performance.
+always gives better performance.
 
 When encountering bugs or performance issues, it is often instructive to
 try using the other client, in order to find out whether the bug was
@@ -21,20 +21,20 @@ General Pre-requisite for Mounting CephFS
 -----------------------------------------
 Before mounting CephFS, ensure that the client host (where CephFS has to be
 mounted and used) has a copy of the Ceph configuration file (i.e.
-``ceph.conf``) and a keyring of the CephX user that has CAPS for a Ceph MDS.
-Both of these files must already be present on the host where the Ceph MON
-resides.
+``ceph.conf``) and a keyring of the CephX user that has permission to access
+the MDS. Both of these files must already be present on the host where the
+Ceph MON resides.
 
 #. Generate a minimal conf file for the client host and place it at a
    standard location::
 
     # on client host
-    mkdir /etc/ceph
+    mkdir -p -m 755 /etc/ceph
     ssh {user}@{mon-host} "sudo ceph config generate-minimal-conf" | sudo tee /etc/ceph/ceph.conf
 
    Alternatively, you may copy the conf file. But the above method generates
    a conf with minimal details which is usually sufficient. For more
-   information, see :ref:`bootstrap-options`.
+   information, see `Client Authentication`_ and :ref:`bootstrap-options`.
 
 #. Ensure that the conf has appropriate permissions::
 
@@ -64,7 +64,7 @@ resides.
 .. note:: There might be few more prerequisites for kernel and FUSE mounts
    individually, please check respective mount documents.
 
-.. _client-auth: ../client-auth
+.. _Client Authentication: ../client-auth
 .. _cephfs-shell: ../cephfs-shell
 .. _using kernel: ../mount-using-kernel-driver
 .. _using FUSE: ../mount-using-fuse