Bug 1382907

Summary: Need to document the minimize volume size for GlusterFS provisioners using Heketi
Product: OpenShift Container Platform Reporter: Jianwei Hou <jhou>
Component: DocumentationAssignee: brice <bfallonf>
Status: CLOSED NOTABUG QA Contact: Vikram Goyal <vigoyal>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 3.4.0CC: aos-bugs, bfallonf, hchiramm, jokerman, mmccomas, rcyriac
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-04-24 14:42:22 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:

Description Jianwei Hou 2016-10-08 08:15:02 UTC
Document URL: 

Section Number and Name: 

Describe the issue: 
GlusterFS provisioner makes use of Heketi API service. With Heketi, the volume sizes are required to be more than 10Gi, any smaller sizes requested via PVC will end in failure with error 'No space', which can be quite misleading. See issue: https://github.com/heketi/heketi/issues/505

Users need to be advised about this so that they don't run into same problem.

Suggestions for improvement: 

Additional information:

Comment 1 Humble Chirammal 2016-10-19 07:24:51 UTC
The minimum volume size depends on couple of other parameters like min_brick_size..etc which is a configurable value in server side, so defining a 'minimum volume size' is difficult from the client side.  The error is bit misleading, however we have improved this error and from here on https://github.com/heketi/heketi/pull/472, we should get a proper error message.

Comment 2 Humble Chirammal 2016-10-21 13:46:27 UTC
I would like to call this as NOT A BUG.

Comment 4 brice 2018-04-24 14:42:22 UTC
An improved error message works for me. I'll close this BZ.