openstack/openstack-manuals
Code Issues Proposed changes

Merge "Adds openvswitch-datapath-dkms package install for Ubuntu"

Browse Source
This commit is contained in:
Jenkins 2013-11-13 16:01:40 +00:00 committed by Gerrit Code Review
commit 4711f68e90
1 changed files with 47 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
doc/install-guide/section_neutron-install.xml
View File

@ -413,52 +413,59 @@ use_namespaces = True</programlisting>
<programlisting language="ini">core_plugin = neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2</programlisting> <programlisting language="ini">core_plugin = neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2</programlisting>
</step> </step>
<step> <step>
<para>Choose a networking technology to create the virtual <para>Choose a networking technology to create the virtual networks.
networks. Neutron supports GRE tunneling, VLANs, and Neutron supports GRE tunneling, VLANs, and VXLANs. This guide
VXLANs. This guide shows how to configure GRE tunneling shows how to configure GRE tunneling and VLANs.</para>
and VLANs.</para>
<para> <para>
<link linkend="install-neutron.install-plug-in.ovs.gre" <link linkend="install-neutron.install-plug-in.ovs.gre">GRE
>GRE tunneling</link> is simpler to set up because it tunneling</link> is simpler to set up because it does not
does not require any special configuration from any require any special configuration from any physical network
physical network hardware. However, its protocol makes hardware. However, its protocol makes it difficult to filter
it difficult to filter traffic on the physical network. traffic on the physical network. Additionally, this configuration
Additionally, this configuration does not use does not use namespaces. You can have only one router for each
namespaces. You can have only one router for each network node. However, you can enable namespacing, and potentially
network node. However, you can enable namespacing, and veth, as described in the section detailing how to use VLANs with
potentially veth, as described in the section detailing <acronym>OVS</acronym>).</para>
how to use VLANs with <acronym>OVS</acronym>).</para> <note os="ubuntu">
<para>On Ubuntu 12.04 LTS with GRE you must install
openvswitch-datapath-dkms and restart the service to enable the
GRE flow so that OVS 1.10 and higher is used. Make sure you are
running the OVS 1.10 kernel module in addition to the OVS 1.10
userspace. Both the kernel module and userspace are required for
VXLAN support. The error you see in the
<filename>/var/log/openvswitchovs-vswitchd.log</filename> log
file is "Stderr: 'ovs-ofctl: -1: negative values not supported
for in_port\n'". If you see this error, make sure
<command>modinfo openvswitch</command> shows the right
version. Also check the output from <command>dmesg</command> for
the version of the OVS module being loaded.</para>
</note>
<para>On the other hand, <link <para>On the other hand, <link
linkend="install-neutron.install-plug-in.ovs.vlan" linkend="install-neutron.install-plug-in.ovs.vlan">VLAN
>VLAN tagging</link> modifies the ethernet header of tagging</link> modifies the ethernet header of packets. You can
packets. You can filter packets on the physical network filter packets on the physical network through normal methods.
through normal methods. However, not all NICs handle the However, not all NICs handle the increased packet size of
increased packet size of VLAN-tagged packets well, and VLAN-tagged packets well, and you might need to complete
you might need to complete additional configuration on additional configuration on physical network hardware to ensure
physical network hardware to ensure that your Neutron that your Neutron VLANs do not interfere with any other VLANs on
VLANs do not interfere with any other VLANs on your your network and that any physical network hardware between nodes
network and that any physical network hardware between does not strip VLAN tags.</para>
nodes does not strip VLAN tags.</para>
<note> <note>
<para>While the examples in this guide enable network <para>While the examples in this guide enable network namespaces
namespaces by default, you can disable them if issues by default, you can disable them if issues occur or your kernel
occur or your kernel does not support them. Edit the does not support them. Edit the
<filename>/etc/neutron/l3_agent.ini</filename> and <filename>/etc/neutron/l3_agent.ini</filename> and
<filename>/etc/neutron/dhcp_agent.ini</filename> <filename>/etc/neutron/dhcp_agent.ini</filename> files,
files, respectively:</para> respectively:</para>
<programlisting language="ini">use_namespaces = False</programlisting> <programlisting language="ini">use_namespaces = False</programlisting>
<para>Edit the <para>Edit the <filename>/etc/neutron/neutron.conf</filename> file
<filename>/etc/neutron/neutron.conf</filename> file
to disable overlapping IP addresses:</para> to disable overlapping IP addresses:</para>
<programlisting language="ini">allow_overlapping_ips = False</programlisting> <programlisting language="ini">allow_overlapping_ips = False</programlisting>
<note> <para>Note that when network namespaces are disabled, you can have
<para>With network namespaces disabled, you can have only one router for each network node and overlapping IP
only one router for each network node and addresses are not supported.</para>
overlapping IP addresses are not supported.</para> <para>You must complete additional steps after you create the
</note> initial Neutron virtual networks and router.</para>
<para>You must complete additional steps after you
create the initial Neutron virtual networks and
router.</para>
</note> </note>
</step> </step>
<!-- TODO(sross): support provider networks? you need to modify things above for this to work --> <!-- TODO(sross): support provider networks? you need to modify things above for this to work -->
@ -803,7 +810,7 @@ admin_password=<replaceable>NEUTRON_PASS</replaceable></programlisting>
<step> <step>
<para>Install the Open vSwitch plug-in and its <para>Install the Open vSwitch plug-in and its
dependencies:</para> dependencies:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-openvswitch-agent openvswitch-switch</userinput></screen> <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install neutron-plugin-openvswitch-agent openvswitch-switch openvswitch-datapath-dkms</userinput></screen>
<screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install openstack-neutron-openvswitch</userinput></screen> <screen os="rhel;fedora;centos"><prompt>#</prompt> <userinput>yum install openstack-neutron-openvswitch</userinput></screen>
<screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-neutron-openvswitch-agent</userinput></screen> <screen os="opensuse;sles"><prompt>#</prompt> <userinput>zypper install openstack-neutron-openvswitch-agent</userinput></screen>
</step> </step>