Networking Guide¶

Problem description¶

Since the Havana release, OpenStack has not had a single guide devoted to understanding and deploying OpenStack Networking. There is some information in other guides, particularly the Cloud Administrators Guide, but no single guide that discusses different networking scenarios and solutions.

Proposed change¶

We should create a Networking Guide, following roughly the outline here:

https://wiki.openstack.org/wiki/NetworkingGuide/TOC

Additionally, a Troubleshooting chapter may be included, subject to time constraints.

The target audience for this information is cloud administrators who have experience with OpenStack administration and general system administration, but who may not be especially knowledgeable about networking concepts.

This document is targeted for the Juno release. It is explicitly documenting current best practices for OpenStack Networking (neutron). It will not document any plug-ins or setups that are deprecated in Juno.

Though the instructions in the guide are for neutron, the introduction should contain a brief discussion on the different options available, including nova-network, what this guide focuses on, and why one would choose those options.

The base architecture uses three nodes: a controller and compute nodes as set up in the Install Guide, plus a network node to run Neutron agents. This is the same architecture used in the Cloud Administrators Guide:

http://docs.openstack.org/admin-guide-cloud/networking_arch.html

It will use the same conventions for naming and services as the Install Guide, many of which are covered on the wiki:

https://wiki.openstack.org/wiki/Documentation/Guide_conventions

Network types to be covered: * Local * VLAN * GRE * VXLAN

Mechanisms to be covered: * Linux Bridge * OVS * Open Daylight * L2 Population * Proprietary (depending on time constraints)

All instructions will use the ML2 plug-in for mechanism drivers. Deprecated plug-ins (for example, for OVS or Linux Bridge) will not be discussed.

Timeline and Events: * docs swarm (2014-08-09) * ops meetup (upcoming) * bug squash day (upcoming)

Implementation¶

The Networking Guide will live alongside other guides in the openstack-manuals repository. There is already some stub content.

Dependencies¶

Need reviewers from Neutron

Testing¶

• Have SMEs review all conceptual information for accuracy.
• Manually test all instructions to ensure they work.

References¶

None