Bug 1228920

Summary:	Brick configuration steps should be updated to reflect lvm changes in RHEL 6.7 and RHEL7.1
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	Manoj Pillai <mpillai>
Component:	doc-Administration_Guide	Assignee:	Bhavana <bmohanra>
doc-Administration_Guide sub component:	Default	QA Contact:	Nag Pavan Chilakam <nchilaka>
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	medium
Priority:	unspecified	CC:	annair, asriram, asrivast, divya, mhideo, msnitzer, nchilaka, nlevinki, rhs-bugs, rnachimu, rwheeler, sasundar, storage-doc, surs, tjeyasin
Version:	rhgs-3.1
Target Milestone:	---
Target Release:	RHGS 3.1.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:
Clones:	1230633 1230639 (view as bug list)		Environment:
Last Closed:	2017-11-17 05:18:10 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:	1202842, 1230633, 1230639

Description Manoj Pillai 2015-06-06 17:06:27 UTC

Document URL: 

Section Number and Name: 
https://access.redhat.com/documentation/en-US/Red_Hat_Storage/3/html-single/Administration_Guide/index.html#chap-Configuring_Red_Hat_Storage_for_Enhancing_Performance

And any other dependent sections.

Describe the issue: 
Brick configurations steps in the RHGS 3.0 admin guide are somewhat complicated because, at the time, LVM only supported Volume Group extent sizes that were a power of 2.

Suggestions for improvement: 
bz 1100514 requesting support for non-power-of-2 physical extents has been fixed and is available in both RHEL 6.7 and RHEL 7.1. Since RHGS 3.1 will be on RHEL 6.7 and RHEL 7.1, we should now simplify the brick configuration steps.

Additional information:

Comment 2 Manoj Pillai 2015-06-08 04:41:32 UTC

Steps to be followed for Brick Configuration:

1. create pv [no change]

2. create vg
a. RAID-6 and RAID-10: vgcreate --physicalextentsize <pe_sz> <vg_name> <pv_name>
where pe_sz = (stripe_unit size) * (number of data disks)
b. JBOD: vgcreate <vg_name> <pv_name>

3. create thin pool
command: 
lvcreate --thinpool <pool_name> --size <pool_size> --chunksize
<chunk_size> --poolmetadatasize <meta_size> <vg_name>

- thin pool chunk size recommendation:
[no change
RAID-6: (stripe_unit size) * (number of data disks)
RAID-10: 256K
JBOD: 256K]

- pool metadata device size recommendation [no change]

- turn off block zeroing in thin pool [no change]

4+. thin lv and file system creation [no change]

Comment 3 Bhavana 2015-07-24 12:54:17 UTC

made the required changes based on my discussion with Manoj.

http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Gluster_Storage-3.1-Administration_Guide%20%28html-single%29/lastStableBuild/artifact/tmp/en-US/html-single/index.html#Brick_Configuration

Comment 4 Nag Pavan Chilakam 2015-07-27 12:41:52 UTC

validated and was able to create LVs using doc 11.2. Brick Configuration
followed all steps and was successful
hence marking as verified
[root@rhgs-6 ~]# cat /etc/redhat-*
Red Hat Enterprise Linux Server release 6.7 (Santiago)
Red Hat Gluster Storage Server 3.1