Bug 1126530

Summary:	[RFE] Working / process explanation is confusing.
Product:	OpenShift Container Platform	Reporter:	Eric Rich <erich>
Component:	Documentation	Assignee:	Alex Dellapenta <adellape>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vikram Goyal <vigoyal>
Severity:	unspecified	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	unspecified
Version:	2.1.0	CC:	adellape, aos-bugs, jokerman, libra-onpremise-devel, mmccomas
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:	Build Name: 20822, Administration Guide-2-1.0 Build Date: 09-07-2014 13:30:27 Topic IDs: 20768-639593 [Latest]
Last Closed:	2016-04-11 18:43:10 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 Eric Rich 2014-08-04 16:22:55 UTC

Title: Gear Placement Algorithm

Default algorithm process explanation is confusing. 

Describe the issue:

As described setps 1-7 are all about building a set (of which you will), complete step 8, "Randomly choose one of the nodes with the lower levels of active_capacity".

On the face of things (this means), you fill up one node and go to the next!

Customer currently read steps 1-7 as thing that effect where the gear is placed and step 8 is simply picking from what is left (and assume this means round Robbin). 

Suggestions for improvement:

Show this process as a set (picture) with examples using districts regions and zones. 

Additional information:

https://access.redhat.com/documentation/en-US/OpenShift_Enterprise/2/html-single/Administration_Guide/index.html#sect-Gear_Placement_Algorithm

Comment 3 Dan McPherson 2016-04-11 18:20:15 UTC

Is anything left to do here?

Comment 4 Alex Dellapenta 2016-04-11 18:43:10 UTC

No, text updated in:

https://access.redhat.com/documentation/en-US/OpenShift_Enterprise/2/html-single/Deployment_Guide/index.html#sect-Installing_and_Configuring_the_Gear_Placement_Plug-in