Bug 1312140

Summary: Install Guide should include a some kind of table that outlines where local storage on servers is used
Product: OpenShift Container Platform Reporter: Eric Sauer <esauer>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.1.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-12-30 14:03:18 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 Sauer 2016-02-25 20:41:36 UTC 
Document URL: 
https://docs.openshift.org/latest/install_config/install/prerequisites.html

Section Number and Name:
02: System Requirements 

Describe the issue: 
When building more Pre-Production & Production level environments, customers often need to break down /var/ into various unique partitions/block devices/logical volumes in order to build a more sustainable environments. For example, a common breakdown of those partitions might look like:
/var/lib/etcd
/var/log/
/var/lib/docker/
/

However, there are other directories that have the potential to fill up and cause issues, and require maintenance.

Suggestions for improvement: 
We would like to have a table added that breaks down the directories written to by the various components of OpenShift, where they write to by default, a description of the types of data written (logs, app data, containers, etc.) and how to reconfigure them to write elsewhere where possible.

Additional information: 
This could be contained either within the Installation Guide > Prerequisites, or elsewhere in the Admin Guide, with a Link in the Prerequisites doc.
Comment 1 Vikram Goyal 2017-12-30 14:03:18 UTC 
The following information was added to the Scaling and Performance Guide which breaks down the different kinds of Storage: https://docs.openshift.com/container-platform/3.7/scaling_performance/optimizing_storage.html.

This was added for the 3.7 docs.

I am going to close this bug, but feel free to reopen if this information is not enough.