Revert "fix(jobspec): Delete ipsec nfv density tests"
[csit.git] / docs / tag_documentation.rst
diff --git a/docs/tag_documentation.rst b/docs/tag_documentation.rst
deleted file mode 100644 (file)
index 5c68858..0000000
+++ /dev/null
@@ -1,853 +0,0 @@
-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
-descriptions.
-
-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 two links interconnecting
-    the devices.
-
-.. topic:: 3_NODE_SINGLE_LINK_TOPO
-
-    3 nodes connected in a circular topology with at least one link
-    interconnecting devices.
-
-Objective Tags
---------------
-
-.. topic:: SKIP_PATCH
-
-    Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch)
-    and csit-vpp-verify jobs (i.e. CSIT patch).
-
-.. topic:: SKIP_VPP_PATCH
-
-    Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch).
-
-Environment Tags
-----------------
-
-.. topic:: HW_ENV
-
-    DUTs and TGs are running on bare metal.
-
-.. topic:: VM_ENV
-
-    DUTs and TGs are running in virtual environment.
-
-.. topic:: VPP_VM_ENV
-
-    DUTs with VPP and capable of running Virtual Machine.
-
-NIC Model Tags
---------------
-
-.. topic:: NIC_Intel-X520-DA2
-
-    Intel X520-DA2 NIC.
-
-.. topic:: NIC_Intel-XL710
-
-    Intel XL710 NIC.
-
-.. topic:: NIC_Intel-X710
-
-    Intel X710 NIC.
-
-.. topic:: NIC_Intel-XXV710
-
-    Intel XXV710 NIC.
-
-.. topic:: NIC_Cisco-VIC-1227
-
-    VIC-1227 by Cisco.
-
-.. topic:: NIC_Cisco-VIC-1385
-
-    VIC-1385 by Cisco.
-
-Scaling Tags
-------------
-
-.. topic:: FIB_20K
-
-    2x10,000 entries in single fib table
-
-.. topic:: FIB_200K
-
-    2x100,000 entries in single fib table
-
-.. topic:: FIB_2M
-
-    2x1,000,000 entries in single fib table
-
-.. 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.
-
-.. topic:: SRC_USER_1
-
-    Traffic flow with 1 unique IP (users) in one direction.
-
-.. topic:: SRC_USER_10
-
-    Traffic flow with 10 unique IPs (users) in one direction.
-
-.. topic:: SRC_USER_100
-
-    Traffic flow with 100 unique IPs (users) in one direction.
-
-.. topic:: SRC_USER_1000
-
-    Traffic flow with 1000 unique IPs (users) in one direction.
-
-.. topic:: SRC_USER_2000
-
-    Traffic flow with 2000 unique IPs (users) in one direction.
-
-.. topic:: SRC_USER_4000
-
-    Traffic flow with 4000 unique IPs (users) in one direction.
-
-.. topic:: 100_FLOWS
-
-    Traffic stream with 100 unique flows (10 IPs/users x 10 UDP ports) in one
-    direction.
-
-.. topic:: 10k_FLOWS
-
-    Traffic stream with 10 000 unique flows (10 IPs/users x 1000 UDP ports) in
-    one direction.
-
-.. topic:: 100k_FLOWS
-
-    Traffic stream with 100 000 unique flows (100 IPs/users x 1000 UDP ports) in
-    one direction.
-
-Test Category Tags
-------------------
-
-.. topic:: FUNCTEST
-
-    All functional test cases.
-
-.. topic:: PERFTEST
-
-    All performance test cases.
-
-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:: MRR
-
-    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.
-
-.. topic:: SOAK
-
-    Performance tests using PLRsearch to find the critical load.
-
-.. topic:: RECONF
-
-    Performance tests aimed to measure lost packets (time) when performing
-    reconfiguration while full throughput offered load is applied.
-
-Ethernet Frame Size Tags
-------------------------
-
-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. Generic ethernet or IPv4.
-
-.. topic:: 78B
-
-    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
-
-    IMIX frame sequence (28x 64B, 16x 570B, 4x 1518B) used for test.
-
-.. topic:: 1460B
-
-    1460B frames used for test.
-
-.. topic:: 1480B
-
-    1480B frames used for test.
-
-.. topic:: 1514B
-
-    1514B frames used for test.
-
-.. topic:: 1518B
-
-    1518B frames used for test.
-
-.. topic:: 9000B
-
-    9000B frames used for test.
-
-Test Type Tags
---------------
-
-.. topic:: BASE
-
-    Baseline test cases, no encapsulation, no feature(s) configured in tests.
-
-.. topic:: IP4BASE
-
-    IPv4 baseline test cases, no encapsulation, no feature(s) configured in
-    tests.
-
-.. topic:: IP6BASE
-
-    IPv6 baseline test cases, no encapsulation, no feature(s) configured in
-    tests.
-
-.. topic:: L2XCBASE
-
-    L2XC baseline test cases, no encapsulation, no feature(s) configured in
-    tests.
-
-.. topic:: L2BDBASE
-
-    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.
-
-.. topic:: ENCAP
-
-    Test cases where encapsulation is used. Use also encapsulation tag(s).
-
-.. topic:: FEATURE
-
-    At least one feature is configured in test cases. Use also feature tag(s).
-
-.. topic:: TLDK
-
-    Functional test cases for TLDK.
-
-.. topic:: DMM
-
-    Functional test cases for DMM.
-
-.. topic:: TCP
-
-    Tests which use TCP.
-
-.. topic:: TCP_CPS
-
-    Performance tests which measure connections per second using http requests.
-
-.. topic:: TCP_RPS
-
-    Performance tests which measure requests per second using http requests.
-
-.. topic:: HTTP
-
-    Tests which use HTTP.
-
-.. 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 L2 bridge-domain, L2 MAC static.
-
-.. topic:: L2BDMACLRN
-
-    VPP L2 bridge-domain, L2 MAC learning.
-
-.. topic:: L2XCFWD
-
-    VPP L2 point-to-point cross-connect.
-
-.. topic:: IP4FWD
-
-    VPP IPv4 routed forwarding.
-
-.. topic:: IP6FWD
-
-    VPP IPv6 routed forwarding.
-
-Underlay Tags
--------------
-
-.. topic:: IP4UNRLAY
-
-    IPv4 underlay.
-
-.. topic:: IP6UNRLAY
-
-    IPv6 underlay.
-
-.. topic:: MPLSUNRLAY
-
-    MPLS underlay.
-
-Overlay Tags
-------------
-
-.. topic:: L2OVRLAY
-
-    L2 overlay.
-
-.. topic:: IP4OVRLAY
-
-    IPv4 overlay (IPv4 payload).
-
-.. topic:: IP6OVRLAY
-
-    IPv6 overlay (IPv6 payload).
-
-Tagging Tags
-------------
-
-.. topic:: DOT1Q
-
-    All test cases with dot1q.
-
-.. topic:: DOT1AD
-
-    All test cases with dot1ad.
-
-Encapsulation Tags
-------------------
-
-.. topic:: ETH
-
-    All test cases with base Ethernet (no encapsulation).
-
-.. topic:: LISP
-
-    All test cases with LISP.
-
-.. topic:: LISPGPE
-
-    All test cases with LISP-GPE.
-
-.. topic:: VXLAN
-
-    All test cases with Vxlan.
-
-.. topic:: VXLANGPE
-
-    All test cases with VXLAN-GPE.
-
-.. topic:: GRE
-
-    All test cases with GRE.
-
-.. topic:: IPSEC
-
-    All test cases with IPSEC.
-
-.. topic:: SRv6
-
-    All test cases with Segment routing over IPv6 dataplane.
-
-.. 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 use physical interface(s).
-
-.. topic:: VHOST
-
-    All test cases which uses VHOST.
-
-.. topic:: VHOST_256
-
-    All test cases which uses VHOST with qemu queue size set to 256.
-
-.. topic:: VHOST_1024
-
-    All test cases which uses VHOST with qemu queue size set to 1024.
-
-.. topic:: CFS_OPT
-
-    All test cases which uses VM with optimised scheduler policy.
-
-.. topic:: TUNTAP
-
-    All test cases which uses TUN and TAP.
-
-.. topic:: AFPKT
-
-    All test cases which uses AFPKT.
-
-.. topic:: NETMAP
-
-    All test cases which uses Netmap.
-
-.. topic:: MEMIF
-
-    All test cases which uses Memif.
-
-.. topic:: SINGLE_MEMIF
-
-    All test cases which uses only single Memif connection per DUT. One DUT
-    instance is running in container having one physical interface exposed to
-    container.
-
-.. topic:: LBOND
-
-    All test cases which uses link bonding (BondEthernet interface).
-
-.. topic:: LBOND_DPDK
-
-    All test cases which uses DPDK link bonding.
-
-.. topic:: LBOND_VPP
-
-    All test cases which uses VPP link bonding.
-
-.. topic:: LBOND_MODE_XOR
-
-    All test cases which uses link bonding with mode XOR.
-
-.. topic:: LBOND_MODE_LACP
-
-    All test cases which uses link bonding with mode LACP.
-
-.. topic:: LBOND_LB_L34
-
-    All test cases which uses link bonding with load-balance mode l34.
-
-.. 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.
-
-Feature Tags
-------------
-
-.. topic:: IACLDST
-
-    iACL destination.
-
-.. topic:: COPWHLIST
-
-    COP whitelist.
-
-.. topic:: NAT44
-
-    NAT44 configured and tested.
-
-.. topic:: NAT64
-
-    NAT44 configured and tested.
-
-.. topic:: ACL
-
-    ACL plugin configured and tested.
-
-.. topic:: IACL
-
-    ACL plugin configured and tested on input path.
-
-.. topic:: OACL
-
-    ACL plugin configured and tested on output path.
-
-.. topic:: ACL_STATELESS
-
-    ACL plugin configured and tested in stateless mode (permit action).
-
-.. topic:: ACL_STATEFUL
-
-    ACL plugin configured and tested in stateful mode (permit+reflect action).
-
-.. topic:: ACL1
-
-    ACL plugin configured and tested with 1 not-hitting ACE.
-
-.. topic:: ACL10
-
-    ACL plugin configured and tested with 10 not-hitting ACEs.
-
-.. topic:: ACL50
-
-    ACL plugin configured and tested with 50 not-hitting ACEs.
-
-.. topic:: SRv6_PROXY
-
-    SRv6 endpoint to SR-unaware appliance via proxy.
-
-.. topic:: SRv6_PROXY_STAT
-
-    SRv6 endpoint to SR-unaware appliance via static proxy.
-
-.. topic:: SRv6_PROXY_DYN
-
-    SRv6 endpoint to SR-unaware appliance via dynamic proxy.
-
-.. topic:: SRv6_PROXY_MASQ
-
-    SRv6 endpoint to SR-unaware appliance via masquerading proxy.
-
-Encryption Tags
----------------
-
-.. topic:: IPSECSW
-
-    Crypto in software.
-
-.. topic:: IPSECHW
-
-    Crypto in hardware.
-
-.. topic:: IPSECTRAN
-
-    IPSec in transport mode.
-
-.. topic:: IPSECTUN
-
-    IPSec in tunnel mode.
-
-.. 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 at least one virtual machine.
-
-.. topic:: LXC
-
-    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.
-
-.. topic:: APP
-
-    All test cases with specific APP use.
-
-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.
-
-.. topic:: 1VNF
-
-    1 VPP running in Docker container acting as VNF work load.
-
-.. topic:: 2VNF
-
-    2 VPP running in 2 Docker containers acting as VNF work load.
-
-.. topic:: 4VNF
-
-    4 VPP running in 4 Docker containers acting as VNF work load.
-
-Multi-Threading Tags
---------------------
-
-.. topic:: STHREAD
-
-   *Dynamic tag*.
-   All test cases using single poll mode thread.
-
-.. topic:: MTHREAD
-
-   *Dynamic tag*.
-    All test cases using more then one poll mode driver thread.
-
-.. topic:: 1NUMA
-
-    All test cases with packet processing on single socket.
-
-.. topic:: 2NUMA
-
-    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*.
-    1 worker thread pinned to 1 dedicated physical core. 1 receive queue per
-    interface. Main thread pinned to core 1.
-
-.. topic:: 2T2C
-
-   *Dynamic tag*.
-    2 worker threads pinned to 2 dedicated physical cores. 1 receive queue per
-    interface. Main thread pinned to core 1.
-
-.. topic:: 4T4C
-
-   *Dynamic tag*.
-    4 worker threads pinned to 4 dedicated physical cores. 2 receive queues per
-    interface. Main thread pinned to core 1.
-
-.. topic:: 2T1C
-
-   *Dynamic tag*.
-    2 worker threads each pinned to a separate logical core within 1 dedicated
-    physical core. 1 receive queue per interface. Main thread pinned to core 1.
-
-.. topic:: 4T2C
-
-   *Dynamic tag*.
-    4 worker threads each pinned to a separate logical core within 2 dedicated
-    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 cores. 4 receive queues per interface. Main thread pinned to core
-    1.
-
-Honeycomb Tags
---------------
-
-.. topic:: HC_FUNC
-
-    Honeycomb functional test cases.
-
-.. topic:: HC_NSH
-
-    Honeycomb NSH test cases.
-
-.. topic:: HC_PERSIST
-
-    Honeycomb persistence test cases.
-
-.. topic:: HC_REST_ONLY
-
-    (Exclusion tag) Honeycomb test cases that cannot be run in Netconf mode
-    using ODL client for Restfconf -> Netconf translation.