openstack/openstack-manuals
Code Issues Proposed changes

IBM SDN-VE does not need the l3 agent

Browse Source 
Add the IBM SDN-VE plug-in to the listings.

Add this plug-in to the list of plugins that do not need
neutron-l3-agent to work. Also reorder this list alphabetically.

Change-Id: Ia475a16e1345e15a93fd11ba7ddb56a47a84eac9
Closes-Bug: #1337023
This commit is contained in:
Gauvain Pocentek 2014-07-12 15:11:55 +02:00
parent f71d8c45ba
commit f2a3d42aaa
1 changed files with 46 additions and 41 deletions

87
doc/admin-guide-cloud/networking/section_networking_introduction.xml

@ -407,15 +407,13 @@ enabled = True</programlisting>
</thead>
<tbody>
<tr>
<td><emphasis role="bold">Big Switch Plug-in
(Floodlight REST Proxy)</emphasis></td>
<td><emphasis role="bold">Big Switch (Floodlight REST Proxy)</emphasis></td>
<td>This guide and <link
xlink:href="http://www.openflowhub.org/display/floodlightcontroller/Neutron+REST+Proxy+Plugin"
>http://www.openflowhub.org/display/floodlightcontroller/Neutron+REST+Proxy+Plugin</link></td>
</tr>
<tr>
<td><emphasis role="bold">Brocade
Plug-in</emphasis></td>
<td><emphasis role="bold">Brocade</emphasis></td>
<td>This guide and <link
xlink:href="https://wiki.openstack.org/wiki/Brocade-neutron-plugin"
>https://wiki.openstack.org/wiki/Brocade-neutron-plugin</link></td>
@ -427,49 +425,48 @@ enabled = True</programlisting>
>http://wiki.openstack.org/cisco-neutron</link></td>
</tr>
<tr>
<td><emphasis role="bold">Cloudbase Hyper-V
Plug-in</emphasis></td>
<td><emphasis role="bold">Cloudbase Hyper-V</emphasis></td>
<td><link
xlink:href="http://www.cloudbase.it/quantum-hyper-v-plugin/"
>http://www.cloudbase.it/quantum-hyper-v-plugin/</link></td>
</tr>
<tr>
<td><emphasis role="bold">Linux Bridge
Plug-in</emphasis></td>
<td><emphasis role="bold">IBM SDN-VE</emphasis></td>
<td><link
xlink:href="https://wiki.openstack.org/wiki/IBM-Neutron"
>https://wiki.openstack.org/wiki/IBM-Neutron</link></td>
</tr>
<tr>
<td><emphasis role="bold">Linux Bridge</emphasis></td>
<td><link
xlink:href="http://wiki.openstack.org/Quantum-Linux-Bridge-Plugin"
>http://wiki.openstack.org/Neutron-Linux-Bridge-Plugin</link></td>
</tr>
<tr>
<td><emphasis role="bold">Mellanox
Plug-in</emphasis></td>
<td><emphasis role="bold">Mellanox</emphasis></td>
<td><link
xlink:href="https://wiki.openstack.org/wiki/Mellanox-Neutron/"
>https://wiki.openstack.org/wiki/Mellanox-Neutron/</link></td>
</tr>
<tr>
<td><emphasis role="bold">Midonet
Plug-in</emphasis></td>
<td><emphasis role="bold">Midonet</emphasis></td>
<td><link xlink:href="http://www.midokura.com/"
>http://www.midokura.com/</link></td>
</tr>
<tr>
<td><emphasis role="bold">ML2 (Modular Layer 2)
Plug-in</emphasis></td>
<td><emphasis role="bold">ML2 (Modular Layer 2)</emphasis></td>
<td><link
xlink:href="https://wiki.openstack.org/wiki/Neutron/ML2"
>https://wiki.openstack.org/wiki/Neutron/ML2</link></td>
</tr>
<tr>
<td><emphasis role="bold">NEC OpenFlow
Plug-in</emphasis></td>
<td><emphasis role="bold">NEC OpenFlow</emphasis></td>
<td><link
xlink:href="https://wiki.openstack.org/wiki/Neutron/NEC_OpenFlow_Plugin"
>https://wiki.openstack.org/wiki/Neutron/NEC_OpenFlow_Plugin</link></td>
</tr>
<tr>
<td><emphasis role="bold">Open vSwitch
Plug-in</emphasis></td>
<td><emphasis role="bold">Open vSwitch</emphasis></td>
<td>This guide.</td>
</tr>
<tr>
@ -479,16 +476,14 @@ enabled = True</programlisting>
>https://https://wiki.openstack.org/wiki/PLUMgrid-Neutron</link></td>
</tr>
<tr>
<td><emphasis role="bold">Ryu
Plug-in</emphasis></td>
<td><emphasis role="bold">Ryu</emphasis></td>
<td>This guide and <link
xlink:href="https://github.com/osrg/ryu/wiki/OpenStack"
>https://github.com/osrg/ryu/wiki/OpenStack</link></td>
</tr>
<tr>
<!-- TODO: update support link, when available -->
<td><emphasis role="bold">VMware NSX
Plug-in</emphasis></td>
<td><emphasis role="bold">VMware NSX</emphasis></td>
<td>This guide and <link
xlink:href="http://www.vmware.com/nsx">NSX
Product Overview</link>, <link
@ -539,7 +534,7 @@ enabled = True</programlisting>
</thead>
<tbody>
<tr>
<td>Big Switch / Floodlight</td>
<td>Big Switch (Floodlight REST Proxy)</td>
<td>Yes</td>
<td/>
<td/>
@ -570,6 +565,14 @@ enabled = True</programlisting>
<td>Yes</td>
<td/>
</tr>
<tr>
<td>IBM SDN-VE</td>
<td>Yes</td>
<td/>
<td/>
<td/>
<td/>
</tr>
<tr>
<td>Linux Bridge</td>
<td>Yes</td>
@ -595,7 +598,7 @@ enabled = True</programlisting>
<td/>
</tr>
<tr>
<td>ML2</td>
<td>ML2 (Modular Layer 2)</td>
<td>Yes</td>
<td/>
<td/>
@ -619,7 +622,7 @@ enabled = True</programlisting>
<td/>
</tr>
<tr>
<td>Plumgrid</td>
<td>PLUMgrid</td>
<td>Yes</td>
<td/>
<td>Yes</td>
@ -653,8 +656,7 @@ enabled = True</programlisting>
These sections explain how to configure specific
plug-ins.</para>
<section xml:id="bigswitch_floodlight_plugin">
<title>Configure Big Switch, Floodlight REST Proxy
plug-in</title>
<title>Configure Big Switch (Floodlight REST Proxy) plug-in</title>
<procedure>
<title>To use the REST Proxy plug-in with
OpenStack Networking</title>
@ -1137,7 +1139,7 @@ password = "PLUMgrid-director-admin-password"</programlisting>
class="service">nova-compute</systemitem> and nodes
that run dedicated OpenStack Networking service agents
such as <systemitem>neutron-dhcp-agent</systemitem>,
<systemitem>neutron-l3-agent</systemitem>,
<systemitem class="service">neutron-l3-agent</systemitem>,
<systemitem>neutron-metering-agent</systemitem> or
<systemitem>neutron-lbaas-agent</systemitem>.</para>
<para>A data-forwarding node typically has a network interface
@ -1412,9 +1414,6 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
implement the L3 functionality. However, the following
plug-ins already have built-in L3 capabilities:</para>
<itemizedlist>
<listitem>
<para>NSX plug-in</para>
</listitem>
<listitem>
<para>Big Switch/Floodlight plug-in, which
supports both the open source <link
@ -1429,13 +1428,19 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
available.</para>
</note>
</listitem>
<listitem>
<para>IBM SDN-VE plug-in</para>
</listitem>
<listitem>
<para>NSX plug-in</para>
</listitem>
<listitem>
<para>PLUMgrid plug-in</para>
</listitem>
</itemizedlist>
<warning>
<para>Do not configure or use
<filename>neutron-l3-agent</filename> if you
<systemitem class="service">neutron-l3-agent</systemitem> if you
use one of these plug-ins.</para>
</warning>
<procedure>
@ -1443,13 +1448,13 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
plug-ins</title>
<step>
<para>Install the
<systemitem>neutron-l3-agent</systemitem>
<systemitem class="service">neutron-l3-agent</systemitem>
binary on the network node:</para>
<screen><prompt>#</prompt> <userinput>apt-get install neutron-l3-agent</userinput></screen>
</step>
<step>
<para>To uplink the node that runs
<systemitem>neutron-l3-agent</systemitem>
<systemitem class="service">neutron-l3-agent</systemitem>
to the external network, create a bridge named
"br-ex" and attach the NIC for the external
network to this bridge.</para>
@ -1460,7 +1465,7 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
<para>Do not manually configure an IP address on
the NIC connected to the external network for
the node running
<systemitem>neutron-l3-agent</systemitem>.
<systemitem class="service">neutron-l3-agent</systemitem>.
Rather, you must have a range of IP addresses
from the external network that can be used by
OpenStack Networking for routers that uplink
@ -1471,12 +1476,12 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
</step>
<step>
<para>The
<systemitem>neutron-l3-agent</systemitem>
<systemitem class="service">neutron-l3-agent</systemitem>
uses the Linux IP stack and iptables to
perform L3 forwarding and NAT. In order to
support multiple routers with potentially
overlapping IP addresses,
<systemitem>neutron-l3-agent</systemitem>
<systemitem class="service">neutron-l3-agent</systemitem>
defaults to using Linux network namespaces to
provide isolated forwarding contexts. As a
result, the IP addresses of routers are not
@ -1519,7 +1524,7 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
<title>Configure metering agent</title>
<para>Starting with the Havana release, the Neutron
Metering resides beside
<systemitem>neutron-l3-agent</systemitem>.</para>
<systemitem class="service">neutron-l3-agent</systemitem>.</para>
<procedure>
<title>To install the metering agent and configure the
node</title>
@ -1584,14 +1589,14 @@ interface_driver = neutron.agent.linux.interface.OVSInterfaceDriver</programlist
<para>Enable the
<productname>HAProxy</productname> plug-in
by using the <option>service_provider</option>
parameter in the
option in the
<filename>/etc/neutron/neutron.conf</filename>
file:</para>
<programlisting language="ini">service_provider = LOADBALANCER:Haproxy:neutron.services.loadbalancer.drivers.haproxy.plugin_driver.HaproxyOnHostPluginDriver:default</programlisting>
</step>
<step>
<para>Enable the load-balancing plug-in using
<option>service_plugin</option> in the
<para>Enable the load-balancing plug-in by using the
<option>service_plugin</option> option in the
<filename>/etc/neutron/neutron.conf</filename>
file:</para>
<programlisting language="ini">service_plugins = neutron.services.loadbalancer.plugin.LoadBalancerPlugin</programlisting>