Bug 1459871

Summary: [DOCS][RFE] Document NFS host groups
Product: OpenShift Container Platform Reporter: Thom Carlin <tcarlin>
Component: DocumentationAssignee: Brandi Munilla <bmcelvee>
Status: CLOSED DEFERRED QA Contact: Anping Li <anli>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.5.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: 3.10-release-plan
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-05-21 16:25:11 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: 1724792    

Description Thom Carlin 2017-06-08 12:15:12 UTC 
Document URL: 

https://access.redhat.com/documentation/en-us/openshift_container_platform/3.5/html-single/installation_and_configuration/#configuring-ansible

Section Number and Name: 

2.6.3.11.1. Configuring Metrics Storage
2.6.3.12. Configuring Cluster Logging

Describe the issue: 

References are made to [nfs] host group but it is never clearly explained.

Suggestions for improvement: 

Add explanation of [OSEv3:children] section/group, the [nfs] section/group, and entries under [nfs]

Additional information: 

Adding Persistent Volumes in a planning section would also help to organize this.  It cost several weeks for us to find many of our issues were due to no PV's to match up with PVC's.

Further, Examples for [nfs] are hard to find.  Many of the example files are broken as delivered.