1 .. _mgr-administrator-guide:
3 ceph-mgr administrator's guide
4 ==============================
9 Usually, you would set up a ceph-mgr daemon using a tool such
10 as ceph-ansible. These instructions describe how to set up
11 a ceph-mgr daemon manually.
13 First, create an authentication key for your daemon::
15 ceph auth get-or-create mgr.$name mon 'allow profile mgr' osd 'allow *' mds 'allow *'
17 Place that key into ``mgr data`` path, which for a cluster "ceph"
18 and mgr $name "foo" would be ``/var/lib/ceph/mgr/ceph-foo``.
20 Start the ceph-mgr daemon::
24 Check that the mgr has come up by looking at the output
25 of ``ceph status``, which should now include a mgr status line::
32 The manager is a new daemon which requires new CephX capabilities. If you upgrade
33 a cluster from an old version of Ceph, or use the default install/deploy tools,
34 your admin client should get this capability automatically. If you use tooling from
35 elsewhere, you may get EACCES errors when invoking certain ceph cluster commands.
36 To fix that, add a "mgr allow \*" stanza to your client's cephx capabilities by
37 `Modifying User Capabilities`_.
42 In general, you should set up a ceph-mgr on each of the hosts
43 running a ceph-mon daemon to achieve the same level of availability.
45 By default, whichever ceph-mgr instance comes up first will be made
46 active by the monitors, and the others will be standbys. There is
47 no requirement for quorum among the ceph-mgr daemons.
49 If the active daemon fails to send a beacon to the monitors for
50 more than ``mon mgr beacon grace`` (default 30s), then it will be replaced
53 If you want to pre-empt failover, you can explicitly mark a ceph-mgr
54 daemon as failed using ``ceph mgr fail <mgr name>``.
59 Use the command ``ceph mgr module ls`` to see which modules are
60 available, and which are currently enabled. Enable or disable modules
61 using the commands ``ceph mgr module enable <module>`` and
62 ``ceph mgr module disable <module>`` respectively.
64 If a module is *enabled* then the active ceph-mgr daemon will load
65 and execute it. In the case of modules that provide a service,
66 such as an HTTP server, the module may publish its address when it
67 is loaded. To see the addresses of such modules, use the command
68 ``ceph mgr services``.
70 Some modules may also implement a special standby mode which runs on
71 standby ceph-mgr daemons as well as the active daemon. This enables
72 modules that provide services to redirect their clients to the active
73 daemon, if the client tries to connect to a standby.
75 Consult the documentation pages for individual manager modules for more
76 information about what functionality each module provides.
78 Here is an example of enabling the ``dashboard`` module:
93 $ ceph mgr module enable dashboard
101 "disabled_modules": [
107 "dashboard": "http://myserver.com:7789/",
108 "restful": "https://myserver.com:8789/"
112 Calling module commands
113 -----------------------
115 Where a module implements command line hooks, the commands will
116 be accessible as ordinary Ceph commands::
118 ceph <command | help>
120 If you would like to see the list of commands handled by the
121 manager (where normal ``ceph help`` would show all mon and mgr commands),
122 you can send a command directly to the manager daemon::
126 Note that it is not necessary to address a particular mgr instance,
127 simply ``mgr`` will pick the current active daemon.
132 OPTION(mgr_module_path, OPT_STR, CEPH_PKGLIBDIR "/mgr") // where to load python modules from
136 :Description: Path to load modules from
138 :Default: ``"<library dir>/mgr"``
142 :Description: Path to load daemon data (such as keyring)
144 :Default: ``"/var/lib/ceph/mgr/$cluster-$id"``
148 :Description: How many seconds between mgr beacons to monitors, and other
153 ``mon mgr beacon grace``
155 :Description: How long after last beacon should a mgr be considered failed
159 .. _Modifying User Capabilities: ../../rados/operations/user-management/#modify-user-capabilities