]>
Commit | Line | Data |
---|---|---|
11fdf7f2 TL |
1 | .. _dashboard-feature-toggles: |
2 | ||
3 | Feature Toggles | |
4 | ^^^^^^^^^^^^^^^ | |
5 | ||
6 | This plug-in allows to enable or disable some features from the Ceph Dashboard | |
7 | on-demand. When a feature becomes disabled: | |
8 | ||
9 | - Its front-end elements (web pages, menu entries, charts, etc.) will become hidden. | |
10 | - Its associated REST API endpoints will reject any further requests (404, Not Found Error). | |
11 | ||
12 | The main purpose of this plug-in is to allow ad-hoc customizations of the workflows exposed | |
13 | by the dashboard. Additionally, it could allow for dynamically enabling experimental | |
14 | features with minimal configuration burden and no service impact. | |
15 | ||
16 | The list of features that can be enabled/disabled is: | |
17 | ||
18 | - **Block (RBD)**: | |
19 | - Image Management: ``rbd`` | |
20 | - Mirroring: ``mirroring`` | |
21 | - iSCSI: ``iscsi`` | |
22 | - **Filesystem (Cephfs)**: ``cephfs`` | |
23 | - **Objects (RGW)**: ``rgw`` (including daemon, user and bucket management). | |
9f95a23c | 24 | - **NFS**: ``nfs-ganesha`` exports. |
11fdf7f2 TL |
25 | |
26 | By default all features come enabled. | |
27 | ||
2a845540 TL |
28 | To retrieve a list of features and their current statuses: |
29 | ||
30 | .. prompt:: bash $ | |
31 | ||
32 | ceph dashboard feature status | |
33 | ||
34 | :: | |
11fdf7f2 | 35 | |
11fdf7f2 TL |
36 | Feature 'cephfs': 'enabled' |
37 | Feature 'iscsi': 'enabled' | |
38 | Feature 'mirroring': 'enabled' | |
39 | Feature 'rbd': 'enabled' | |
40 | Feature 'rgw': 'enabled' | |
9f95a23c | 41 | Feature 'nfs': 'enabled' |
11fdf7f2 | 42 | |
2a845540 TL |
43 | To enable or disable the status of a single or multiple features: |
44 | ||
45 | .. prompt:: bash $ | |
46 | ||
47 | ceph dashboard feature disable iscsi mirroring | |
48 | ||
49 | :: | |
11fdf7f2 | 50 | |
11fdf7f2 TL |
51 | Feature 'iscsi': disabled |
52 | Feature 'mirroring': disabled | |
53 | ||
54 | After a feature status has changed, the API REST endpoints immediately respond to | |
55 | that change, while for the front-end UI elements, it may take up to 20 seconds to | |
56 | reflect it. |