====== [HOWTO] Setup Ceph Dasboard ======

^  Documentation  ^|
^Name:| [HOWTO] Setup Ceph Dasboard |
^Description:| Information about Ceph Dasboard |
^Modification date :|19/06/2019|
^Owner:|dodger|
^Notify changes to:|Owner|
^Tags:| ceph, object storage|
^Scalate to:|The_fucking_bofh|



====== Pre-Requirements ======
  * Knowledge of ceph management

====== Official documentation ======
  * [[linux:ceph:official_documentation#dashboard|Go to official documentation page]]

====== Instructions ======
===== Install =====

Install the dashboard rpm in all the ''mgr'' servers:
<code bash>
yum install ceph-mgr-dashboard.noarch
</code>
Salt command:
<code bash>
avmlm-salt-001 /home/bofher/scripts/ceph/avmlp-os # salt "${THESERVER}" pkg.install ceph-mgr-dashboard.noarch
</code>
\\
Enable dashboard:
<code bash>
sudo ceph mgr module enable dashboard
</code>
\\
Generate self-signed certificate:
<code bash>
ceph dashboard create-self-signed-cert
</code>
<WRAP center round important 60%>
I've tried importing ''*.ciberterminal.net'' and it make crash mgr:
<code python>
[19/Jun/2019:17:55:59] ENGINE Error in HTTPServer.tick
Traceback (most recent call last):
  File "/usr/lib/python2.7/site-packages/cherrypy/wsgiserver/wsgiserver2.py", line 1837, in start
    self.tick()
  File "/usr/lib/python2.7/site-packages/cherrypy/wsgiserver/wsgiserver2.py", line 1902, in tick
    s, ssl_env = self.ssl_adapter.wrap(s)
  File "/usr/lib/python2.7/site-packages/cherrypy/wsgiserver/ssl_builtin.py", line 52, in wrap
    keyfile=self.private_key, ssl_version=ssl.PROTOCOL_SSLv23)
  File "/usr/lib64/python2.7/ssl.py", line 934, in wrap_socket
    ciphers=ciphers)
  File "/usr/lib64/python2.7/ssl.py", line 547, in __init__
    self._context.load_cert_chain(certfile, keyfile)
SSLError: [SSL] PEM lib (_ssl.c:2574)
</code>
</WRAP>



check status:
<code bash>
sudo ceph mgr services
</code>

The service is self-managed and auto-balanced!!



===== Create user for dashboard =====
<code bash>
ceph dashboard ac-user-create bofher **** administrator
</code>
[[http://docs.ceph.com/docs/nautilus/mgr/dashboard/#username-and-password|official doc]]

===== Setup GW for dashboard =====
[[http://docs.ceph.com/docs/nautilus/mgr/dashboard/#enabling-the-object-gateway-management-frontend|official doc]]\\

Sample:
<code bash>
radosgw-admin user create --uid=cephdashboard --display-name=cephdashboard --system
</code>

Necessary steps (**sample**):
<code bash>
ceph dashboard set-rgw-api-access-key $(cat access_cephdash)
ceph dashboard set-rgw-api-secret-key $(cat secret_cephdash)
ceph dashboard set-rgw-api-host ceph_endpoint.ciberterminal.net
ceph dashboard set-rgw-api-port 80
ceph mgr module disable dashboard
ceph mgr module enable dashboard
</code>

''access_cephdash'' and ''secret_cephdash'' comes from the ''radosgw-admin'' command
====== Accessing ======
Run:
<code bash>
sudo ceph mgr services
</code>

And you'll obtain the url:
<code bash>
avmlp-osm-001 /etc/ceph # ceph mgr services
{
    "dashboard": "https://avmlp-osm-002.ciberterminal.net:8443/"
}
</code>