From: John Spray Date: Tue, 3 Jul 2018 08:46:07 +0000 (+0100) Subject: doc/dashboard: don't advise mgr_initial_modules X-Git-Tag: v14.0.1~962^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=414d94ae4218dff60ecf4c437431834c208c5d80;p=ceph.git 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 --- diff --git a/doc/mgr/administrator.rst b/doc/mgr/administrator.rst index 4b93c52c8393b..ccffe8072d08e 100644 --- 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 857d71b0796c2..7d4dd08471319 100644 --- 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 -------------