Bug 1301706

Summary:	Need "orphans find" command to be listed in the manpage of radosgw-admin command
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	shilpa <smanjara>
Component:	RGW	Assignee:	Casey Bodley <cbodley>
Status:	CLOSED ERRATA	QA Contact:	Tejas <tchandra>
Severity:	medium	Docs Contact:	Bara Ancincova <bancinco>
Priority:	unspecified
Version:	1.3.2	CC:	cbodley, ceph-eng-bugs, flucifre, hnallurv, icolle, kbader, kdreyer, mbenjamin, owasserm, sweil, tserlin, yehuda
Target Milestone:	rc
Target Release:	1.3.3
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	RHEL: ceph-0.94.9-3.el7cp Ubuntu: ceph_0.94.9-4redhat1trusty	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-09-29 12:56:04 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1335269
Bug Blocks:	1299303

Description shilpa 2016-01-25 18:15:12 UTC

Description of problem:
A cli tool for identifying orphaned rgw objects is backported to 1.3.2. Refer https://bugzilla.redhat.com/show_bug.cgi?id=1254398. 
Need to include this cli option in the man page for "radosgw-admin" command.

Version-Release number of selected component (if applicable):
ceph-radosgw-0.94.5-3.el7cp.x86_64

Steps to Reproduce:

1. $ radosgw-admin orphans find --pool=<data pool> --job-id=<name> [--num-shards=<num shards>] [--orphan-stale-secs=<seconds>]

Actual results:
"radosgw-admin --help" currently does not list the above option.

Comment 2 Ken Dreyer (Red Hat) 2016-02-03 17:01:58 UTC

fix merged upstream @ https://github.com/ceph/ceph/pull/7473

Comment 3 Ken Dreyer (Red Hat) 2016-02-04 02:57:26 UTC

Orit or Yehuda, we'll need https://github.com/ceph/ceph/pull/7518 as well in order to fix this

Comment 4 Ken Dreyer (Red Hat) 2016-02-04 18:13:40 UTC

Orit merged the above PR to master; thanks Orit. PR for hammer: https://github.com/ceph/ceph/pull/7524

(downstream we really only need to cherry-pick the second commit there, "doc: add orphans commands to radosgw-admin(8)
")

Comment 7 shilpa 2016-02-07 08:32:01 UTC

I suppose we also have another option in "orphans find" command that needs to be documented.

[--orphan-stale-secs=<seconds>]

 $ radosgw-admin orphans find --pool=<data pool> --job-id=<name> [--num-shards=<num shards>] [--orphan-stale-secs=<seconds>]

Comment 8 Ken Dreyer (Red Hat) 2016-02-08 22:22:52 UTC

Yehuda/Orit, mind submitting a PR for this? Do we need any other options, also?

Comment 12 Yehuda Sadeh 2016-05-03 17:49:45 UTC

both upstream issues have been resolved.

Comment 18 Tejas 2016-09-14 13:15:15 UTC

I do not see the "--orphan-stale-secs=<seconds>" option in the "man radosgw-admin" page in ceph version: 0.94.9-2.el7cp 
Moving this back

Comment 19 Ken Dreyer (Red Hat) 2016-09-15 17:39:38 UTC

Filed http://tracker.ceph.com/issues/17280 to track missing "--orphan-stale-secs" in radosgw-admin man page.

Comment 20 Ken Dreyer (Red Hat) 2016-09-15 17:44:16 UTC

man page update for master in https://github.com/ceph/ceph/pull/11097

Comment 29 Tejas 2016-09-21 07:11:50 UTC

Verified on ceph version:
ceph version 0.94.9-3.el7cp

Comment 31 errata-xmlrpc 2016-09-29 12:56:04 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://rhn.redhat.com/errata/RHSA-2016-1972.html