4 All CSIT test cases are labelled with Robot Framework tags used to allow for
5 easy test case type identification, test case grouping and selection for
6 execution. Following sections list currently used CSIT tags and their
12 .. topic:: 2_NODE_DOUBLE_LINK_TOPO
14 2 nodes connected in a circular topology with two links interconnecting
17 .. topic:: 2_NODE_SINGLE_LINK_TOPO
19 2 nodes connected in a circular topology with at least one link
20 interconnecting devices.
22 .. topic:: 3_NODE_DOUBLE_LINK_TOPO
24 3 nodes connected in a circular topology with two links interconnecting
27 .. topic:: 3_NODE_SINGLE_LINK_TOPO
29 3 nodes connected in a circular topology with at least one link
30 interconnecting devices.
37 Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch)
38 and csit-vpp-verify jobs (i.e. CSIT patch).
40 .. topic:: SKIP_VPP_PATCH
42 Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch).
49 DUTs and TGs are running on bare metal.
53 DUTs and TGs are running in virtual environment.
57 DUTs with VPP and capable of running Virtual Machine.
62 .. topic:: NIC_Intel-X520-DA2
66 .. topic:: NIC_Intel-XL710
70 .. topic:: NIC_Intel-X710
74 .. topic:: NIC_Intel-XXV710
78 .. topic:: NIC_Cisco-VIC-1227
82 .. topic:: NIC_Cisco-VIC-1385
91 2x10,000 entries in single fib table
95 2x100,000 entries in single fib table
99 2x1,000,000 entries in single fib table
103 Test with 1 L2 bridge domain.
107 Test with 10 L2 bridge domains.
111 Test with 100 L2 bridge domains.
115 Test with 1000 L2 bridge domains.
119 Test with 1 VLAN sub-interface.
123 Test with 10 VLAN sub-interfaces.
127 Test with 100 VLAN sub-interfaces.
131 Test with 1000 VLAN sub-interfaces.
135 Test with 1 VXLAN tunnel.
139 Test with 10 VXLAN tunnels.
143 Test with 100 VXLAN tunnels.
147 Test with 1000 VXLAN tunnels.
151 IPSec in tunnel mode - {t} tunnels.
153 .. topic:: SRC_USER_1
155 Traffic flow with 1 unique IP (users) in one direction.
157 .. topic:: SRC_USER_10
159 Traffic flow with 10 unique IPs (users) in one direction.
161 .. topic:: SRC_USER_100
163 Traffic flow with 100 unique IPs (users) in one direction.
165 .. topic:: SRC_USER_1000
167 Traffic flow with 1000 unique IPs (users) in one direction.
169 .. topic:: SRC_USER_2000
171 Traffic flow with 2000 unique IPs (users) in one direction.
173 .. topic:: SRC_USER_4000
175 Traffic flow with 4000 unique IPs (users) in one direction.
179 Traffic stream with 100 unique flows (10 IPs/users x 10 UDP ports) in one
184 Traffic stream with 10 000 unique flows (10 IPs/users x 1000 UDP ports) in
187 .. topic:: 100k_FLOWS
189 Traffic stream with 100 000 unique flows (100 IPs/users x 1000 UDP ports) in
192 .. topic:: HOSTS_1024
194 Stateless or stateful traffic stream with 1024 client source IP4 addresses,
195 usually with 63 flow differing in source port number. Could be UDP or TCP.
196 If NAT is used, the clients are inside. Outside IP range can differ.
198 .. topic:: HOSTS_4096
200 Stateless or stateful traffic stream with 4096 client source IP4 addresses,
201 usually with 63 flow differing in source port number. Could be UDP or TCP.
202 If NAT is used, the clients are inside. Outside IP range can differ.
204 .. topic:: HOSTS_16384
206 Stateless or stateful traffic stream with 16384 client source IP4 addresses,
207 usually with 63 flow differing in source port number. Could be UDP or TCP.
208 If NAT is used, the clients are inside. Outside IP range can differ.
210 .. topic:: HOSTS_65536
212 Stateless or stateful traffic stream with 65536 client source IP4 addresses,
213 usually with 63 flow differing in source port number. Could be UDP or TCP.
214 If NAT is used, the clients are inside. Outside IP range can differ.
216 .. topic:: HOSTS_262144
218 Stateless or stateful traffic stream with 262144 client source IP4 addresses
219 usually with 63 flow differing in source port number. Could be UDP or TCP.
220 If NAT is used, the clients are inside. Outside IP range can differ.
227 All functional test cases.
231 All performance test cases.
233 Performance Type Tags
234 ---------------------
238 Single test finding both No Drop Rate and Partial Drop Rate simultaneously.
239 The search is done by optimized algorithm which performs
240 multiple trial runs at different durations and transmit rates.
241 The results come from the final trials, which have duration of 30 seconds.
245 Performance tests where TG sends the traffic at maximum rate (line rate)
246 and reports total sent/received packets over trial duration.
247 The result is an average of 10 trials of 1 second duration.
251 Performance tests using PLRsearch to find the critical load.
255 Performance tests aimed to measure lost packets (time) when performing
256 reconfiguration while full throughput offered load is applied.
258 Ethernet Frame Size Tags
259 ------------------------
261 These are describing the traffic offered by Traffic Generator,
262 "primary" traffic in case of asymmetric load.
263 For traffic between DUTs, or for "secondary" traffic, see ${overhead} value.
267 64B frames used for test. Generic ethernet or IPv4.
271 78B frames used for test. Ipv6.
275 114B frames used for test. IPv4+vxlan.
279 118B frames used for test. Dot1q+IPv4+vxlan.
283 IMIX frame sequence (28x 64B, 16x 570B, 4x 1518B) used for test.
287 1460B frames used for test.
291 1480B frames used for test.
295 1514B frames used for test.
299 1518B frames used for test.
303 9000B frames used for test.
310 Baseline test cases, no encapsulation, no feature(s) configured in tests.
311 No scaling whatsoever, beyond minimum needed for RSS.
315 IPv4 baseline test cases, no encapsulation, no feature(s) configured in
316 tests. Minimal number of routes. Other quantities may be scaled.
320 IPv6 baseline test cases, no encapsulation, no feature(s) configured in
325 L2XC baseline test cases, no encapsulation, no feature(s) configured in
330 L2BD baseline test cases, no encapsulation, no feature(s) configured in
335 L2PATCH baseline test cases, no encapsulation, no feature(s) configured in
340 Scale test cases. Other tags specify which quantities are scaled.
341 Also applies if scaling is set on TG only (e.g. DUT works as IP4BASE).
345 Test cases where encapsulation is used. Use also encapsulation tag(s).
349 At least one feature is configured in test cases. Use also feature tag(s).
353 Tests which use any kind of UDP traffic (STL or ASTF profile).
357 Tests which use any kind of TCP traffic (STL or ASTF profile).
360 TODO: Should we define tags STL and ASTF?
364 Tests which use unidirectional UDP traffic (STL profile only).
368 Tests which use bidirectional UDP traffic (STL profile only).
372 Tests which measure connections per second on minimal UDP pseudoconnections.
373 This implies ASTF traffic profile is used.
374 This tag selects specific output processing in PAL.
378 Tests which measure connections per second on empty TCP connections.
379 This implies ASTF traffic profile is used.
380 This tag selects specific output processing in PAL.
384 Tests which measure packets per second on lightweight UDP transactions.
385 This implies ASTF traffic profile is used.
386 This tag selects specific output processing in PAL.
390 Tests which measure packets per second on lightweight TCP transactions.
391 This implies ASTF traffic profile is used.
392 This tag selects specific output processing in PAL.
396 Tests which use traffic formed of valid HTTP requests (and responses).
399 TODO: Add HTTP tag to the current hoststack tests.
400 TODO: Document other tags already used by hoststack tests.
402 .. topic:: NF_DENSITY
404 Performance tests that measure throughput of multiple VNF and CNF
405 service topologies at different service densities.
407 NF Service Density Tags
408 -----------------------
412 NF service density tests with VNF or CNF service chain topology(ies).
416 NF service density tests with CNF service pipeline topology(ies).
418 .. topic:: NF_L3FWDIP4
420 NF service density tests with DPDK l3fwd IPv4 routing as NF workload.
424 NF service density tests with VPP IPv4 routing as NF workload.
428 Service density matrix locator {r}R{c}C, {r}Row denoting number of
429 service instances, {c}Column denoting number of NFs per service
430 instance. {r}=(1,2,4,6,8,10), {c}=(1,2,4,6,8,10).
434 Service density {n}VM{t}T, {n}Number of NF Qemu VMs, {t}Number of threads
439 Service density {n}DCR{t}T, {n}Number of NF Docker containers, {t}Number of
442 .. topic:: {n}_ADDED_CHAINS
444 {n}Number of chains (or pipelines) added (and/or removed)
450 .. topic:: L2BDMACSTAT
452 VPP L2 bridge-domain, L2 MAC static.
454 .. topic:: L2BDMACLRN
456 VPP L2 bridge-domain, L2 MAC learning.
460 VPP L2 point-to-point cross-connect.
464 VPP IPv4 routed forwarding.
468 VPP IPv6 routed forwarding.
470 .. topic:: LOADBALANCER_MAGLEV
472 VPP Load balancer maglev mode.
474 .. topic:: LOADBALANCER_L3DSR
476 VPP Load balancer l3dsr mode.
478 .. topic:: LOADBALANCER_NAT4
480 VPP Load balancer nat4 mode.
493 .. topic:: MPLSUNRLAY
506 IPv4 overlay (IPv4 payload).
510 IPv6 overlay (IPv6 payload).
517 All test cases with dot1q.
521 All test cases with dot1ad.
528 All test cases with base Ethernet (no encapsulation).
532 All test cases with LISP.
536 All test cases with LISP-GPE.
538 .. topic:: LISP_IP4o4
540 All test cases with LISP_IP4o4.
542 .. topic:: LISPGPE_IP4o4
544 All test cases with LISPGPE_IP4o4.
546 .. topic:: LISPGPE_IP6o4
548 All test cases with LISPGPE_IP6o4.
550 .. topic:: LISPGPE_IP4o6
552 All test cases with LISPGPE_IP4o6.
554 .. topic:: LISPGPE_IP6o6
556 All test cases with LISPGPE_IP6o6.
560 All test cases with Vxlan.
564 All test cases with VXLAN-GPE.
568 All test cases with GRE.
572 All test cases with IPSEC.
576 All test cases with Segment routing over IPv6 dataplane.
580 All SRv6 test cases with single SID.
582 .. topic:: SRv6_2SID_DECAP
584 All SRv6 test cases with two SIDs and with decapsulation.
586 .. topic:: SRv6_2SID_NODECAP
588 All SRv6 test cases with two SIDs and without decapsulation.
595 All test cases which use physical interface(s).
599 All test cases which uses VHOST.
601 .. topic:: VHOST_1024
603 All test cases which uses VHOST DPDK driver with qemu queue size set
608 All test cases which uses VIRTIO native VPP driver.
610 .. topic:: VIRTIO_1024
612 All test cases which uses VIRTIO native VPP driver with qemu queue size set
617 All test cases which uses VM with optimised scheduler policy.
621 All test cases which uses TUN and TAP.
625 All test cases which uses AFPKT.
629 All test cases which uses Netmap.
633 All test cases which uses Memif.
635 .. topic:: SINGLE_MEMIF
637 All test cases which uses only single Memif connection per DUT. One DUT
638 instance is running in container having one physical interface exposed to
643 All test cases which uses link bonding (BondEthernet interface).
645 .. topic:: LBOND_DPDK
647 All test cases which uses DPDK link bonding.
651 All test cases which uses VPP link bonding.
653 .. topic:: LBOND_MODE_XOR
655 All test cases which uses link bonding with mode XOR.
657 .. topic:: LBOND_MODE_LACP
659 All test cases which uses link bonding with mode LACP.
661 .. topic:: LBOND_LB_L34
663 All test cases which uses link bonding with load-balance mode l34.
667 All test cases which uses one link for link bonding.
671 All test cases which uses two links for link bonding.
675 All test cases which uses Intel Adaptive Virtual Function (AVF) device
676 plugin for VPP. This plugins provides native device support for Intel AVF.
677 AVF is driver specification for current and future Intel Virtual Function
678 devices. In essence, today this driver can be used only with Intel
679 XL710 / X710 / XXV710 adapters.
681 .. topic:: DRV_VFIO_PCI
683 All test cases which uses vfio-pci device driver. It supports variety of NIC
686 .. topic:: DRV_RDMA_CORE
688 All test cases which uses rdma-core device driver. It supports Mellanox
691 .. topic:: RXQ_SIZE_{n}
693 All test cases which RXQ size (RX descriptors) are set to {n}. Default is 0,
694 which means VPP (API) default.
696 .. topic:: TXQ_SIZE_{n}
698 All test cases which TXQ size (TX descriptors) are set to {n}. Default is 0,
699 which means VPP (API) default.
714 NAT44 configured and tested.
718 NAT44 configured and tested.
722 ACL plugin configured and tested.
726 ACL plugin configured and tested on input path.
730 ACL plugin configured and tested on output path.
732 .. topic:: ACL_STATELESS
734 ACL plugin configured and tested in stateless mode (permit action).
736 .. topic:: ACL_STATEFUL
738 ACL plugin configured and tested in stateful mode (permit+reflect action).
742 ACL plugin configured and tested with 1 not-hitting ACE.
746 ACL plugin configured and tested with 10 not-hitting ACEs.
750 ACL plugin configured and tested with 50 not-hitting ACEs.
752 .. topic:: SRv6_PROXY
754 SRv6 endpoint to SR-unaware appliance via proxy.
756 .. topic:: SRv6_PROXY_STAT
758 SRv6 endpoint to SR-unaware appliance via static proxy.
760 .. topic:: SRv6_PROXY_DYN
762 SRv6 endpoint to SR-unaware appliance via dynamic proxy.
764 .. topic:: SRv6_PROXY_MASQ
766 SRv6 endpoint to SR-unaware appliance via masquerading proxy.
781 IPSec in transport mode.
785 IPSec in tunnel mode.
789 IPSec in interface mode.
793 IPSec using AES algorithms.
795 .. topic:: AES_128_CBC
797 IPSec using AES 128 CBC algorithms.
799 .. topic:: AES_128_GCM
801 IPSec using AES 128 GCM algorithms.
803 .. topic:: AES_256_GCM
805 IPSec using AES 256 GCM algorithms.
809 IPSec using HMAC integrity algorithms.
811 .. topic:: HMAC_SHA_256
813 IPSec using HMAC SHA 256 integrity algorithms.
815 .. topic:: HMAC_SHA_512
817 IPSec using HMAC SHA 512 integrity algorithms.
824 All test cases which use at least one virtual machine.
828 All test cases which use Linux container and LXC utils.
832 All test cases which use at least one Docker container.
836 All test cases which use Docker as container manager.
840 All test cases with specific APP use.
842 Container Orchestration Tags
843 ----------------------------
847 VPP running in Docker container acting as VSWITCH.
851 1 VPP running in Docker container acting as VNF work load.
855 2 VPP running in 2 Docker containers acting as VNF work load.
859 4 VPP running in 4 Docker containers acting as VNF work load.
867 All test cases using single poll mode thread.
872 All test cases using more then one poll mode driver thread.
876 All test cases with packet processing on single socket.
880 All test cases with packet processing on two sockets.
884 1 worker thread pinned to 1 dedicated physical core; or if HyperThreading is
885 enabled, 2 worker threads each pinned to a separate logical core within 1
886 dedicated physical core. Main thread pinned to core 1.
890 2 worker threads pinned to 2 dedicated physical cores; or if HyperThreading
891 is enabled, 4 worker threads each pinned to a separate logical core within 2
892 dedicated physical cores. Main thread pinned to core 1.
896 4 worker threads pinned to 4 dedicated physical cores; or if HyperThreading
897 is enabled, 8 worker threads each pinned to a separate logical core within 4
898 dedicated physical cores. Main thread pinned to core 1.
903 1 worker thread pinned to 1 dedicated physical core. 1 receive queue per
904 interface. Main thread pinned to core 1.
909 2 worker threads pinned to 2 dedicated physical cores. 1 receive queue per
910 interface. Main thread pinned to core 1.
915 4 worker threads pinned to 4 dedicated physical cores. 2 receive queues per
916 interface. Main thread pinned to core 1.
921 2 worker threads each pinned to a separate logical core within 1 dedicated
922 physical core. 1 receive queue per interface. Main thread pinned to core 1.
927 4 worker threads each pinned to a separate logical core within 2 dedicated
928 physical cores. 2 receive queues per interface. Main thread pinned to core
934 8 worker threads each pinned to a separate logical core within 4 dedicated
935 physical cores. 4 receive queues per interface. Main thread pinned to core