doc/glossary: improve "MDS" entry

Improve the entry for "MDS" in doc/glossary.rst by linking to the
"ceph-mds" man page and mentioning the relationship between clients and
MDS (or MDSes).

Signed-off-by: Zac Dover <zac.dover@proton.me>

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 8f1c5659756d1cccc775984b2b8bfd0e1970878d..262b89598c50b2473ff945a5bc1a4656bfb80867 100644 (file)
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -263,11 +263,18 @@
                 Ceph-specific information about devices and its relationship
                 with OSDs.
 
-       :ref:`MDS<cephfs_add_remote_mds>`
+       MDS
                 The Ceph **M**\eta\ **D**\ata **S**\erver daemon. Also referred
                 to as "ceph-mds". The Ceph metadata server daemon must be
                 running in any Ceph cluster that runs the CephFS file system.
-                The MDS stores all filesystem metadata. 
+                The MDS stores all filesystem metadata. :term:`Client`\s work
+                together with either a single MDS or a group of MDSes to
+                maintain a distributed metadata cache that is required by
+                CephFS.
+
+                See :ref:`Deploying Metadata Servers<cephfs_add_remote_mds>`.
+
+                See the :ref:`ceph-mds man page<ceph_mds_man>`.
 
        MGR
                 The Ceph manager software, which collects all the state from

diff --git a/doc/man/8/ceph-mds.rst b/doc/man/8/ceph-mds.rst
index fd8fc800eca31bf05ad85ac44d3d20fa98754a0d..c68d3d110afada111222c9fa6a494909a3e59651 100644 (file)
--- a/doc/man/8/ceph-mds.rst
+++ b/doc/man/8/ceph-mds.rst
@@ -1,5 +1,7 @@
 :orphan:
 
+.. _ceph_mds_man:
+
 =========================================
  ceph-mds -- ceph metadata server daemon
 =========================================