Documentation #24125
docs: "ceph osd purge" should mention stopping daemon
0%
Description
The documentation for "ceph osd purge" does not contain a lot of
information about the command and its expectations. In
particular, the meaning of what is meant by this message is unclear.
In response to the command "ceph osd purge 1 --yes-i-really-mean-it", we
get:
2018-05-10 15:18:03.444 7f29c0ae2700 2 mon.a@0(leader) e1
send_reply 0x556281707d40 0x5562818cdcc0 mon_command_ack([{"prefix": "osd
purge", "sure": "--yes-i-really-mean-it", "id": 0}]=-16 osd.1 is not
`down`.
v16) v1
...notice that "down" is in quotes, suggesting it has a special meaning, which
is usually reserved for marking processes with a "down" flag.
However, this command actually requires that the OSD process not
be running, and will not succeed on a running OSD merely marked as
"down".
A brief mention that "osd purge" requires the OSD process to not be
running should be added to the documentation. A complete example
of the purge command's usage would be helpful.
History
#1 Updated by John Spray about 5 years ago
- Subject changed from "ceph osd purge": meaning of "down" is ambiguous to docs: "ceph osd purge" should mention stopping daemon
The message improvement is covered in: http://tracker.ceph.com/issues/24127, so narrowing scope of this ticket to doc improvement.
The relevant place is probably: http://docs.ceph.com/docs/master/rados/operations/add-or-rm-osds/#removing-the-osd (anyone logged into github can edit that file by clicking the edit/pencil icon in the top right here: https://github.com/ceph/ceph/blob/master/doc/rados/operations/add-or-rm-osds.rst)
#2 Updated by Nathan Cutler almost 5 years ago
- Status changed from New to Fix Under Review
- Assignee changed from Jesse Williamson to Nathan Cutler
#3 Updated by Nathan Cutler almost 5 years ago
- Status changed from Fix Under Review to Rejected
The doc already covers this:
Stopping the OSD
After you take an OSD out of the cluster, it may still be running. That is, the OSD
may be up and out. You must stop your OSD before you remove it from the configuration.
ssh {osd-host}
sudo systemctl stop ceph-osd@{osd-num}
Once you stop your OSD, it is down.