Bug 1667954

Summary: [man page] Gluster(8) - Missing disperse-data parameter Gluster Console Manager man page
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Tiago M. De Rizzo <tmilsond>
Component: disperseAssignee: Sheetal Pamecha <spamecha>
Status: CLOSED ERRATA QA Contact: Pranav Prakash <prprakas>
Severity: medium Docs Contact:
Priority: unspecified    
Version: unspecifiedCC: pasik, pprakash, puebele, rhs-bugs, rkothiya, sabose, sheggodu, smulay, storage-doc, storage-qa-internal
Target Milestone: ---Keywords: ZStream
Target Release: RHGS 3.5.z Batch Update 3   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: glusterfs-6.0-38 Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of:
: 1668239 (view as bug list) Environment:
Last Closed: 2020-12-17 04:50:16 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: 1668239    
Bug Blocks:    

Description Tiago M. De Rizzo 2019-01-21 15:03:35 UTC
Document URL: 

man 8 gluster

Section Number and Name: 

COMMANDS -> Volume Commands

Describe the issue: 

No man-page reference for `disperse-data` parameter when creating a new volume (gluster(8)):
---
        volume create <NEW-VOLNAME> [stripe <COUNT>] [replica <COUNT>] [disperse [<COUNT>]] [redundancy <COUNT>] [transport <tcp|rdma|tcp,rdma>] <NEW-BRICK> ...
              Create a new volume of the specified type using the specified bricks and transport type (the default transport type is tcp).  To create a volume  with  both  transports  (tcp  and  rdma),  give
              'transport tcp,rdma' as an option.
---

However "Usage:" message shows disperse-data:
---
volume create <NEW-VOLNAME> [stripe <COUNT>] [replica <COUNT> [arbiter <COUNT>]] [disperse [<COUNT>]] [disperse-data <COUNT>] [redundancy <COUNT>] [transport <tcp|rdma|tcp,rdma>] <NEW-BRICK>?<vg_name>... [force]
---

Suggestions for improvement: 

Add disperse-data to "man 8 gluster" explaining its utilization scenario.

Additional information:

Comment 2 Sahina Bose 2020-01-02 09:30:37 UTC
Shriya, I see this bug assigned to you. Is there plans to fix this? If not, please close the bug

Comment 3 Sheetal Pamecha 2020-02-06 09:50:09 UTC
Upstream Patch - https://review.gluster.org/#/c/glusterfs/+/23258/

Comment 11 errata-xmlrpc 2020-12-17 04:50:16 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 (glusterfs bug fix and enhancement update), 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/RHBA-2020:5603