Network configuration - Linux bridging, OVS, Multi-nic not well documented

Bug #953151 reported by Anne Gentle
20
This bug affects 3 people
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
High
Unassigned

Bug Description

The networking chapter could use more information about these configuration concepts: Linux bridging, OVS, and using multiple NICs.

The chapter output is here:
http://docs.openstack.org/trunk/openstack-compute/admin/content/ch_networking.html

The source is found here:

openstack-manuals/doc/src/docbkx/openstack-compute-admin/computenetworking.xml

Tags: nova
Anne Gentle (annegentle)
Changed in openstack-manuals:
status: New → Fix Committed
status: Fix Committed → Confirmed
importance: Undecided → High
Changed in openstack-manuals:
assignee: nobody → Walter Batterson (wbatterson)
Revision history for this message
Tom Fifield (fifieldt) wrote :

Hi Walter,

Any progress on this one?

Revision history for this message
Marco CONSONNI (marco-consonni) wrote :

Hello,

I strongly agree with the bug reported here: networking configuration is really hard to understand and - consequently - configure.

On the other hand, in my humble opinion, in order to address this point, it would be very beneficial to report very specific points like "this sentence is not clear", "this sentence is in contradiction with that", "this term is not defined", etc...
In this way, bug fixing could be simplified somehow.

Anyway, as I said, I find this section very difficult to understand. Very likely the topic is intrinsically complex but the document doesn't help much.
Only my opinion.

Revision history for this message
Walter Batterson (wbatterson) wrote :

I am getting some additional feedback on this and hope to have a plan of action on how best to address this issue.

Revision history for this message
Anne Gentle (annegentle) wrote :

Multiple nics was addressed with this addition:
http://docs.openstack.org/trunk/openstack-compute/admin/content/using-multi-nics.html

So this bug is 2/3rds done.

I'd like to see "Using OVS" as another added section and "Using Linux Bridging" as another section with diagrams and the corresponding nova-manage or nova commands added for how to connect these networks - think "concept: What is OVS, how is it used in OpenStack Compute, diagrams that show routing" "task:How do I configure Compute to use OVS, How do I ensure VMs are using OVS" and "reference: what are the config options that enable this? what are the corresponding nova or nova-manage commands?"

Yes, this is a very complex topic, only getting more complex with Quantum integration. I'd like to tackle it with:
concept
task
reference

If you can think of what users need you can write new sections addressing OVS and Linux Bridging.

Revision history for this message
Anne Gentle (annegentle) wrote :

Er, 1/3rds done. :)

Revision history for this message
Anne Gentle (annegentle) wrote :

Hi Walter, you can certainly ask on the mailing list to get more information.

You can create a new XML file then do an xi:include in the networking.xml file to get it to display/publish.

Revision history for this message
Anne Gentle (annegentle) wrote :

One additional thought after searching through old mailing list posts at http://openstack.markmail.org, much of the OVS and bridge networking is explained in the openstack-network-connectivity-admin book.

https://github.com/openstack/openstack-manuals/tree/master/doc/src/docbkx/openstack-network-connectivity-admin

So the work on this bug is figuring out what is already written in the above guide and how to integrate it into the Compute admin guide.

Tom Fifield (fifieldt)
Changed in openstack-manuals:
status: Confirmed → Triaged
tags: added: nova
Revision history for this message
Tom Fifield (fifieldt) wrote :
Revision history for this message
Anne Gentle (annegentle) wrote :

In yesterday's doc meeting Walter indicated he could more easily work on storage doc bugs rather that networking ones, so freeing up for others to take.

Changed in openstack-manuals:
assignee: Walter Batterson (wbatterson) → nobody
Revision history for this message
Anne Gentle (annegentle) wrote :

Tom, how can we reach out to the authors of the openvswitch.org content to ask permission to bring it in? I didn't see a way to comment on the site, maybe I'm just missing it.

Anne Gentle (annegentle)
Changed in openstack-manuals:
milestone: none → folsom
summary: Network configuration - Linux bridging, OVS, Multi-nic not well
- documented for Essex
+ documented
Revision history for this message
Tom Fifield (fifieldt) wrote :

Indeed :s

According to WHOIS data, the site is run by Martin Casado. His email is his surname @nicira.com

Failing that:

#openvswitch on irc.freenode.net.

http://mail.openvswitch.org/mailman/listinfo/discuss

Revision history for this message
Robert Kukura (rkukura) wrote :

I will be updating the Quantum Admin Guide content on configuring the openvswitch and linuxbridge plugins under https://bugs.launchpad.net/openstack-manuals/+bug/1058272. That fix will be limited in scope to completing and correcting the details on the configuration variables, so this bug may still be needed.

Revision history for this message
Anne Gentle (annegentle) wrote :

I think we can close this bug. We have:

multi-nic:
http://docs.openstack.org/trunk/openstack-compute/admin/content/using-multi-nics.html
Linux bridging:
http://docs.openstack.org/folsom/openstack-network/admin/content/quantum_server.html
OVS:
http://docs.openstack.org/folsom/openstack-network/admin/content/quantum_server.html

I'll close if if there are no objections to this being covered. We can always keep improving with more specific suggestions.

Tom Fifield (fifieldt)
Changed in openstack-manuals:
status: Triaged → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers