From 9606f4d6023d2663469b0857ce879ea1ae41c166 Mon Sep 17 00:00:00 2001 From: Joshua Schmid Date: Tue, 28 Jul 2020 09:35:56 +0200 Subject: [PATCH] doc/cephadm: adjust osd removal docs Signed-off-by: Joshua Schmid --- doc/mgr/orchestrator.rst | 35 ++++++++++++++++++++++++++--------- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst index 27ffa70490d..74049fe2bdc 100644 --- a/doc/mgr/orchestrator.rst +++ b/doc/mgr/orchestrator.rst @@ -205,16 +205,16 @@ In the case that you have already created the OSD's using the ``all-available-de ceph orch osd spec --service-name osd.all-available-devices --unmanaged Remove an OSD -------------------- +------------- :: - ceph orch osd rm ... [--replace] [--force] + ceph orch osd rm [--replace] [--force] -Removes one or more OSDs from the cluster. +Evacuates PGs from an OSD and removes it from the cluster. Example:: - # ceph orch osd rm 4 + # ceph orch osd rm 0 Scheduled OSD(s) for removal @@ -223,10 +223,10 @@ OSDs that are not safe-to-destroy will be rejected. You can query the state of the operation with:: # ceph orch osd rm status - NAME HOST PGS STARTED_AT - osd.7 node1 55 2020-04-22 19:28:38.785761 - osd.5 node3 3 2020-04-22 19:28:34.201685 - osd.3 node2 0 2020-04-22 19:28:34.201695 + OSD_ID HOST STATE PG_COUNT REPLACE FORCE STARTED_AT + 2 cephadm-dev done, waiting for purge 0 True False 2020-07-17 13:01:43.147684 + 3 cephadm-dev draining 17 False True 2020-07-17 13:01:45.162158 + 4 cephadm-dev started 42 False True 2020-07-17 13:01:45.162158 When no PGs are left on the osd, it will be decommissioned and removed from the cluster. @@ -235,11 +235,28 @@ When no PGs are left on the osd, it will be decommissioned and removed from the After removing an OSD, if you wipe the LVM physical volume in the device used by the removed OSD, a new OSD will be created. Read information about the ``unmanaged`` parameter in :ref:`orchestrator-cli-create-osds`. +Stopping OSD Removal +-------------------- + +You can stop the operation with + +:: + + ceph orch osd rm stop + +Example:: + + # ceph orch osd rm stop 4 + Stopped OSD(s) removal + +This will reset the initial state of the OSD and remove it from the queue. + + Replace an OSD ------------------- :: - orch osd rm ... --replace [--force] + orch osd rm --replace [--force] Example:: -- 2.39.5