doc: how to specify filesystem for cephfs clients

Signed-off-by: John Spray <john.spray@redhat.com>

diff --git a/doc/cephfs/createfs.rst b/doc/cephfs/createfs.rst
index dffa56826aea2888dbdacb8da2142292cfad4a74..005ede86e52981fbaadaab5405b0bdaf5763cdd2 100644 (file)
--- a/doc/cephfs/createfs.rst
+++ b/doc/cephfs/createfs.rst
@@ -52,7 +52,8 @@ an *active* state.  For example, in a single MDS system:
     e5: 1/1/1 up {0=a=up:active}
 
 Once the filesystem is created and the MDS is active, you are ready to mount
-the filesystem:
+the filesystem.  If you have created more than one filesystem, you will
+choose which to use when mounting.
 
        - `Mount CephFS`_
        - `Mount CephFS as FUSE`_

diff --git a/doc/cephfs/fuse.rst b/doc/cephfs/fuse.rst
index ac6867481d23d615451d3d64f97cf437f8d6e258..d8c6cdf46b23b97124ce0b39f826aadbbc1bcb0a 100644 (file)
--- a/doc/cephfs/fuse.rst
+++ b/doc/cephfs/fuse.rst
@@ -1,8 +1,7 @@
 =========================
- Mount Ceph FS as a FUSE
+Mount Ceph FS using FUSE
 =========================
 
-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.
@@ -30,6 +29,10 @@ For example::
        sudo mkdir /home/usernname/cephfs
        sudo ceph-fuse -m 192.168.0.1:6789 /home/username/cephfs
 
+If you have more than one filesystem, specify which one to mount using
+the ``--client_mds_namespace`` command line argument, or add a
+``client_mds_namespace`` setting to your ``ceph.conf``.
+
 See `ceph-fuse`_ for additional details.
 
 To automate mounting ceph-fuse, you may add an entry to the system fstab_.

diff --git a/doc/cephfs/kernel.rst b/doc/cephfs/kernel.rst
index c82ed53471cde666209cff594d525c3408347030..eaaacef3748004149f1737d9bce5158511888a45 100644 (file)
--- a/doc/cephfs/kernel.rst
+++ b/doc/cephfs/kernel.rst
@@ -19,6 +19,9 @@ approach reads the secret from a file. For example::
 
        sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secretfile=/etc/ceph/admin.secret
        
+If you have more than one filesystem, specify which one to mount using
+the ``mds_namespace`` option, e.g. ``-o mds_namespace=myfs``.
+    
 See `User Management`_ for details on cephx.
 
 To unmount the Ceph file system, you may use the ``umount`` command. For example::