Bug 1390509

Summary:	Misleading thin-pool chunk size recommended in Installation guide
Product:	Red Hat Gluster Storage	Reporter:	Chris Blum <cblum>
Component:	doc-Installation_Guide	Assignee:	Laura Bailey <lbailey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	SATHEESARAN <sasundar>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	rhgs-3.1	CC:	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:
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/.