Bug 1891960
Summary: | [DOCS] OSP NovaIPv6 Parameter description is unspecific and misleading | |||
---|---|---|---|---|
Product: | Red Hat OpenStack | Reporter: | Ben Roose <broose> | |
Component: | documentation | Assignee: | Irina <igallagh> | |
Status: | CLOSED CURRENTRELEASE | QA Contact: | RHOS Documentation Team <rhos-docs> | |
Severity: | low | Docs Contact: | ||
Priority: | unspecified | |||
Version: | 16.1 (Train) | CC: | akaris, dvd, igallagh, ratailor | |
Target Milestone: | z4 | Keywords: | Triaged | |
Target Release: | 16.1 (Train on RHEL 8.2) | |||
Hardware: | Unspecified | |||
OS: | Unspecified | |||
Whiteboard: | ||||
Fixed In Version: | Doc Type: | If docs needed, set a value | ||
Doc Text: | Story Points: | --- | ||
Clone Of: | ||||
: | 1895869 (view as bug list) | Environment: | ||
Last Closed: | 2021-03-30 09:06: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: | ||||
Bug Blocks: | 1895869, 1901794 |
Description
Ben Roose
2020-10-27 18:41:55 UTC
(In reply to Ben Roose from comment #0) > Description of problem: > A customer was asking what is the specific outcome of setting the NovaIPv6 > parameter to true or false on compute nodes. Our formal documentation in the > Overcloud Parameters guides for OSP 10 and beyond on this parameter > currently specify "Enable IPv6 features for OpenStack Compute (nova). The > default value is False." [1] and [2] > > After further investigation, it seems this parameter sets the use_ipv6 > option flag within nova.conf. @Rajesh - can you confirm that is indeed the only thing the `NovaIPv6` parameters does? If so, it needs to be deprecated in anything <= OSP 16, and removed in OSP17+, as the use_ipv6 config option has been removed from Nova. @Irinia - do we need to clone a docs BZ for this? Hi Artom This is a docs BZ. Maybe this issue could be cloned for the engineering work? Thanks Irina An FYI as the engineering and documentation teams work on this BZ: This same customer found in OpenStack Platform 10 that the use_ipv6 option was influencing IPv6 address configuration of an instance with cloud-init. Specifically, setting use_ipv6=false in nova.conf on the underlying compute node stopped cloud-init from correctly configuring the instance IPv6 network information, but once nova.conf was set to use_ipv6=true, cloud-init did correctly configure the instance. After further investigation, it seems there is a bug in OSP 10 which requires use_ipv6=true to be set for IPv6 configuration of instances, as per Stephen Finucane's upstream code change 430910 to patch this bug [1] and [2]. Speaking with Stephen, it would seem this bug patch was not included by Red Hat until OpenStack Platform 12. Regards, Ben References: [1] https://review.opendev.org/#/c/430910/ [2] https://github.com/openstack/nova/commit/c0aef97c49781f2ce0aa93fd33bfac7e68ea5b97#diff-2a0c4c14c71ae11aaebe90f4c81f6dc9dad5fc38d0b8cd3d066209d54595ae90L873 (In reply to Artom Lifshitz from comment #1) > (In reply to Ben Roose from comment #0) > > Description of problem: > > A customer was asking what is the specific outcome of setting the NovaIPv6 > > parameter to true or false on compute nodes. Our formal documentation in the > > Overcloud Parameters guides for OSP 10 and beyond on this parameter > > currently specify "Enable IPv6 features for OpenStack Compute (nova). The > > default value is False." [1] and [2] > > > > After further investigation, it seems this parameter sets the use_ipv6 > > option flag within nova.conf. > > @Rajesh - can you confirm that is indeed the only thing the `NovaIPv6` > parameters does? If so, it needs to be deprecated in anything <= OSP 16, and > removed in OSP17+, as the use_ipv6 config option has been removed from Nova. yes, and it is already removed from puppet-nova in train [1] and from THT in ussuri [2]. so we need to backport the ussuri change to train. [1] https://review.opendev.org/#/c/658403 [2] https://review.opendev.org/#/c/715660/1 I will do the backport ASAP. > @Irinia - do we need to clone a docs BZ for this? To generate the Overcloud Params Guide and the Configuration Reference guide when the backport is complete (aiming for 16.1.4) NovaIPv6 removed from Overcloud Parameter Guide: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/overcloud_parameters/index use_ipv6 marked as DEPRECATED FOR REMOVAL in the Configuration Reference: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/configuration_reference/index |