Missing install step for OVS-Self-service networks

[Varun Nair]

I am using Openstack Queens release (on Ubuntu 16.04.4 LTS) and attempting to install the OVS mechanism driver for self-service network creation, as per the official documentation in https://docs.openstack.org/neutron/queens/admin/deploy-ovs-selfservice.html

- [X] This doc is inaccurate in this way: At step 5 of the network node configuration (https://docs.openstack.org/neutron/queens/admin/deploy-ovs-selfservice.html#network-node), the user is asked to create the OVS provider bridge "br-provider". However, following this step, an instruction to add the provider network interface (in the network node) as a port on "br-provider" is missing. As a result, the router namespace, and consequently the VMs created in a self-service network interfaced with the router, will be unable to communicate with the provider network.

- [X] This is a doc addition request.

- [X] I have a fix to the document that I can paste below:
Following step needs to be added after step 5:
ovs-vsctl add-port br-provider PROVIDER_INTERFACE
Replace PROVIDER_INTERFACE with the name of the underlying interface that handles provider networks. For example, eth1

-----------------------------------
Release: 12.0.5.dev39 on 2018-10-31 08:00
SHA: af84349a4cca1bb1dbca9d6444f3c50bbe260683
Source: https://git.openstack.org/cgit/openstack/neutron/tree/doc/source/admin/deploy-ovs-selfservice.rst
URL: https://docs.openstack.org/neutron/queens/admin/deploy-ovs-selfservice.html

[zhaobo (zhaobo6)]

Yeah, we miss a step to attach the associated interface on the ovs bridge. Thank you for raise this

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/616012

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/616012
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=f4089680b507153b99cb8c659eec9f2a09ef3aa6
Submitter: Zuul
Branch: master

commit f4089680b507153b99cb8c659eec9f2a09ef3aa6
Author: Slawek Kaplonski <email address hidden>
Date: Tue Nov 6 22:40:05 2018 +0100

    Add missing step for ovs deploy guides

    There was missing step about adding underlying interface to the
    provider bridge in ovs deployment guides.
    This patch adds this missing step.

    Change-Id: I2ef5f12c469647d7f197cb5db71692e68d23f718
    Closes-Bug: #1801361

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/rocky
Review: https://review.openstack.org/616278

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/queens
Review: https://review.openstack.org/616279

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/616280

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/616280
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=c757992da1094e36bd014acff5eb378453b8fd17
Submitter: Zuul
Branch: stable/pike

commit c757992da1094e36bd014acff5eb378453b8fd17
Author: Slawek Kaplonski <email address hidden>
Date: Tue Nov 6 22:40:05 2018 +0100

    Add missing step for ovs deploy guides

    There was missing step about adding underlying interface to the
    provider bridge in ovs deployment guides.
    This patch adds this missing step.

    Change-Id: I2ef5f12c469647d7f197cb5db71692e68d23f718
    Closes-Bug: #1801361
    (cherry picked from commit f4089680b507153b99cb8c659eec9f2a09ef3aa6)

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/616279
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=d50654234ec5ae3ba6d8a820b63c09d8e505ef0f
Submitter: Zuul
Branch: stable/queens

commit d50654234ec5ae3ba6d8a820b63c09d8e505ef0f
Author: Slawek Kaplonski <email address hidden>
Date: Tue Nov 6 22:40:05 2018 +0100

    Add missing step for ovs deploy guides

    There was missing step about adding underlying interface to the
    provider bridge in ovs deployment guides.
    This patch adds this missing step.

    Change-Id: I2ef5f12c469647d7f197cb5db71692e68d23f718
    Closes-Bug: #1801361
    (cherry picked from commit f4089680b507153b99cb8c659eec9f2a09ef3aa6)

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/616278
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=9882c7939833ec977687c6e68351b63be78f0a6a
Submitter: Zuul
Branch: stable/rocky

commit 9882c7939833ec977687c6e68351b63be78f0a6a
Author: Slawek Kaplonski <email address hidden>
Date: Tue Nov 6 22:40:05 2018 +0100

    Add missing step for ovs deploy guides

    There was missing step about adding underlying interface to the
    provider bridge in ovs deployment guides.
    This patch adds this missing step.

    Change-Id: I2ef5f12c469647d7f197cb5db71692e68d23f718
    Closes-Bug: #1801361
    (cherry picked from commit f4089680b507153b99cb8c659eec9f2a09ef3aa6)

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron 14.0.0.0b1 development milestone.

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron 11.0.7 release.

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron 13.0.3 release.

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron 12.0.6 release.