From: John Spray Date: Thu, 9 Nov 2017 14:14:44 +0000 (-0500) Subject: doc: update mgr module guide for have_mon_connection X-Git-Tag: v13.0.1~177^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=cbe25074ba07eed9863eef791c3603bb8b0689d9;p=ceph.git doc: update mgr module guide for have_mon_connection Signed-off-by: John Spray --- diff --git a/doc/mgr/plugins.rst b/doc/mgr/plugins.rst index 809e589a74b..5069fa2a078 100644 --- a/doc/mgr/plugins.rst +++ b/doc/mgr/plugins.rst @@ -107,6 +107,22 @@ function. This will result in a circular locking exception. .. automethod:: MgrModule.get_metadata .. automethod:: MgrModule.get_counter +What if the mons are down? +-------------------------- + +The manager daemon gets much of its state (such as the cluster maps) +from the monitor. If the monitor cluster is inaccessible, whichever +manager was active will continue to run, with the latest state it saw +still in memory. + +However, if you are creating a module that shows the cluster state +to the user then you may well not want to mislead them by showing +them that out of date state. + +To check if the manager daemon currently has a connection to +the monitor cluster, use this function: + +.. automethod:: MgrModule.have_mon_connection Sending commands ----------------