From: John Spray Date: Tue, 9 Jan 2018 22:23:33 +0000 (+0000) Subject: doc: update mgr/dashboard doc about standbys X-Git-Tag: v12.2.3~226^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F19880%2Fhead;p=ceph.git doc: update mgr/dashboard doc about standbys Signed-off-by: John Spray (cherry picked from commit fa14812cbb584b61cb2ce687ae4c14225eecd9fe) --- diff --git a/doc/mgr/dashboard.rst b/doc/mgr/dashboard.rst index 4c2116b133ec..63526041c919 100644 --- a/doc/mgr/dashboard.rst +++ b/doc/mgr/dashboard.rst @@ -39,21 +39,17 @@ If the port is not configured, the web app will bind to port ``7000``. If the address it not configured, the web app will bind to ``::``, which corresponds to all available IPv4 and IPv6 addresses. -You can configure a prefix for all URLs:: +Reverse proxies +--------------- - ceph config-key set mgr/dashboard/url_prefix $PREFIX +If you are accessing the dashboard via a reverse proxy configuration, +you may wish to service it under a URL prefix. To get the dashboard +to use hyperlinks that include your prefix, you can set the +``url_prefix`` setting: -so you can access the dashboard at ``http://$IP:$PORT/$PREFIX/``. +:: + ceph config-key set mgr/dashboard/url_prefix $PREFIX -Load balancer -------------- +so you can access the dashboard at ``http://$IP:$PORT/$PREFIX/``. -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 (e.g., ``ceph mgr dump``). In order to make the -dashboard available via a consistent URL regardless of which manager -daemon is currently active, you may want to set up a load balancer -front-end to direct traffic to whichever manager endpoint is -available. If you use a reverse http proxy that forwards a subpath to -the dashboard, you need to configure ``url_prefix`` (see above).