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_PASS Install 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