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: RGWAssignee: Casey Bodley <cbodley>
Status: CLOSED ERRATA QA Contact: Tejas <tchandra>
Severity: medium Docs Contact: Bara Ancincova <bancinco>
Priority: unspecified    
Version: 1.3.2CC: 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