doc/cephadm: add mgr.rst

Signed-off-by: Sebastian Wagner <sewagner@redhat.com>
(cherry picked from commit 6773cb01b8f42a4a37b4360d7a032524df39a6f8)

diff --git a/doc/cephadm/index.rst b/doc/cephadm/index.rst
index 394f7b1cc579c01724bf79ca89598b15713eb859..5fe28ba728db4622b7086e34489c8bba8663b706 100644 (file)
--- a/doc/cephadm/index.rst
+++ b/doc/cephadm/index.rst
@@ -28,6 +28,7 @@ versions of Ceph.
     adoption
     host-management
     mon
+    mgr
     osd
     rgw
     mds

diff --git a/doc/cephadm/mgr.rst b/doc/cephadm/mgr.rst
new file mode 100644 (file)
index 0000000..98a5439
--- /dev/null
+++ b/doc/cephadm/mgr.rst
@@ -0,0 +1,37 @@
+.. _mgr-cephadm-mgr:
+
+===========
+MGR Service
+===========
+
+The cephadm MGR service is hosting different modules, like the :ref:`mgr-dashboard`
+and the cephadm manager module.
+
+.. _cephadm-mgr-networks:
+
+Specifying Networks
+-------------------
+
+The MGR service supports binding only to a specific IP within a network.
+
+example spec file (leveraging a default placement):
+
+.. code-block:: yaml
+
+    service_type: mgr
+    networks:
+    - 192.169.142.0/24
+
+Allow co-location of MGR daemons
+================================
+
+In deployment scenarios with just a single host, cephadm still needs
+to deploy at least two MGR daemons. See ``mgr_standby_modules`` in
+the :ref:`mgr-administrator-guide` for further details.
+
+Further Reading
+===============
+
+* :ref:`ceph-manager-daemon`
+* :ref:`cephadm-manually-deploy-mgr`
+

diff --git a/doc/cephadm/troubleshooting.rst b/doc/cephadm/troubleshooting.rst
index 4dfe3e62962218d54e3aed909e5425cdb1657433..951526db83c35d668ef81021e30c2ba394f60f25 100644 (file)
--- a/doc/cephadm/troubleshooting.rst
+++ b/doc/cephadm/troubleshooting.rst
@@ -277,6 +277,7 @@ form the monmap by following these steps:
 
 3. Follow the steps in :ref:`rados-mon-remove-from-unhealthy`
 
+.. _cephadm-manually-deploy-mgr:
 
 Manually deploying a MGR daemon
 -------------------------------