Update configuration reference for neutron ml2 plugin

Bug #1229237 reported by Robert Kukura
18
This bug affects 3 people
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
High
Justin Hammond

Bug Description

Section 4, OpenStack Networking, of the OpenStack Configuration Reference needs a table containing configuration options for the Modular Layer 2 (ml2) plugin that is new in havana, as well as a table for the configuration options of each ML2 type and mechanism driver. Because the ML2 plugin works with the openvswitch, linuxbridge, and hyperv L2 agents, the configuration items for these L2 agents also need to be broken out into separate tables from their corresponding monolithic plugins.

The following existing tables:

 * Cloudbase Hyper-V Configuration Options
 * Linux Bridge Configuration Options
 * Open vSwitch Configuration Options

should be reorganized/extended to form the following tables:

 * Cloudbase Hyper-V Agent Configuration Options
 * Cloudbase Hyper-V Plugin Configuration Options (possibly deprecated?)
 * Linux Bridge Agent Configuration Options
 * Linux Bridge Plugin Configuration Options (deprecated)
 * Modular Layer 2 Plugin Configuration Options
 * Modular Layer 2 Flat Type Driver Configuration Options
 * Modular Layer 2 GRE Type Driver Configuration Options
 * Modular Layer 2 VLAN Type Driver Configuration Options
 * Modular Layer 2 VXLAN Type Driver Configuration Options
 * Modular Layer 2 Arista Mechanism Driver Configuration Options
 * Modular Layer 2 Cisco Mechanism Driver Configuration Options
 * Modular Layer 2 L2 Population Mechanism Driver Configuration Options
 * Modular Layer 2 Tail-f NCS Mechanism Driver Configuration Options
 * Open vSwitch Agent Configuration Options
 * Open vSwitch Plugin Configuration Options (deprecated)

I would also recommend removing the 5 network_vlan_ranges rows from the existing table 4.1, "Description of configuration options for common", and fixing the name of that table.

Finally, including option group names in the tables and/or the text would be extremely helpful.

Tags: neutron ml2
Robert Kukura (rkukura)
summary: - Update confguration reference for neutron ml2 plugin
+ Update configuration reference for neutron ml2 plugin
tags: added: ml2 neutron
Changed in openstack-manuals:
assignee: nobody → Justin Hammond (justin-hammond)
Revision history for this message
Tom Fifield (fifieldt) wrote :

Thanks for the excellent bug report!

Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → Medium
importance: Medium → High
milestone: none → havana
status: Confirmed → Triaged
Revision history for this message
Justin Hammond (justin-hammond) wrote :

I now understand the existing documentation and generation of the tables. Current step is to move things to the desired format. Finally, perform manual clean up of duplicates.

Changed in openstack-manuals:
status: Triaged → In Progress
Revision history for this message
Justin Hammond (justin-hammond) wrote :

@Robert : what is the difference between what would be an agent configuration option and a plugin option (other than one is used solely in agent/plugin). A vast majority of the configuration options are used in both the plugin and the agent. Would the shared ones be agent or plugin?

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

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

Changed in openstack-manuals:
assignee: Justin Hammond (justin-hammond) → Tom Fifield (fifieldt)
Tom Fifield (fifieldt)
Changed in openstack-manuals:
assignee: Tom Fifield (fifieldt) → Justin Hammond (justin-hammond)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/50715
Committed: http://github.com/openstack/openstack-manuals/commit/3d44dd50c6ee7c297d12afe4048d44bc2450d9c5
Submitter: Jenkins
Branch: master

commit 3d44dd50c6ee7c297d12afe4048d44bc2450d9c5
Author: Justin Hammond <email address hidden>
Date: Wed Oct 9 12:56:56 2013 -0500

    Updates conf reference for neutron ml2 plugin

    Fixes-Bug: 1229237
    Fixes-Bug: 1237662
    Change-Id: I6974ea7d857b5186f39913baf43f3a8c321cc4ba

Changed in openstack-manuals:
status: In Progress → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

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

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/51018
Committed: http://github.com/openstack/openstack-manuals/commit/78371c5e6fcef249f586f2fd3fc8dcf257485b55
Submitter: Jenkins
Branch: master

commit 78371c5e6fcef249f586f2fd3fc8dcf257485b55
Author: Justin Hammond <email address hidden>
Date: Thu Oct 10 14:40:16 2013 -0500

    Updates conf reference for neutron ml2 plugin

    Fixes-Bug: 1229237
    Change-Id: If31627d8f6078fa52a29f77a808ddeea845abc08

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.