Bug 1325342

Summary:	Move swap section of docs to prereqs
Product:	OpenShift Container Platform	Reporter:	Eric Jones <erjones>
Component:	Documentation	Assignee:	Ashley Hardin <ahardin>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vikram Goyal <vigoyal>
Severity:	unspecified	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	unspecified
Version:	2.1.0	CC:	aos-bugs, erjones, jokerman, mmccomas, nmunnell, pep, vigoyal
Target Milestone:	---	Flags:	erjones: needinfo? (nmunnell)
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-05-31 14:09:35 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 Eric Jones 2016-04-08 13:27:37 UTC

Document URL: 
https://docs.openshift.com/enterprise/3.1/admin_guide/overcommit.html#disabling-swap-memory

Section Number and Name: 
Disabling Swap Memory

Describe the issue: 
The documentation specifically notes and explains why this is very important. 

Suggestions for improvement: 
Add (or move) this section to the installation Prerequisites Section so everyone knows to do this.

Additional information: 
In fact it might not be a bad idea to add most of the `Overcommitting` page to the Prerequisites as a lot of them seem important.

Comment 1 Josep 'Pep' Turro Mauri 2016-04-08 13:36:34 UTC

We have other (non-OSE) documents that recommend *not* to disable swap, e.g. https://access.redhat.com/solutions/546433

Before moving this to a pre-requisite we should double-check/clarify the recommendation itself

Comment 3 Eric Jones 2016-04-08 18:22:39 UTC

If we do decide this is something that is recommended we need to update the doc to indicate the recommended way to turn of swap persistently, as the current method is only for that boot.

Comment 10 openshift-github-bot 2016-05-24 16:15:53 UTC

Commit pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/cc720162ac6268b83c0bea2184088a977e9e0191
Merge pull request #2094 from ahardin-rh/disabling-swap

Bug 1325342: Updated Disabling Swap Memory section

Comment 11 Ashley Hardin 2016-05-24 16:19:30 UTC

Getting these changes in. If more work is necessary, please let me know. Thanks!

Comment 12 Ashley Hardin 2016-05-31 14:09:35 UTC

Content is now published:
https://access.redhat.com/documentation/en/openshift-enterprise/3.2/cluster-administration/chapter-14-overcommitting