Bug 1381408

Summary: [DOCS] Sizing table in OpenShift v3.3 document seems to be in correct.
Product: OpenShift Container Platform Reporter: Ganesh Radhakrishnan <gradhakr>
Component: DocumentationAssignee: Ashley Hardin <ahardin>
Status: CLOSED CURRENTRELEASE QA Contact: DeShuai Ma <dma>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.3.0CC: aos-bugs, dma, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-01 14:48:50 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 Ganesh Radhakrishnan 2016-10-04 01:47:43 UTC 
Description of problem:
The sizing table in Chapter 2 of the OpenShift installation and configuration guide seems to be in correct.
https://access.redhat.com/documentation/en/openshift-container-platform/3.3/single/installation-and-configuration/#sizing

Also, the example below the sizing table (section 2.1.3) seems to be in correct.

Version-Release number of selected component (if applicable):
OpenShift v3.3

How reproducible:
Per the sizing table :-
Max. nodes / cluster = 1000
Max. pods / cluster = 120000

Based on the above, the max pods / node should be ~ 120 (120000 / 1000), whereas the table states the max. pods / node is 250.    

Also, the example below the table states -
If you require 2200 pods, you need at least 20 nodes in your environment.  

This again doesn't add up - 2200 / 250 ~ 8 nodes ??  Whereas 2200 / 120 ~ 18.33

Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:
Comment 2 Ashley Hardin 2016-10-06 20:37:29 UTC 
Work in progress:
https://github.com/openshift/openshift-docs/pull/2987
Comment 3 Ashley Hardin 2016-10-28 16:21:48 UTC 
 Preview build: http://file.rdu.redhat.com/~ahardin/10262016/sizing-fixes/install_config/install/planning.html#sizing

PR: https://github.com/openshift/openshift-docs/pull/2987
Comment 4 DeShuai Ma 2016-10-31 02:56:54 UTC 
The update LGTM, verify this bug.
Comment 5 openshift-github-bot 2016-10-31 11:50:07 UTC 
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/2a7f427f5a23f0448c7e34f676c50f7774437d18
Bug 1381408, Fix sizing guidelines

https://github.com/openshift/openshift-docs/commit/04c1ea9fe5f90b7d0b3ac224b082b6d16c54eb2e
Merge pull request #2987 from ahardin-rh/sizing-fixes

Bug 1381408, Fix sizing guidelines
Comment 6 Ashley Hardin 2016-11-01 14:48:50 UTC 
Content is now published:
https://access.redhat.com/documentation/en/openshift-container-platform/3.3/paged/installation-and-configuration/chapter-2-installing-a-cluster#sizing