2 =========================
3 ceph-mgr dashboard module
4 =========================
13 apt-get install python-cherrypy3
19 dnf install -y python-cherrypy
22 If you had already enabled the module, restart ceph-mgr after installing dependencies to reload the module.
27 Add this to your ceph.conf on nodes where you run ceph-mgr:
32 mgr modules = dashboard
34 If you use any other ceph-mgr modules, make sure they're in the list too.
36 Restart the ceph-mgr daemon after modifying the setting to load the module.
41 Point your browser at port 7000 on the server where ceph-mgr is running.
46 Q: Aargh there's no authentication! Are you crazy?
47 A: At present this module only serves read-only status information, and it is disabled by default. Administrators can make a decision
48 at the point of enabling the module whether they want to limit access to the port, and/or put it behind an authenticating HTTP proxy
49 such as Apache+digest auth.
50 A motivated person could totally build in some authentication stuff though: that would probably only be worth the effort at the point
51 that non-readonly features were added.
53 Q: Aargh there's no SSL! Are you crazy?
54 A: See the authentication question. You can always configure your own SSL gateway on top of this if you need it.
57 A: ceph-mgr is a pure CPython environment, which means that anything gevent based doesn't work (gevent relies on C-level hacks). CherryPy
58 includes a web server based on standard python threads, making it a convenient choice. There are other web frameworks of course.
60 Q: Does this use the `restful` module?
61 A: No. This module loads everything it needs directly via the interfaces available to ceph-mgr modules, and sends it straight to your browser.
63 Q: My browser says "connection refused"
64 A: Check that you have a running ceph-mgr daemon. Look in the ceph-mgr log (/var/log/ceph/ceph-mgr...) for errors loading modules. Check
65 that you have enabled the module (see "Enabling" above)
67 Q: My log contains an error like "ImportError: No module named cherrypy"
68 A: See "Dependencies" above. Make sure you installed a 3.x version of cherrypy, many distros have multiple cherrypy packages.
70 Q: I want to add something to the UI, how do I do it?