From 26d5dcc91e9bbf92a28892382094022997d07b5a Mon Sep 17 00:00:00 2001
From: Dino Simeon Madarang <dino.simeonx.madarang@intel.com>
Date: Tue, 26 Jan 2016 13:49:59 +0000
Subject: Add simple VxLAN decapsulation performance test

Measure OVS DPDK VXLAN decapsulation performance.
The DUT is configured as a VTEP (VXLAN Tunnel Endpoint)
which performs decapsulation of frames and sends traffic to
the 2nd traffic generator port.

This test is unidirectional.

Recent changes:
* Userguide update
* Move src/dstport from L2 to L4 (conf, TCL)
* Fix 'TestCase' object has no attribute '_tunnel_operation' error when
  running non overlay tests
* Fix merge conflict
* Move doc to docs/userguide/integration.rst
* Add setting of DUT_NIC1_MAC and setting of other
  variables to docs/userguide/integration.rst

Change-Id: Ia44f8888ef727831543c80f5c98c866686c5c92c
JIRA: VSPERF-190
Signed-off-by: Dino Simeon Madarang <dino.simeonx.madarang@intel.com>
Signed-off-by: Robert Wojciechowicz <robertx.wojciechowicz@intel.com>
Signed-off-by: Timo Puha <timox.puha@intel.com>
Reviewed-by: Maryam Tahhan <maryam.tahhan@intel.com>
Reviewed-by: Billy O Mahony <billy.o.mahony@intel.com>
Reviewed-by: Martin Klozik <martinx.klozik@intel.com>
Reviewed-by: Al Morton <acmorton@att.com>
Reviewed-by: Brian Castelli <brian.castelli@spirent.com
---
 docs/userguide/integration.rst | 47 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

(limited to 'docs/userguide')

diff --git a/docs/userguide/integration.rst b/docs/userguide/integration.rst
index 65b86468..f4120e4e 100755
--- a/docs/userguide/integration.rst
+++ b/docs/userguide/integration.rst
@@ -95,3 +95,50 @@ To run OVS NATIVE tunnel tests (VXLAN/GRE/GENEVE):
      ./vsperf --conf-file user_settings.py --run-integration --test-param 'tunnel_type=vxlan' overlay_p2p_tput
 
 
+Executing VXLAN decapsulation tests
+------------------------------------
+
+To run VXLAN decapsulation tests:
+
+1. Set the variables used in "Executing Tunnel encapsulation tests"
+
+2. Set IXNET_TCL_SCRIPT, VXLAN_FRAME_L2, VLXAN_FRAME_L3 and DUT_NIC1_MAC of your settings file to:
+
+  .. code-block:: console
+
+   IXNET_TCL_SCRIPT='ixnetrfc2544v2.tcl'
+
+   VXLAN_FRAME_L2 = {'srcmac':
+                     '01:02:03:04:05:06',
+                     'dstmac':
+                     '<DUT's NIC1 MAC>',
+                    }
+
+   VXLAN_FRAME_L3 = {'proto': 'udp',
+                     'packetsize': 64,
+                     'srcip': '1.1.1.1',
+                     'dstip': '192.168.240.1',
+                    }
+
+   VXLAN_FRAME_L4 = {'srcport': 4789,
+                     'dstport': 4789,
+                     'vni': VXLAN_VNI,
+                     'inner_srcmac': '01:02:03:04:05:06',
+                     'inner_dstmac': '06:05:04:03:02:01',
+                     'inner_srcip': '192.168.0.10',
+                     'inner_dstip': '192.168.240.9',
+                     'inner_proto': 'udp',
+                     'inner_srcport': 3000,
+                     'inner_dstport': 3001,
+                    }
+
+    # The receiving NIC of VXLAN traffic
+    DUT_NIC1_MAC = '<mac address>'
+
+3. Run test:
+
+  .. code-block:: console
+
+     ./vsperf --conf-file user_settings.py --run-integration overlay_p2p_decap_cont
+
+
-- 
cgit 1.2.3-korg