Bug 1501888

Summary: [BitRot] man page of gluster needs to be updated for scrub-frequency
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Vinayak Papnoi <vpapnoi>
Component: bitrotAssignee: Kotresh HR <khiremat>
Status: CLOSED ERRATA QA Contact: Sweta Anandpara <sanandpa>
Severity: high Docs Contact:
Priority: high    
Version: rhgs-3.3CC: amukherj, khiremat, rhinduja, rhs-bugs, storage-qa-internal
Target Milestone: ---Keywords: Rebase, Reopened
Target Release: RHGS 3.5.0   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: glusterfs-6.0-1 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1503510 (view as bug list) Environment:
Last Closed: 2019-10-30 12:19:37 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:    
Bug Blocks: 1503510, 1696807    

Description Vinayak Papnoi 2017-10-13 12:24:55 UTC
Description of problem:
-----------------------

The manual page of gluster should be updated with respect to gluster bitrot scrub-frequency option. Scrub-frequency on hourly basis is supported but not mentioned in the man page.


Version-Release number of selected component (if applicable):
-------------------------------------------------------------

glusterfs-3.8.4-48.el7rhgs.x86_64


How reproducible:
-----------------

always


Steps to Reproduce:
-------------------

1. man gluster


Actual results:
---------------

volume bitrot <VOLNAME> scrub-frequency {daily|weekly|biweekly|monthly}


Expected results:
-----------------

volume bitrot <VOLNAME> scrub-frequency {hourly|daily|weekly|biweekly|monthly}

Comment 2 Kotresh HR 2017-10-18 07:10:49 UTC
This was intentional and only for testing purpose. Hence not advertised in man page. Closing this bug as not a bug.

Comment 3 Sweta Anandpara 2017-10-18 09:57:00 UTC
If I remember correctly, it was only 'minute' that was introduced for testing purpose - and that is why we don't have a mention, either in man page, or in 'gluster volume bitrot -h'.

'Hourly' is mentioned in 'gluster volume bitrot -h', but NOT in man page. I don't think we should have this discrepancy there..

Comment 4 Kotresh HR 2017-10-18 10:13:35 UTC
You are right. I got confused with hour. It was minute. Re-opening it and will be addressed.

Comment 5 Kotresh HR 2017-10-18 10:33:54 UTC
Upstream Patch:

https://review.gluster.org/18545

Comment 7 Yaniv Kaul 2018-09-20 10:43:31 UTC
(In reply to Kotresh HR from comment #5)
> Upstream Patch:
> 
> https://review.gluster.org/18545

That was merged almost a year ago. What's the latest status?

Comment 8 Kotresh HR 2018-09-24 02:43:17 UTC
(In reply to Yaniv Kaul from comment #7)
> (In reply to Kotresh HR from comment #5)
> > Upstream Patch:
> > 
> > https://review.gluster.org/18545
> 
> That was merged almost a year ago. What's the latest status?

It will be part of next downstream release. 3.4 was out of planning exit phase, when this was merged. So didn't allow this as this didn't come into blocker criteria.

Thanks,
Kotresh HR

Comment 12 errata-xmlrpc 2019-10-30 12:19:37 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://access.redhat.com/errata/RHEA-2019:3249