ceph/doc/mgr/dashboard_plugins/feature_toggles.inc.rst
Lenz Grimmer 48282cb9f9 doc: Updated Ceph Dashboard documentation
Renamed "Ceph Manager Dashboard" to "Ceph Dashboard" in
various locations, replaced "plugin" with "module".
Overhauled the feature list, added more references to configuration
instructions and related components.
Fixed capitalization of subchapters.
Added note about mixed content blocking to the Grafana section.
Removed duplicate content from the dashboard's `README.rst`,
moved some parts (supported browser list) into the documentation
instead.

Signed-off-by: Lenz Grimmer <lgrimmer@suse.com>
2019-02-28 17:14:37 +01:00

45 lines
1.5 KiB
ReStructuredText

.. _dashboard-feature-toggles:
Feature Toggles
^^^^^^^^^^^^^^^
This plug-in allows to enable or disable some features from the Ceph Dashboard
on-demand. When a feature becomes disabled:
- Its front-end elements (web pages, menu entries, charts, etc.) will become hidden.
- Its associated REST API endpoints will reject any further requests (404, Not Found Error).
The main purpose of this plug-in is to allow ad-hoc customizations of the workflows exposed
by the dashboard. Additionally, it could allow for dynamically enabling experimental
features with minimal configuration burden and no service impact.
The list of features that can be enabled/disabled is:
- **Block (RBD)**:
- Image Management: ``rbd``
- Mirroring: ``mirroring``
- iSCSI: ``iscsi``
- **Filesystem (Cephfs)**: ``cephfs``
- **Objects (RGW)**: ``rgw`` (including daemon, user and bucket management).
By default all features come enabled.
To retrieve a list of features and their current statuses::
$ ceph dashboard feature status
Feature 'cephfs': 'enabled'
Feature 'iscsi': 'enabled'
Feature 'mirroring': 'enabled'
Feature 'rbd': 'enabled'
Feature 'rgw': 'enabled'
To enable or disable the status of a single or multiple features::
$ ceph dashboard feature disable iscsi mirroring
Feature 'iscsi': disabled
Feature 'mirroring': disabled
After a feature status has changed, the API REST endpoints immediately respond to
that change, while for the front-end UI elements, it may take up to 20 seconds to
reflect it.