ceph/doc/mgr/dashboard.rst
Wido den Hollander 0f15e4e76b
doc: Mgr Dashboard docs update
More instructions on how to deploy the dashboard using ceph-mgr

Signed-off-by: Wido den Hollander <wido@42on.com>
2017-06-27 15:42:41 +02:00

33 lines
1.2 KiB
ReStructuredText

dashboard plugin
================
Dashboard plugin visualizes the statistics of the cluster using a web server
hosted by ``ceph-mgr``. Like most web applications, dashboard binds to a host
name and port. Since each ``ceph-mgr`` hosts its own instance of dashboard, we
need to configure them separately. The hostname and port are stored using the
configuration key facility. So we can configure them like::
ceph config-key put mgr/dashboard/$name/server_addr $IP
ceph config-key put mgr/dashboard/$name/server_port $PORT
where ``$name`` is the ID of the ceph-mgr who is hosting this dashboard web app.
These settings can also be configured cluster-wide and not manager specific, eg:
ceph config-key put mgr/dashboard/server_addr $IP
ceph config-key put mgr/dashboard/server_port $PORT
If the port is not configured, the web app will bind to port ``7000``.
Setting the IP to ``::`` makes the dashboard bind to all available IPv4 and IPv6
addresses.
In addition, make sure that the *dashboard* module is enabled in the ceph.conf
configuration file:
[mgr]
mgr_modules = dashboard
Please note that the dashboard will *only* start on the manager which is active
at that moment. Query the Ceph cluster status to see which manager is active.