Bug 1416565
| Summary: | [Docs][Networking] Document mitigation for microversion issues in device role tagging | ||
|---|---|---|---|
| Product: | Red Hat OpenStack | Reporter: | Stephen Gordon <sgordon> |
| Component: | documentation | Assignee: | Martin Lopes <mlopes> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Dan Macpherson <dmacpher> |
| Severity: | high | Docs Contact: | |
| Priority: | high | ||
| Version: | 10.0 (Newton) | CC: | berrange, dasmith, eglynn, kchamart, lbopf, sbauza, sferdjao, sgordon, srevivo, tvvcox, vromanso |
| Target Milestone: | async | Keywords: | Reopened, ZStream |
| Target Release: | 10.0 (Newton) | ||
| 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: | 2017-12-01 02:33:09 UTC | Type: | --- |
| 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: | 1417686, 1436266 | ||
| Bug Blocks: | |||
|
Description
Stephen Gordon
2017-01-25 20:19:53 UTC
Under Bug # 1188175 (among others) we added a feature called device role tagging in Red Hat OpenStack Platform 10. This is mentioned in the release notes here: https://access.redhat.com/documentation/en/red-hat-openstack-platform/10/paged/release-notes/chapter-3-release-information It was also covered in the networking guide here: https://access.redhat.com/documentation/en/red-hat-openstack-platform/10/single/networking-guide/#use-tagging This feature was added in microversion 2.32 of the Nova API (awesome!) for both block devices and network ports (awesome!) *but* - for block devices it turns out it *only* works in 2.32 - for ports due to a later change in microversion 2.37 it *only* works in microversions 2.32 to 2.37 As part of the gift that keeps on giving, the fix for this is - you guessed it - a new microversion! So we can't actually backport it, instead we need to confirm given an OOTB RHOSP 10 install what microversion are the client and server negotiating to and based on the results of this we need to document: - What if any action is required to work around this issue and still use the feature (e.g. pin the client to 2.32). - Symptoms to look out for to determine if such mitigation is needed now or in the future (e.g. if we later upgrade the client it may become necessary for a user to pin the microversion when they did not in the past). Setting needinfo on Artom as the relevant SME to review the above and provide any further context. Good summary of the issue by Steve. A few things to add: This will go away in RHOS11, since the new microversion 2.42 that fixes all this mess merged just in time for Ocata upstream. There's a downstream-only hack in progress [1] to python-novaclient (and *not* openstackclient) to make it work around this issue as much as it can. Once that's merged, the result should be that the issue will become invisible when using the RHOS novaclient, except when the user requests block device tagging *and* the automatic network feature introduced in 2.37. Those are mutually exclusive, and nothing can be done until version 2.42 arrives in RHOS11. [1] https://code.engineering.redhat.com/gerrit/#/c/96540/ With the fix upstream merged to stable/newton [1], this will be fixed next time the RHOS10 python-openstackclient is rebased from upstream. [1] https://review.openstack.org/#/c/429772/ Ignore comment #3, it was meant for a different bug. Assigning to Martin for review. Working on draft. Note that the dev bug is still in a QA state: BZ#1436266 For docs QE, see the large note here: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html-single/networking_guide/#use-tagging Sorry for the delay on peer reviewing this item. LGTM! |