diff mbox series

[ovs-dev] faq: Explain why select groups don't sort out packets evenly.

Message ID 20190308014739.26997-1-blp@ovn.org
State Accepted
Commit edf3a9c34bfb41effdcf459750e35feb6fc23945
Headers show
Series [ovs-dev] faq: Explain why select groups don't sort out packets evenly. | expand

Commit Message

Ben Pfaff March 8, 2019, 1:47 a.m. UTC
This keeps coming up.

Signed-off-by: Ben Pfaff <blp@ovn.org>
---
 Documentation/faq/openflow.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

Comments

Alin Serdean April 3, 2019, 6:46 p.m. UTC | #1
On 8 Mar 2019, at 03:47, Ben Pfaff <blp@ovn.org<mailto:blp@ovn.org>> wrote:

This keeps coming up.

Signed-off-by: Ben Pfaff <blp@ovn.org<mailto:blp@ovn.org>>
Acked-by: Alin Gabriel Serdean <aserdean@ovn.org<mailto:aserdean@ovn.org>>
Ben Pfaff April 15, 2019, 8:28 p.m. UTC | #2
On Wed, Apr 03, 2019 at 06:46:46PM +0000, Alin Serdean wrote:
> 
> 
> On 8 Mar 2019, at 03:47, Ben Pfaff <blp@ovn.org<mailto:blp@ovn.org>> wrote:
> 
> This keeps coming up.
> 
> Signed-off-by: Ben Pfaff <blp@ovn.org<mailto:blp@ovn.org>>
> —
> 
> Acked-by: Alin Gabriel Serdean <aserdean@ovn.org<mailto:aserdean@ovn.org>>

Thanks, applied to master.
diff mbox series

Patch

diff --git a/Documentation/faq/openflow.rst b/Documentation/faq/openflow.rst
index 4a20255daf21..561d793a6692 100644
--- a/Documentation/faq/openflow.rst
+++ b/Documentation/faq/openflow.rst
@@ -478,6 +478,22 @@  Q: How does OVS divide flows among buckets in an OpenFlow "select" group?
     Documentation/group-selection-method-property.txt in the Open vSwitch
     source tree.  (OpenFlow 1.5 support in Open vSwitch is still experimental.)
 
+Q: An OpenFlow "select" group isn't dividing packets evenly among the buckets.
+
+    A: When a packet passes through a "select" group, Open vSwitch hashes a
+    subset of the fields in the packet, then it maps the hash value to a
+    bucket.  This means that packets whose hashed fields are the same will
+    always go to the same bucket[*].  More specifically, if you test with a
+    single traffic flow, only one bucket will receive any traffic[**].
+    Furthermore, statistics and probability mean that testing with a small
+    number of flows may still yield an uneven distribution.
+
+    [*] Unless its bucket has a watch port or group whose liveness changes
+    during the test.
+
+    [**] Unless the hash includes fields that vary within a traffic flow, such
+    as tcp_flags.
+
 Q: I added a flow to accept packets on VLAN 123 and output them on VLAN 456,
 like so::