Bug 1437433

Summary: Controller role is required to be the first item in the roles_data.yaml when using composable roles
Product: Red Hat OpenStack Reporter: Marius Cornea <mcornea>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 11.0 (Ocata)CC: aschultz, augol, dasmith, dbecker, dclarke, dmacpher, dprince, mburns, mcornea, morazi, owalsh, rhel-osp-director-maint, sgordon, srevivo
Target Milestone: rc   
Target Release: 11.0 (Ocata)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 1436769 Environment:
Last Closed: 2017-05-18 01:42:33 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:

Comment 1 Marius Cornea 2017-03-30 10:25:26 UTC 
Hi Dan,

Could we please add to the docs that the Controller role needs to be first in the roles_data.yaml file when using composable roles?

Thank you!
Comment 2 Dan Prince 2017-03-30 11:46:49 UTC 
Yes. I can help document this feature. In order to avoid hard coding 'Controller' in various places within the tripleo-heat-templates we created a primary_role mechanism where the first role is used for certain things. Users who edit their own roles_data.yaml files will need to be mindful of this requirement.

We do have comments in some of the t-h-t templates but I can look to find the right places to document this as well.
Comment 4 Dan Macpherson 2017-05-17 03:55:45 UTC 
Added a note to the OSP10 and OSP11 Guides. For example:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html-single/advanced_overcloud_customization/#Examining_Composable_Role_Architecture

The note says:

== Important ==

If creating a custom roles_data.yaml file, the Controller role must always be the first role defined. This role is treated as the primary role. 

===

Marius, anything further required for this BZ?
Comment 5 Marius Cornea 2017-05-17 19:01:40 UTC 
Looks good, thank you!
Comment 6 Dan Macpherson 2017-05-18 01:42:33 UTC 
Thanks, Marius!