Bug 1473585 - typo in man heketi-cli
Summary: typo in man heketi-cli
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: heketi
Version: rhgs-3.0
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: CNS 3.6
Assignee: Michael Adam
QA Contact: Prasanth
URL:
Whiteboard: aos-scalability-36
Depends On:
Blocks: 1445448
TreeView+ depends on / blocked
 
Reported: 2017-07-21 08:14 UTC by Elvir Kuric
Modified: 2017-10-11 07:07 UTC (History)
10 users (show)

Fixed In Version: heketi-5.0.0-7 rhgs-volmanager-docker-5.0.0-9
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-10-11 07:07:22 UTC
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Github https://github.com/heketi heketi issues 823 0 None None None 2017-08-02 23:25:10 UTC
Red Hat Product Errata RHEA-2017:2879 0 normal SHIPPED_LIVE heketi bug fix and enhancement update 2017-10-11 11:07:06 UTC

Description Elvir Kuric 2017-07-21 08:14:57 UTC
Description of problem:

man heketi-cli has typo in 

heketi-cli volume create --cluster section.

-- part from man page -- 

 heketi-cli volume create --cluster=<CLUSTER-ID> --disperse-data=<DISPERSION-VALUE> --durability=<TYPE> --name=<VOLUME-NAME> --redundancy=<REDUNDENCY-VALUE> --replica=<REPLICA-
       VALUE> --size=<VOLUME-SIZE> --snapshot-factor=<SNAPSHOT-FACTOR-VALUE>
              Create a GlusterFS volume

                  Options

                      --clusters=""


--- ---- --- 

there is "cluster" and "clusters", valid / working is "clusters"



Version-Release number of selected component (if applicable):
rpm -qa | grep heketi
heketi-5.0.0-2.el7rhgs.x86_64
python-heketi-5.0.0-2.el7rhgs.x86_64
heketi-client-5.0.0-2.el7rhgs.x86_64

How reproducible:
always 

Steps to Reproduce:
try to create volume using 

# heketi-cli volume create --cluster=cluster_id --size=1 

Actual results:

it will fail 

# heketi-cli volume create --cluster=78645dbaa6ce5f16c2162ef6ead4082a --size=1
Error: unknown flag: --cluster

with "clusters" it will work. 


Expected results:

Comment 1 Jan Safranek 2017-07-21 08:22:45 UTC
It's not an OpenShift bug, shifting to Gluster team. Please set the right version, I am really not sure.

Comment 9 Prasanth 2017-09-07 09:22:21 UTC
Verified in man page:

################
   Volume Commands
       heketi-cli volume create --clusters=<CLUSTER-IDS> --disperse-data=<DISPERSION-VALUE> --durability=<TYPE> --name=<VOLUME-NAME> --redundancy=<REDUNDENCY-VALUE> --replica=<REPLICA-
       VALUE> --size=<VOLUME-SIZE> --snapshot-factor=<SNAPSHOT-FACTOR-VALUE>
              Create a GlusterFS volume

                  Options

                      --clusters=""

                         Optional: Comma separated list of cluster ids where this volume
                         must be allocated. If omitted, Heketi will allocate the volume
                         on any of the configured clusters which have the available space.
                         Providing a set of clusters will ensure Heketi allocates storage
                         for this volume only in the clusters specified.
################

Comment 10 errata-xmlrpc 2017-10-11 07:07:22 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-2017:2879


Note You need to log in before you can comment on or make changes to this bug.