Project

General

Profile

Documentation #24125

docs: "ceph osd purge" should mention stopping daemon

Added by Jesse Williamson almost 2 years ago. Updated over 1 year ago.

Status:
Rejected
Priority:
Low
Assignee:
Category:
documentation
Target version:
-
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Pull request ID:

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 almost 2 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 over 1 year ago

  • Status changed from New to Fix Under Review
  • Assignee changed from Jesse Williamson to Nathan Cutler

#3 Updated by Nathan Cutler over 1 year 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.

Also available in: Atom PDF