Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1669231

Summary:	Need to ensure that rhel-registration/ folder content is updated also during the upgrade process
Product:	Red Hat OpenStack	Reporter:	Jose Luis Franco <jfrancoa>
Component:	documentation	Assignee:	RHOS Documentation Team <rhos-docs>
Status:	CLOSED EOL	QA Contact:	Dan Macpherson <dmacpher>
Severity:	high	Docs Contact:
Priority:	high
Version:	13.0 (Queens)	CC:	joflynn, jpretori, kgilliga, rhos-docs, ykarel
Target Milestone:	---	Keywords:	ZStream
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-03-30 13:15:02 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:	1664617
Bug Blocks:

Description Jose Luis Franco 2019-01-24 16:41:34 UTC

Description of problem:
Following the documentation steps, if you deploy an osp12 environment you will take the content from the undercloud heat templates directory /usr/share/openstack-tripleo-heat-templates/extraconfig/pre_deploy/rhel-registration and copy it into ~/templates, as stated in:
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/advanced_overcloud_customization/#registering_the_overcloud_with_an_environment_file

When the time to upgrade your environment to osp13, if you follow the steps, it only specifies to update certain parameters from your ~/rhel-registration/environment-rhel-registration.yaml environment file:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/upgrading_red_hat_openstack_platform/assembly-preparing_for_overcloud_upgrade#upgrading_the_overcloud_registration_details

However, the content of that folder belongs still to osp12 templates, while you already have osp13 templates in your undercloud. This combination doesn't work correctly at the time of registering the nodes, and the upgrade will fail because the nodes didn't get registered into osp13 repositories from Satellite.

We need to make sure (either by including it in Prerequisites or as an additional step in Procedure) that we copy the new rhel-registration resource files/scripts from the osp13 templates we have in the undercloud. Some helpful command could be:

cp -r /usr/share/openstack-tripleo-heat-templates/extraconfig/pre_deploy/rhel-registration/rhel-registration* /usr/share/openstack-tripleo-heat-templates/extraconfig/pre_deploy/rhel-registration/scripts/ ~/templates/rhel-registration/

This way you don't need to fill in again all the registration parameters of ~/templates/rhel-registration/environment-rhel-registration.yaml but you'll get the right files.

The rest of the steps could remain the same.

Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:

Out of date rhel-registration/ scripts and templates when performing the upgrade, which ends up in a failed upgrade from OSP12 to OSP13.

Expected results:

The user updates the content of the files in ~/templates/rhel-registration/ and the upgrade successfully finishes.

Additional info:

Comment 1 Jose Luis Franco 2019-04-24 13:50:50 UTC

This bugzilla https://bugzilla.redhat.com/show_bug.cgi?id=1664617 won't take effect until the documentation isn't updated as the templates won't be correctly updated and therefore the upgrade will fail. Is there a way I could help moving this BZ forward?

Comment 2 Jesse Pretorius 2020-11-16 15:14:08 UTC

A short guide to comparing user-space and updated product templates needs to be added to help users change their templates before going ahead with the upgrade.