Bug 1258793

Summary:	[DOC]-SBRvirt request - Storage pool documentation needs to be re-tweaked
Product:	Red Hat Enterprise Linux 7	Reporter:	Laura Novich <lnovich>
Component:	doc-Virtualization_Deployment_and_Administration_Guide	Assignee:	Yehuda Zimmerman <yzimmerm>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Jaroslav Suchanek <jsuchane>
Severity:	unspecified	Docs Contact:
Priority:	medium
Version:	7.2	CC:	jferlan, jherrman, jhradile, mkalinin
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---	Flags:	yzimmerm: needinfo+
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:	2018-09-04 12:45:36 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:

Description Laura Novich 2015-09-01 10:09:06 UTC

Document URL: 
https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/chap-Storage_pools.html
Section Number and Name: Storage Pools chapter 13

Describe the issue:  
 Storage pool documentation needs to be re-tweaked - need to address the concept of a storage pool. Storage pools are not required - we have nothing to say whether you do or don’t need a storage pool
It is possible to create image from the defaults. Placing image files anywhere as an option is also not stated - need to tweak SELinux for this.
Fix includes: 
*Rewriting the ENTIRE storage chapter
*Put in section that dictates which hardware solution yields which storage pool
*Clearer understanding for what a storage pool volume and solution are and how and when to use them
*CLEARLY state that a storage pool is not required
*Also important is to Explain difference between the types of storage pool
*How to choose the storage pool that matches what you want to do, why to use one type or another.
*There are many ways to use storage. ie. if they have Fibre Channel -- put on LUNs or put on LVM
Customers should/usually understand what base system they have - will know if they have:
NFS
iSCSI
FC
Based on this they choose which storage pool type to configure. However, they don’t know which instructions apply to them.

Suggestions for improvement: 

Additional information:

Comment 6 John Ferlan 2018-03-08 13:31:05 UTC

Unclear why there's 2 bugs tracking exactly the same thing (bz 1470018 points at the same link above). If one or the other is preferred for updates let me know; otherwise, I'll assume the latter is preferred. I'll work section by section - never quite sure how long it'll take to finish, but I am working on it now and will provide some feedback shortly.