-CSIT TAGs Descriptions
-======================
+CSIT Tags
+=========
All CSIT test cases are labelled with Robot Framework tags used to allow for
easy test case type identification, test case grouping and selection for
-execution. Following sections list currently used CSIT TAGs and their
-documentation.
+execution. Following sections list currently used CSIT tags and their
+descriptions.
-Topology TAGs
--------------
+Testbed Topology Tags
+---------------------
+
+.. topic:: 2_NODE_DOUBLE_LINK_TOPO
+
+ 2 nodes connected in a circular topology with two links interconnecting
+ the devices.
+
+.. topic:: 2_NODE_SINGLE_LINK_TOPO
+
+ 2 nodes connected in a circular topology with at least one link
+ interconnecting devices.
.. topic:: 3_NODE_DOUBLE_LINK_TOPO
3 nodes connected in a circular topology with at least one link
interconnecting devices.
-Objective TAGs
+Objective Tags
--------------
.. topic:: SKIP_PATCH
Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch).
-Environment TAGs
+Environment Tags
----------------
.. topic:: HW_ENV
DUTs with VPP and capable of running Virtual Machine.
-NIC model tags
+NIC Model Tags
--------------
.. topic:: NIC_Intel-X520-DA2
Intel X710 NIC.
+.. topic:: NIC_Intel-XXV710
+
+ Intel XXV710 NIC.
+
.. topic:: NIC_Cisco-VIC-1227
VIC-1227 by Cisco.
VIC-1385 by Cisco.
-Scaling TAGs
+Scaling Tags
------------
.. topic:: FIB_20K
2x1,000,000 entries in single fib table
-.. topic:: TNL_1000
+.. topic:: L2BD_1
+
+ Test with 1 L2 bridge domain.
+
+.. topic:: L2BD_10
+
+ Test with 10 L2 bridge domains.
+
+.. topic:: L2BD_100
+
+ Test with 100 L2 bridge domains.
+
+.. topic:: L2BD_1K
+
+ Test with 1000 L2 bridge domains.
+
+.. topic:: VLAN_1
+
+ Test with 1 VLAN sub-interface.
+
+.. topic:: VLAN_10
+
+ Test with 10 VLAN sub-interfaces.
+
+.. topic:: VLAN_100
+
+ Test with 100 VLAN sub-interfaces.
+
+.. topic:: VLAN_1K
+
+ Test with 1000 VLAN sub-interfaces.
+
+.. topic:: VXLAN_1
+
+ Test with 1 VXLAN tunnel.
+
+.. topic:: VXLAN_10
+
+ Test with 10 VXLAN tunnels.
+
+.. topic:: VXLAN_100
+
+ Test with 100 VXLAN tunnels.
+
+.. topic:: VXLAN_1K
+
+ Test with 1000 VXLAN tunnels.
+
+.. topic:: TNL_{t}
+
+ IPSec in tunnel mode - {t} tunnels.
- IPSec in tunnel mode - 1000 tunnels.
+.. topic:: SRC_USER_1
+
+ Traffic flow with 1 unique IP (users) in one direction.
.. topic:: SRC_USER_10
Traffic stream with 100 000 unique flows (100 IPs/users x 1000 UDP ports) in
one direction.
-Tags marking functional vs. performance of tests
-------------------------------------------------
+Test Category Tags
+------------------
.. topic:: FUNCTEST
All performance test cases.
-Performance testing tags
-------------------------
-
-.. topic:: PDRDISC
-
- Partial Drop Rate evaluation of single run result, with non-zero packet
- loss tolerance (LT) expressed in percentage of packets transmitted.
-
-.. topic:: NDRDISC
-
- Non Drop Rate evaluation of results. Loss acceptance of dropped packets is
- set to zero lost packets.
+Performance Type Tags
+---------------------
.. topic:: NDRPDR
Single test finding both No Drop Rate and Partial Drop Rate simultaneously.
The search is done by optimized algorithm which performs
multiple trial runs at different durations and transmit rates.
+ The results come from the final trials, which have duration of 30 seconds.
-.. topic:: NDRCHK
-
- Performance tests where TG verifies DUTs' throughput at ref-NDR (reference
- Non Drop Rate) with zero packet loss tolerance.
+.. topic:: MRR
-.. topic:: PDRCHK
+ Performance tests where TG sends the traffic at maximum rate (line rate)
+ and reports total sent/received packets over trial duration.
+ The result is an average of 10 trials of 1 second duration.
- Performance tests where TG verifies DUTs' throughput at ref-PDR (reference
- Partial Drop Rate) with 0.5% loss tolerance.
+.. topic:: SOAK
-.. topic:: MRR
+ Performance tests using PLRsearch to find the critical load.
- Performance tests where TG sends the traffic at maximum rate (line rate)
- and reports total sent/received packets over performance trial duration.
+.. topic:: RECONF
-.. topic:: NDRPDRDISC
+ Performance tests aimed to measure lost packets (time) when performing
+ reconfiguration while full throughput offered load is applied.
- Find performance of DUT based on :rfc:`2544` with linear / binary / combined
- search. (Previous LONG tests.)
+Ethernet Frame Size Tags
+------------------------
-Ethernet frame size tags for performance tests
-----------------------------------------------
+These are describing the traffic offered by Traffic Generator,
+"primary" traffic in case of asymmetric load.
+For traffic between DUTs, or for "secondary" traffic, see ${overhead} value.
.. topic:: 64B
- 64B frames used for test.
+ 64B frames used for test. Generic ethernet or IPv4.
.. topic:: 78B
- 78B frames used for test.
+ 78B frames used for test. Ipv6.
+
+.. topic:: 114B
+
+ 114B frames used for test. IPv4+vxlan.
+
+.. topic:: 118B
+
+ 118B frames used for test. Dot1q+IPv4+vxlan.
.. topic:: IMIX
9000B frames used for test.
-Test type tags
+Test Type Tags
--------------
.. topic:: BASE
L2BD baseline test cases, no encapsulation, no feature(s) configured in
tests.
+.. topic:: L2PATCH
+
+ L2PATCH baseline test cases, no encapsulation, no feature(s) configured in
+ tests.
+
.. topic:: SCALE
Scale test cases.
Tests which use HTTP.
-Forwarding mode tags
+.. topic:: NF_DENSITY
+
+ Performance tests that measure throughput of multiple VNF and CNF
+ service topologies at different service densities.
+
+NF Service Density Tags
+-----------------------
+
+.. topic:: CHAIN
+
+ NF service density tests with VNF or CNF service chain topology(ies).
+
+.. topic:: PIPE
+
+ NF service density tests with CNF service pipeline topology(ies).
+
+.. topic:: NF_L3FWDIP4
+
+ NF service density tests with DPDK l3fwd IPv4 routing as NF workload.
+
+.. topic:: NF_VPPIP4
+
+ NF service density tests with VPP IPv4 routing as NF workload.
+
+.. topic:: {r}R{c}C
+
+ Service density matrix locator {r}R{c}C, {r}Row denoting number of
+ service instances, {c}Column denoting number of NFs per service
+ instance. {r}=(1,2,4,6,8,10), {c}=(1,2,4,6,8,10).
+
+.. topic:: {n}VM{t}T
+
+ Service density {n}VM{t}T, {n}Number of NF Qemu VMs, {t}Number of threads
+ per NF.
+
+.. topic:: {n}DCRt}T
+
+ Service density {n}DCR{t}T, {n}Number of NF Docker containers, {t}Number of
+ threads per NF.
+
+.. topic:: {n}_ADDED_CHAINS
+
+ {n}Number of chains (or pipelines) added (and/or removed)
+ during RECONF test.
+
+Forwarding Mode Tags
--------------------
.. topic:: L2BDMACSTAT
VPP IPv6 routed forwarding.
-Underlay tags
+.. topic:: LOADBALANCER_MAGLEV
+
+ VPP Load balancer maglev mode.
+
+.. topic:: LOADBALANCER_L3DSR
+
+ VPP Load balancer l3dsr mode.
+
+.. topic:: LOADBALANCER_NAT4
+
+ VPP Load balancer nat4 mode.
+
+Underlay Tags
-------------
.. topic:: IP4UNRLAY
MPLS underlay.
-Overlay tags
+Overlay Tags
------------
.. topic:: L2OVRLAY
IPv6 overlay (IPv6 payload).
-Tagging tags
+Tagging Tags
------------
.. topic:: DOT1Q
All test cases with dot1ad.
-Encapsulation tags
+Encapsulation Tags
------------------
.. topic:: ETH
All test cases with LISP-GPE.
+.. topic:: LISP_IP4o4
+
+ All test cases with LISP_IP4o4.
+
+.. topic:: LISPGPE_IP4o4
+
+ All test cases with LISPGPE_IP4o4.
+
+.. topic:: LISPGPE_IP6o4
+
+ All test cases with LISPGPE_IP6o4.
+
+.. topic:: LISPGPE_IP4o6
+
+ All test cases with LISPGPE_IP4o6.
+
+.. topic:: LISPGPE_IP6o6
+
+ All test cases with LISPGPE_IP6o6.
+
.. topic:: VXLAN
All test cases with Vxlan.
All test cases with Segment routing over IPv6 dataplane.
-Interface tags
+.. topic:: SRv6_1SID
+
+ All SRv6 test cases with single SID.
+
+.. topic:: SRv6_2SID_DECAP
+
+ All SRv6 test cases with two SIDs and with decapsulation.
+
+.. topic:: SRv6_2SID_NODECAP
+
+ All SRv6 test cases with two SIDs and without decapsulation.
+
+Interface Tags
--------------
.. topic:: PHY
All test cases which uses link bonding with load-balance mode l34.
-Feature tags
+.. topic:: LBOND_1L
+
+ All test cases which uses one link for link bonding.
+
+.. topic:: LBOND_2L
+
+ All test cases which uses two links for link bonding.
+
+.. topic:: DRV_AVF
+
+ All test cases which uses Intel Adaptive Virtual Function (AVF) device
+ plugin for VPP. This plugins provides native device support for Intel AVF.
+ AVF is driver specification for current and future Intel Virtual Function
+ devices. In essence, today this driver can be used only with Intel
+ XL710 / X710 / XXV710 adapters.
+
+.. topic:: DRV_VFIO_PCI
+
+ All test cases which uses vfio-pci device driver. It supports variety of NIC
+ adapters.
+
+.. topic:: DRV_RDMA_CORE
+
+ All test cases which uses rdma-core device driver. It supports Mellanox
+ NIC adapters.
+
+Feature Tags
------------
.. topic:: IACLDST
SRv6 endpoint to SR-unaware appliance via masquerading proxy.
-Encryption tags
+Encryption Tags
---------------
.. topic:: IPSECSW
IPSec in tunnel mode.
-Client-workload tags
+.. topic:: IPSECINT
+
+ IPSec in interface mode.
+
+.. topic:: AES
+
+ IPSec using AES algorithms.
+
+.. topic:: AES_128_CBC
+
+ IPSec using AES 128 CBC algorithms.
+
+.. topic:: AES_128_GCM
+
+ IPSec using AES 128 GCM algorithms.
+
+.. topic:: AES_256_GCM
+
+ IPSec using AES 256 GCM algorithms.
+
+.. topic:: HMAC
+
+ IPSec using HMAC integrity algorithms.
+
+.. topic:: HMAC_SHA_256
+
+ IPSec using HMAC SHA 256 integrity algorithms.
+
+.. topic:: HMAC_SHA_512
+
+ IPSec using HMAC SHA 512 integrity algorithms.
+
+Client-Workload Tags
--------------------
.. topic:: VM
All test cases which use Linux container and LXC utils.
+.. topic:: DRC
+
+ All test cases which use at least one Docker container.
+
.. topic:: DOCKER
All test cases which use Docker as container manager.
All test cases with specific APP use.
-Container orchestration tags
+Container Orchestration Tags
----------------------------
-.. topic:: K8S
-
- All test cases which use Kubernetes for orchestration.
-
-.. topic:: SFC_CONTROLLER
-
- All test cases which use ligato/sfc_controller for driving configuration
- of vpp inside container.
-
-.. topic:: VPP_AGENT
-
- All test cases which use Golang implementation of a control/management plane
- for VPP
-
.. topic:: 1VSWITCH
VPP running in Docker container acting as VSWITCH.
4 VPP running in 4 Docker containers acting as VNF work load.
-Multi-threading tags
+Multi-Threading Tags
--------------------
.. topic:: STHREAD
All test cases with packet processing on two sockets.
+.. topic:: 1C
+
+ 1 worker thread pinned to 1 dedicated physical core; or if HyperThreading is
+ enabled, 2 worker threads each pinned to a separate logical core within 1
+ dedicated physical core. Main thread pinned to core 1.
+
+.. topic:: 2C
+
+ 2 worker threads pinned to 2 dedicated physical cores; or if HyperThreading
+ is enabled, 4 worker threads each pinned to a separate logical core within 2
+ dedicated physical cores. Main thread pinned to core 1.
+
+.. topic:: 4C
+
+ 4 worker threads pinned to 4 dedicated physical cores; or if HyperThreading
+ is enabled, 8 worker threads each pinned to a separate logical core within 4
+ dedicated physical cores. Main thread pinned to core 1.
+
.. topic:: 1T1C
*Dynamic tag*.
*Dynamic tag*.
4 worker threads each pinned to a separate logical core within 2 dedicated
- physical core. 2 receive queue per interface. Main thread pinned to core 1.
+ physical cores. 2 receive queues per interface. Main thread pinned to core
+ 1.
.. topic:: 8T4C
*Dynamic tag*.
8 worker threads each pinned to a separate logical core within 4 dedicated
- physical core. 4 receive queue per interface. Main thread pinned to core 1.
+ physical cores. 4 receive queues per interface. Main thread pinned to core
+ 1.
-Honeycomb tags
+Honeycomb Tags
--------------
.. topic:: HC_FUNC
Code Review / csit.git / blobdiff