doc/dashboard: don't advise mgr_initial_modules

This setting tends to confuse people, as it's only respected
on the very first startup of the cluster.  Instead, mention
it (with appropriate caveats) on the general mgr admin
page.

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

diff --git a/doc/mgr/administrator.rst b/doc/mgr/administrator.rst
index 4b93c52c8393bc95828647f829aa70a9658ce439..ccffe8072d08e5bc61dbbaa7a0c801c88c2bf385 100644 (file)
--- a/doc/mgr/administrator.rst
+++ b/doc/mgr/administrator.rst
@@ -109,6 +109,18 @@ Here is an example of enabling the :term:`Dashboard` module:
        }
 
 
+The first time the cluster starts, it uses the ``mgr_initial_modules``
+setting to override which modules to enable.  However, this setting
+is ignored through the rest of the lifetime of the cluster: only
+use it for bootstrapping.  For example, before starting your
+monitor daemons for the first time, you might add a section like
+this to your ``ceph.conf``:
+
+::
+
+    [mon]
+        mgr initial modules = dashboard balancer
+
 Calling module commands
 -----------------------
 

diff --git a/doc/mgr/dashboard.rst b/doc/mgr/dashboard.rst
index 857d71b0796c2483a24be95056db592e2c5ce844..7d4dd0847131977d7ca31dfb8921abd0682e4e08 100644 (file)
--- a/doc/mgr/dashboard.rst
+++ b/doc/mgr/dashboard.rst
@@ -79,18 +79,6 @@ Within a running Ceph cluster, the Ceph Manager Dashboard is enabled with::
 
   $ ceph mgr module enable dashboard
 
-This can be automated (e.g. during deployment) by adding the following to
-``ceph.conf``::
-
-  [mon]
-          mgr initial modules = dashboard
-
-Note that ``mgr initial modules`` takes a space-separated list of modules, so
-if you wanted to include other modules in addition to dashboard, just make it
-a list like so::
-
-          mgr initial modules = balancer dashboard
-
 Configuration
 -------------