Bug 1631508 - Remove deprecated controller-v6.j2.yaml templates
Summary: Remove deprecated controller-v6.j2.yaml templates
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: openstack-tripleo-heat-templates
Version: 15.0 (Stein)
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: beta
: 16.0 (Train on RHEL 8.1)
Assignee: Dan Sneddon
QA Contact: Gurenko Alex
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-09-20 18:49 UTC by Dan Sneddon
Modified: 2020-02-06 19:06 UTC (History)
4 users (show)

Fixed In Version: openstack-tripleo-heat-templates-0:11.2.1-0.20191004191224.a44e15b.el8ost
Doc Type: Removed functionality
Doc Text:
In Red Hat OpenStack Platform 16.0, the controller-v6.yaml file is removed. The routes that were defined in controller-v6.yaml are now defined in controller.yaml. (The controller.yaml file is a NIC configuration file that is rendered from values set in roles_data.yaml.) Previous versions of Red Hat OpenStack director, included two routes: one for IPv6 on the External network (default) and one for IPv4 on the Control Plane. To use both default routes, make sure that the controller definition in roles_data.yaml contains both networks in default_route_networks (for example, `default_route_networks: ['External', 'ControlPlane']`).
Clone Of:
Environment:
Last Closed: 2020-02-06 14:39:53 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Launchpad 1793581 0 None None None 2018-09-20 18:49:45 UTC
OpenStack gerrit 644662 0 'None' MERGED Remove legacy controller-v6.yaml NIC config templates 2020-03-06 19:55:23 UTC
Red Hat Product Errata RHEA-2020:0283 0 None None None 2020-02-06 14:40:38 UTC

Description Dan Sneddon 2018-09-20 18:49:45 UTC
Description of problem:
Before we started using Jinja to dynamically create NIC config templates, it was necessary to have a separate template for controllers using IPv6. The controller-v6.yaml templates in each of the directories in network/config/* would have an IPv6 default route on the External network and an IPv4 default route on the Control Plane. Now that we generate NIC configs with Jinja, it is only necessary to put both networks in the role config, so these legacy templates are no longer required.

When we started generating these templates with Jinja, we also updated controller-v6.yaml to be generated with Jinja. The original purpose of keeping the controller-v6.yaml templates even after implementing Jinja was to support upgrades. However, it is unlikely that we would find operators using the built-in templates in production, and we can document the new filename in upgrade documentation.

Version-Release number of selected component (if applicable):
Stein/OSP 15

Actual results:
The controller-v6.yaml templates still exist, so that someone upgrading from a previous deployment that uses that template will not have to update their environment files to point to a different file. However, this file is not needed if the user changes to point to controller.yaml instead of controller-v6.yaml in their environment files.

Expected results:
Since we are generating configs with Jinja now, and the controller-v6.yaml is no longer required, it makes sense to require users to use the generated controller.yaml file instead. This will also ensure that the latest features (such as automatic host route inclusion for routed spine/leaf) will be available.

Additional info:
Removing these files will require operators to update which NIC config to use if they are upgrading an IPv6 environment. However, it is unlikely that anyone is using the included controller-v6.yaml without modifications. If the user is using a custom version of this file, they can continue to use that same file.

Comment 1 Dan Sneddon 2019-11-14 16:10:25 UTC
Merged in https://review.opendev.org/#/c/644662/

Comment 5 Bob Fournier 2019-12-12 14:38:35 UTC
Chuck - yes, these example nic files have been removed in OSP-16.

Comment 6 Chuck Copello 2019-12-12 14:56:34 UTC
Excellent; thank you. Updated doc type and made a slight modification to the doc text.

Comment 7 Bob Fournier 2020-01-14 20:58:08 UTC
Verified using compose RHOS_TRUNK-16.0-RHEL-8-20200113.n.0 that these files are no longer available:

$ sudo ls /usr/share/openstack-tripleo-heat-templates/environments/net-bond-with-vlans*
/usr/share/openstack-tripleo-heat-templates/environments/net-bond-with-vlans.j2.yaml
/usr/share/openstack-tripleo-heat-templates/environments/net-bond-with-vlans-no-external.j2.yaml

Comment 9 errata-xmlrpc 2020-02-06 14:39:53 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHEA-2020:0283


Note You need to log in before you can comment on or make changes to this bug.