Bug 1390509

Summary: Misleading thin-pool chunk size recommended in Installation guide
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Chris Blum <cblum>
Component: doc-Installation_GuideAssignee: Laura Bailey <lbailey>
Status: CLOSED CURRENTRELEASE QA Contact: SATHEESARAN <sasundar>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rhgs-3.1CC: asriram, asrivast, cblum, divya, mpillai, rhs-bugs, rwheeler, sankarshan, sasundar, storage-doc, storage-qa-internal, tcole
Target Milestone: ---   
Target Release: RHGS 3.2.0   
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: 2017-03-24 01:08:52 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: 1351553    

Description Chris Blum 2016-11-01 09:40:04 UTC 
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Installation_Guide/sect-In-Service_Software_Upgrade_from_Red_Hat_Storage_2.1_to_Red_Hat_Storage_3.0.html#sect-Pre-upgrade_Tasks

Section Number and Name: 
9.2.1.1. Upgrade Requirements for Red Hat Gluster Storage 3.1
Recommended Setup - 2nd bullet point

Describe the issue: 
Text states:
"The recommended thin pool chunk size is 256KB."
But this is only recommended for the rare case that Gluster is using JBOD devices. See:
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/Administration_Guide/Brick_Configuration.html

Suggestions for improvement: 
Remove these bullet points and keep Chapter 13.2 from the Administration guide as the one single truth.

Additional information:
Comment 6 Manoj Pillai 2016-11-21 04:07:15 UTC 
(In reply to Chris Blum from comment #0)

> Describe the issue: 
> Text states:
> "The recommended thin pool chunk size is 256KB."
> But this is only recommended for the rare case that Gluster is using JBOD
> devices. See:
> https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3.1/html/
> Administration_Guide/Brick_Configuration.html
> 
> Suggestions for improvement: 
> Remove these bullet points and keep Chapter 13.2 from the Administration
> guide as the one single truth.

I feel the same way.
Comment 12 SATHEESARAN 2017-02-01 08:44:04 UTC 
Tested with the link provided in comment11.
Thin pool perf recommendations are removed from 'recommended setup' in  pre-upgrade tasks
Comment 13 Laura Bailey 2017-03-24 01:08:52 UTC 
Moving to CLOSED CURRENTRELEASE since RHGS 3.2 GA was yesterday. All documentation is available from https://access.redhat.com/documentation/en/red-hat-gluster-storage/.