From 3cc8efdf5466750334e912ae8efa4cc8c0354edb Mon Sep 17 00:00:00 2001
From: Darragh O'Reilly <dara2002-openstack@yahoo.com>
Date: Tue, 26 Nov 2013 20:00:17 +0000
Subject: [PATCH] Add warning about GRO and Neutron routers

Generic Receive Offload appears to be enabled by default on recent Ubuntu
kernels. It can have a significant impact on download performance when
enabled on a Neutron router interface. This patch warns users about that.

Change-Id: I3d3a560b1db55aabd901f27ad5c7bd5777b300da
Closes-bug: 1252900
---
 doc/install-guide/section_neutron-install.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/install-guide/section_neutron-install.xml b/doc/install-guide/section_neutron-install.xml
index 3ddc72a2700..4a8158ef152 100644
--- a/doc/install-guide/section_neutron-install.xml
+++ b/doc/install-guide/section_neutron-install.xml
@@ -446,6 +446,12 @@ metadata_proxy_shared_secret = <replaceable>METADATA_PASS</replaceable></program
               must set the newly created <literal>br-ex</literal>
               interface to have the IP address that formerly belonged
               to <replaceable>EXTERNAL_INTERFACE</replaceable>.</para>
+            <warning os="ubuntu">
+              <para>Generic Receive Offload (GRO) should not be enabled on
+                    this interface as it can cause severe performance problems.
+                    It can be disabled with the ethtool utility.
+              </para>
+            </warning>
             <para os="rhel;fedora;centos">Edit the
                 <filename>/etc/sysconfig/network-scripts/ifcfg-EXTERNAL_INTERFACE</filename>
               file:</para>