doc: Added instructions for ensuring ceph config file and keyring prior to mounting...

fixes: #3796

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

diff --git a/doc/cephfs/fuse.rst b/doc/cephfs/fuse.rst
index d1b0fa2ffa484684cdcf2b306ffd9fdeddcf91b0..cd6d74edf65b7d0f5ad5269ed0cc8bb1557ea2d5 100644 (file)
--- a/doc/cephfs/fuse.rst
+++ b/doc/cephfs/fuse.rst
@@ -1,15 +1,36 @@
 =========================
  Mount Ceph FS as a FUSE
 =========================
-To mount the Ceph file system as a File System in User Space (FUSE), you may 
-use the ``ceph-fuse`` command. For example:: 
+
+For Ceph version 0.55 and later, ``cephx`` authentication is on by default.
+Before mounting a Ceph File System in User Space (FUSE), ensure that the client
+host has a copy of the Ceph configuration file and a keyring with CAPS for the
+Ceph metadata server.
+
+#. From your client host, copy the Ceph configuration file from the monitor host 
+   to the ``/etc/ceph`` directory. :: 
+
+       sudo mkdir -p /etc/ceph
+       sudo scp {user}@{server-machine}:/etc/ceph/ceph.conf /etc/ceph/ceph.conf
+
+#. From your client host, copy the Ceph keyring from the monitor host to 
+   to the ``/etc/ceph`` directory. :: 
+
+       sudo scp {user}@{server-machine}:/etc/ceph/ceph.keyring /etc/ceph/ceph.keyring
+
+#. Ensure that the Ceph configuration file and the keyring have appropriate 
+   permissions set on your client machine  (e.g., ``chmod 644``).
+
+For additional details on ``cephx`` configuration, see 
+`CEPHX Config Reference`_.
+
+To mount the Ceph file system as a FUSE, you may use the ``ceph-fuse`` command.
+For example::
 
        sudo mkdir /home/usernname/cephfs
        sudo ceph-fuse -m 192.168.0.1:6789 /home/username/cephfs
 
-If ``cephx`` authentication is on, ``ceph-fuse`` will retrieve the name and 
-secret from the key ring automatically.
-
-See `ceph-fuse`_ for details.
+See `ceph-fuse`_ for additional details.
 
-.. _ceph-fuse: ../../man/8/ceph-fuse/
\ No newline at end of file
+.. _ceph-fuse: ../../man/8/ceph-fuse/
+.. _CEPHX Config Reference: ../../rados/configuration/auth-config-ref
\ No newline at end of file