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

4 files changed, 77 insertions, 0 deletions

diff --git a/conf/03_traffic.conf b/conf/03_traffic.conf
index 7e3019a0..eb09bf09 100644
--- a/conf/03_traffic.conf
+++ b/conf/03_traffic.conf
@@ -59,6 +59,8 @@ TRAFFICGEN_IXNET_TESTER_RESULT_DIR = ''
 # as the previous one
 TRAFFICGEN_IXNET_DUT_RESULT_DIR = ''
 
+TRAFFICGEN_IXNET_TCL_SCRIPT = 'ixnetrfc2544.tcl'
+
 ###########################################
 # Spirent TestCenter Configuration -- BEGIN
 
diff --git a/conf/integration/01_testcases.conf b/conf/integration/01_testcases.conf
index 99154ad3..5e9fc66d 100644
--- a/conf/integration/01_testcases.conf
+++ b/conf/integration/01_testcases.conf
@@ -35,6 +35,7 @@ INTEGRATION_TESTS = [
         "Deployment": "op2p",
         "biDirectional": False,
         "Tunnel Type": SUPPORTED_TUNNELING_PROTO[0],
+        "Tunnel Operation": "encapsulation",
         "Description": "Overlay Encapsulation Throughput RFC2544 Test",
     },
     {
@@ -43,7 +44,26 @@ INTEGRATION_TESTS = [
         "Deployment": "op2p",
         "biDirectional": False,
         "Tunnel Type": SUPPORTED_TUNNELING_PROTO[0],
+        "Tunnel Operation": "encapsulation",
         "Description": "Overlay Encapsulation Continuous Stream",
     },
+    {
+        "Name": "overlay_p2p_decap_tput",
+        "Traffic Type": "rfc2544",
+        "Deployment": "op2p",
+        "biDirectional": False,
+        "Tunnel Type": SUPPORTED_TUNNELING_PROTO[0],
+        "Tunnel Operation": "decapsulation",
+        "Description": "Overlay Decapsulation Throughput RFC2544 Test",
+    },
+    {
+        "Name": "overlay_p2p_decap_cont",
+        "Traffic Type": "continuous",
+        "Deployment": "op2p",
+        "biDirectional": False,
+        "Tunnel Type": SUPPORTED_TUNNELING_PROTO[0],
+        "Tunnel Operation": "decapsulation",
+        "Description": "Overlay Decapsulation Continuous Stream",
+    },
 ]
 
diff --git a/conf/integration/02_vswitch.conf b/conf/integration/02_vswitch.conf
index 20cec3e6..f2fa0a4c 100644
--- a/conf/integration/02_vswitch.conf
+++ b/conf/integration/02_vswitch.conf
@@ -22,3 +22,6 @@ TUNNEL_EXTERNAL_BRIDGE_IP = '192.168.240.1/24'
 
 # vxlan|gre|geneve
 TUNNEL_TYPE = 'vxlan'
+
+# The receiving NIC of VXLAN traffic
+DUT_NIC1_MAC = '00:1b:21:b3:48:a9'
diff --git a/conf/integration/03_traffic.conf b/conf/integration/03_traffic.conf
index 8bef092a..b59a2d09 100644
--- a/conf/integration/03_traffic.conf
+++ b/conf/integration/03_traffic.conf
@@ -18,3 +18,55 @@ TRAFFICGEN_PORT2_MAC = '02:00:00:00:00:02'
 TRAFFICGEN_PORT1_IP = '1.1.1.1'
 TRAFFICGEN_PORT2_IP = '90.90.90.90'
 
+# To test VXLAN set the ff to ixnetrfc2544v2.tcl
+TRAFFICGEN_IXNET_TCL_SCRIPT = 'ixnetrfc2544v2.tcl'
+
+# VXLAN traffic item
+
+VXLAN_VNI = '99'
+# TEST frame
+# dstmac should be set to the MAC address of the DUT's receiving port
+#VXLAN_FRAME_L2 = {'srcmac':
+#                  '01:02:03:04:05:06',
+#                  'dstmac':
+#                  '00:1b:21:b3:48:a9'}
+
+VXLAN_FRAME_L2 = {'srcmac': '',
+                  'dstmac': '',
+                 }
+
+# FOR IXIA IxExplorer - VXLAN INNER FRAME
+# The following lines can be removed if IXIA support will be dropped:
+# 'protocolpad': 'true',
+# 'protocolpadbytes':
+# '080000000000630006050403020101020304050608004500002e000000004011095bc0a8000ac0a8f0090bb80bb9001a2e93000102030405060708090a0b0c0d0e0f1011',
+# protocolpadbytes contains the following values:
+# VxLAN header with VNI 99 (0x63)
+# Inner SRC 01:02:03:04:05:06
+# Inner DST 06:05:04:03:02:01
+# IP SRC 192.168.0.2
+# IP DST 192.168.240.9
+# SRC port 3000 (0x0BB8)
+# DST port 3001 (0x0BB9)
+# length 26
+# UDP Checksum 0x2E93
+
+VXLAN_FRAME_L3 = {'proto': 'udp',
+                  'packetsize': 64,
+                  'srcip': TRAFFICGEN_PORT1_IP,
+                  'dstip': '',
+                 }
+
+VXLAN_FRAME_l4 = {'srcport': 4789,
+                  'dstport': 4789,
+                  'vni': VXLAN_VNI,
+                  'inner_srcmac': '',
+                  'inner_dstmac': '',
+                  'inner_srcip': '',
+                  'inner_dstip': '',
+                  'inner_proto': 'tcp',
+                  'inner_srcport': 3000,
+                  'inner_dstport': 3001,
+                  'protocolpad': '',
+                  'protocolpadbytes': '',
+                 }