Bug 1248420

Summary:	Document RHEL-7 RHGS tuned profiles
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:	SATHEESARAN <sasundar>
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	unspecified
Priority:	unspecified	CC:	asriram, divya, mhideo, mpillai, nlevinki, rcyriac, rhs-bugs, rwheeler, storage-doc
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:		Environment:
Last Closed:		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:

Description Manoj Pillai 2015-07-30 09:10:20 UTC

Document URL:

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

Describe the issue:
New tuned profiles have been added for RHGS on RHEL-7. They need to be documented in the admin guide

See also:
Bug 1242454 - RHGS tuned profiles incompatible with RHEL7 tuned
Bug 1243725 - Do not install RHEL-6 tuned profiles in RHEL-7 based RHGS 

Suggestions for improvement: 

Additional information:

Comment 2 Manoj Pillai 2015-07-30 09:16:05 UTC

Suggested changes.

Section 11.2.7 Performance tuning option in Red Hat Gluster Storage

[note that the current text applies to RHEL-6 tuned profiles]

[add the following at the end of the sub-section]

On RHEL 7, there are two tuned profiles available,
rhgs-sequential-io and rhgs-random-io. Choose between
these profiles based on your workload, as recommended in the
table below:

Table:
Workload | Profile Name
large-file, sequential I/O workloads | rhgs-sequential-io
small-file workloads | rhgs-random-io
random I/O workloads | rhgs-random-io

Activate the tuned profile using the command:
tuned-adm profile <profile-name>

For example:
tuned-adm profile rhgs-sequential-io

Section 11.4.1 Virtual Memory Parameters

[Add the following note immediately after the table 11.1]
Note: The RHEL-7 tuned profiles, rhgs-sequential-io and
rhgs-random-io, set the virtual memory parameter values as given
in table 11.1 The rest of this sub-section is necessary only on RHEL-6.

11.5. Small File Performance Enhancements

[change the note in para 2. to the following]
Note: On RHEL 7, for a small-file workload, activate the rhgs-random-io
tuned profile. On RHEL 6, for a small-file workload, see the
<previous section> for instructions on configuring virtual memory parameter values.

11.6 Number of Clients

[Note that this applies for RHEL-6 only]

Comment 3 Bhavana 2015-07-31 11:49:43 UTC

Hi Manoj,

The details are updated as suggested. Do share your review comments if any.

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#chap-Configuring_Red_Hat_Storage_for_Enhancing_Performance

Comment 4 Manoj Pillai 2015-07-31 12:57:31 UTC

There are some spelling errors in the addition to 11.6 that needs fixing.

Rest seems fine. All changes are in the right place.

Comment 5 SATHEESARAN 2015-07-31 17:01:57 UTC

Also checked the doc as available in doclink provided in comment3.

As Manoj pointed out, the note under section 11.6 requires spelling correction.
Also it calls RHGS 3.1 as 'Red Hat Gluster 3.1', which could be termed as 'Red Hat Gluster Storage 3.1'

Comment 6 Bhavana 2015-08-03 06:06:53 UTC

Hi Sas/Manoj,

The changes are incorporated.

Please check the link after an hour to view the changes.

Comment 7 SATHEESARAN 2015-08-03 07:08:49 UTC

Verified with the doc-link available in comment3.
It looks good.

Marking this bug as VERIFIED