Add neutron ml2 plugin info to installation guide

[Robert Kukura]

The ml2 neutron plugin was added in havana, and its installation and configuration needs to be documented in the OpenStack Installation Guide.

The monolithic openvswitch and linuxbridge plugins are being deprecated in havana and removed in icehouse, so the sections on these plugins should warn users of this.

Since the openvswitch and linuxbridge L2 agents are fully supported with the ml2 plugin in havana and going forward, details on these agents needs to be clearly separated from details on the plugins they are used with. We don't want users to think these L2 agents are being deprecated.

Also, sections on configuring the DHCP, L3, LBaaS, and other agents need updates for configuration with the ML2 plugin. Details that are specific to the L2 agent rather than the plugin may also need updates to make this clear.

Finally, the pluggability of the L3 implementation within the ml2 plugin needs to be documented.

Note that updating the neutron demo to use ml2 is covered separately in bug 1230266.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/54644
Committed: http://github.com/openstack/openstack-manuals/commit/280ae5b74e34aa47ed2d95702d366804a077afc3
Submitter: Jenkins
Branch: master

commit 280ae5b74e34aa47ed2d95702d366804a077afc3
Author: sukhdev <email address hidden>
Date: Wed Oct 30 15:04:13 2013 -0700

    Add neutron ML2 plugin info to instalation guid

    fixes bug: 1230276

    Change-Id: I57bb01d491a847fbe2de96c43053d5bf11065954

[Matt Kassawara (ionosphere80)]

Diane,

This patch was reverted. Instead of creating a new bug for adding ML2 to the installation guide, I'd rather mark this existing bug as "In Progress" and associate it with the blueprint.

https://blueprints.launchpad.net/openstack-manuals/+spec/networking-install-guide-improvements

Matt

[Matt Kassawara (ionosphere80)]

Sukhdev,

A group of us are already working on this issue including restructuring the guide to improve usability. Please take a look at the blueprint associated with the project.

https://blueprints.launchpad.net/openstack-manuals/+spec/networking-install-guide-improvements

[Sukhdev Kapur (sukhdev-8)]

Matt,

Sounds good. Let me know if you need any help from me.

Thanks
-Sukhdev

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/79150
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=939e4b0616254c555a4bea5ba47e75ed72fe1c4c
Submitter: Jenkins
Branch: master

commit 939e4b0616254c555a4bea5ba47e75ed72fe1c4c
Author: Martin Lopes <email address hidden>
Date: Sun Mar 9 00:26:23 2014 +1000

    Adds paragraph to ML2 overview

    Adds a paragraph describing the circumstances that made ML2 a necessary
    feature.

    Change-Id: I9b698033ae9dc5acb603d02369914e8f3ca97294
    Partial-Bug: #1230276

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/79228
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=64d97a685e179070a143085996465af0271add38
Submitter: Jenkins
Branch: master

commit 64d97a685e179070a143085996465af0271add38
Author: Martin Lopes <email address hidden>
Date: Mon Mar 10 12:19:14 2014 +1000

    Adds opening sentence to L2 Population section

    Adds opening sentence as an overview of what the L2 Population
    feature offers users.

    Partial-Bug: #1230276
    `

    Change-Id: Idb66658978c1c248132c457e3f78544e1715ea81

[Edgar Magana (emagana)]

This bug should be closed. ML2 information has been added and the following BP will ensure the rest of the missing details are covered:
https://blueprints.launchpad.net/openstack-manuals/+spec/networking-install-guide-improvements

[Matt Kassawara (ionosphere80)]

Addressed in the following patches:

https://review.openstack.org/84780
https://review.openstack.org/84898
https://review.openstack.org/85203