diff --git a/doc/install-guide/section_neutron-install.xml b/doc/install-guide/section_neutron-install.xml
index 54ef7e7cff..16acfaadfa 100644
--- a/doc/install-guide/section_neutron-install.xml
+++ b/doc/install-guide/section_neutron-install.xml
@@ -413,52 +413,59 @@ use_namespaces = True
core_plugin = neutron.plugins.openvswitch.ovs_neutron_plugin.OVSNeutronPluginV2
- Choose a networking technology to create the virtual
- networks. Neutron supports GRE tunneling, VLANs, and
- VXLANs. This guide shows how to configure GRE tunneling
- and VLANs.
+ Choose a networking technology to create the virtual networks.
+ Neutron supports GRE tunneling, VLANs, and VXLANs. This guide
+ shows how to configure GRE tunneling and VLANs.
- GRE tunneling is simpler to set up because it
- does not require any special configuration from any
- physical network hardware. However, its protocol makes
- it difficult to filter traffic on the physical network.
- Additionally, this configuration does not use
- namespaces. You can have only one router for each
- network node. However, you can enable namespacing, and
- potentially veth, as described in the section detailing
- how to use VLANs with OVS).
+ GRE
+ tunneling is simpler to set up because it does not
+ require any special configuration from any physical network
+ hardware. However, its protocol makes it difficult to filter
+ traffic on the physical network. Additionally, this configuration
+ does not use namespaces. You can have only one router for each
+ network node. However, you can enable namespacing, and potentially
+ veth, as described in the section detailing how to use VLANs with
+ OVS).
+
+ 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
+ /var/log/openvswitchovs-vswitchd.log log
+ file is "Stderr: 'ovs-ofctl: -1: negative values not supported
+ for in_port\n'". If you see this error, make sure
+ modinfo openvswitch shows the right
+ version. Also check the output from dmesg for
+ the version of the OVS module being loaded.
+ On the other hand, VLAN tagging modifies the ethernet header of
- packets. You can filter packets on the physical network
- through normal methods. However, not all NICs handle the
- increased packet size of VLAN-tagged packets well, and
- you might need to complete additional configuration on
- physical network hardware to ensure that your Neutron
- VLANs do not interfere with any other VLANs on your
- network and that any physical network hardware between
- nodes does not strip VLAN tags.
+ linkend="install-neutron.install-plug-in.ovs.vlan">VLAN
+ tagging modifies the ethernet header of packets. You can
+ filter packets on the physical network through normal methods.
+ However, not all NICs handle the increased packet size of
+ VLAN-tagged packets well, and you might need to complete
+ additional configuration on physical network hardware to ensure
+ that your Neutron VLANs do not interfere with any other VLANs on
+ your network and that any physical network hardware between nodes
+ does not strip VLAN tags.
- While the examples in this guide enable network
- namespaces by default, you can disable them if issues
- occur or your kernel does not support them. Edit the
+ While the examples in this guide enable network namespaces
+ by default, you can disable them if issues occur or your kernel
+ does not support them. Edit the
/etc/neutron/l3_agent.ini and
- /etc/neutron/dhcp_agent.ini
- files, respectively:
+ /etc/neutron/dhcp_agent.ini files,
+ respectively:use_namespaces = False
- Edit the
- /etc/neutron/neutron.conf file
+ Edit the /etc/neutron/neutron.conf file
to disable overlapping IP addresses:allow_overlapping_ips = False
-
- With network namespaces disabled, you can have
- only one router for each network node and
- overlapping IP addresses are not supported.
-
- You must complete additional steps after you
- create the initial Neutron virtual networks and
- router.
+ Note that when network namespaces are disabled, you can have
+ only one router for each network node and overlapping IP
+ addresses are not supported.
+ You must complete additional steps after you create the
+ initial Neutron virtual networks and router.
@@ -803,7 +810,7 @@ admin_password=NEUTRON_PASSInstall the Open vSwitch plug-in and its
dependencies:
- #apt-get install neutron-plugin-openvswitch-agent openvswitch-switch
+ #apt-get install neutron-plugin-openvswitch-agent openvswitch-switch openvswitch-datapath-dkms#yum install openstack-neutron-openvswitch#zypper install openstack-neutron-openvswitch-agent