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>
(cherry picked from commit 2c6983d8b4e841f2bfbc4e4f82bb0e41e10aec7e)

diff --git a/doc/glossary.rst b/doc/glossary.rst
index 6639054ab23176e6599d7afb29a38a689b4ef6f1..4c27994c8bcb0238a456e419574f16ee04151958 100644 (file)
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -266,11 +266,18 @@
                 store 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 b3fe46fd4a2cb43cd2372a423516898ccc8e62b6..b9328e18e11d78b6ceae754bb5aa3e4bb6ea19d4 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
 =========================================