Skip to content

Commit

Permalink
doc/cephadm: document new flags on maintenance exit command
Browse files Browse the repository at this point in the history
Signed-off-by: Adam King <[email protected]>
  • Loading branch information
adk3798 committed Oct 16, 2024
1 parent ee9b7c0 commit 565bb14
Showing 1 changed file with 10 additions and 5 deletions.
15 changes: 10 additions & 5 deletions doc/cephadm/host-management.rst
Original file line number Diff line number Diff line change
Expand Up @@ -233,11 +233,16 @@ Place a host in and out of maintenance mode (stops all Ceph daemons on host):
.. prompt:: bash #

ceph orch host maintenance enter <hostname> [--force] [--yes-i-really-mean-it]
ceph orch host maintenance exit <hostname>

The ``--force`` flag allows the user to bypass warnings (but not alerts). The ``--yes-i-really-mean-it``
flag bypasses all safety checks and will attempt to force the host into maintenance mode no
matter what.
ceph orch host maintenance exit <hostname> [--force] [--offline]

The ``--force`` flag on the ``enter`` command allows the user to bypass warnings (but not alerts).
The ``--yes-i-really-mean-it`` flag bypasses all safety checks and will attempt to force the
host into maintenance mode no matter what. The ``--force`` and ``--offline`` flags to the ``exit`` command
can be used to to have cephadm mark a host that is in maintenance mode and offline as no longer
in maintenance mode. Note in this case if the host comes online, the Ceph daemons
on the host will remain in the stopped state. The ``--force`` and ``--offline`` flags to the ``exit``
command are intended to be run for hosts in maintenance mode that are permanently offline
before removing the host entirely from cephadm management using the ``ceph orch host rm`` command.

.. warning:: Using the --yes-i-really-mean-it flag to force the host to enter maintenance
mode can potentially cause loss of data availability, the mon quorum to break down due
Expand Down

0 comments on commit 565bb14

Please sign in to comment.