CSIT-215 Improve documentation - performance
[csit.git] / tests / suites / performance / Short_Bridge_Domain_Intel-X520-DA2.robot
index 1e8d666..c6ddbab 100644 (file)
 | ... | L2 | Intel-X520-DA2
 | Suite Teardown | 3-node Performance Suite Teardown
 | Test Setup | Setup all DUTs before test
-| Test Teardown | Run Keyword | Remove startup configuration of VPP from all DUTs
-| Documentation | Minimal throughput acceptance test cases
+| Test Teardown | Run Keywords | Remove startup configuration of VPP from all DUTs
+| ...           | AND          | Show vpp trace dump on all DUTs
+| Documentation | *Reference NDR throughput L2BD verify test cases*
+| ...
+| ... | *[Top] Network Topologies:* TG-DUT1-DUT2-TG 3-node circular topology
+| ... | with single links between nodes.
+| ... | *[Enc] Packet Encapsulations:* Eth-IPv4 for L2 switching of IPv4.
+| ... | *[Cfg] DUT configuration:* DUT1 and DUT2 are configured with L2 bridge-
+| ... | domain and MAC learning enabled. DUT1 and DUT2 tested with 2p10GE NIC
+| ... | X520 Niantic by Intel.
+| ... | *[Ver] TG verification:* In short performance tests, TG verifies
+| ... | DUTs' throughput at ref-NDR (reference Non Drop Rate) with zero packet
+| ... | loss tolerance. Ref-NDR value is periodically updated acording to
+| ... | formula: ref-NDR = 0.9x NDR, where NDR is found in RFC2544 long
+| ... | performance tests for the same DUT configuration. Test packets are
+| ... | generated by TG on links to DUTs. TG traffic profile contains two L3
+| ... | flow-groups (flow-group per direction, 253 flows per flow-group) with
+| ... | all packets containing Ethernet header, IPv4 header with IP protocol=61
+| ... | and generated payload. MAC addresses are matching MAC addresses of the
+| ... | TG node interfaces.
+| ... | *[Ref] Applicable standard specifications:* RFC2544.
 
 *** Test Cases ***
-| 1core VPP passes 64B frames through bridge domain at 2x 3.2Mpps in 3-node topology
+| TC01: Verify 64B ref-NDR at 2x 3.2Mpps - DUT L2BD - 1thread 1core 1rxq
 | | [Documentation]
-| | ... | VPP with 1 core should pass 64B frames through bridge domain
-| | ... | at 2x 3.2Mpps in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 1 thread, 1 phy core, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 64 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 1_THREAD_NOHTT_RXQUEUES_1 | SINGLE_THREAD | NDR
 | | ${framesize}= | Set Variable | 64
 | | ${duration}= | Set Variable | 10
 | | Then  Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                    | ${framesize} | 3-node-bridge
 
-| 1core VPP passes 1518B frames through bridge domain at 2x 812,743pps in 3-node topology
+| TC02: Verify 1518B ref-NDR at 2x 812.74kpps - DUT L2BD - 1thread 1core 1rxq
 | | [Documentation]
-| | ... | VPP with 1 core should pass 1518B frames through bridge domain
-| | ... | at 2x 812,743pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 1 thread, 1 phy core, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 1518 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 1_THREAD_NOHTT_RXQUEUES_1 | SINGLE_THREAD | NDR
 | | ${framesize}= | Set Variable | 1518
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 1core VPP passes 9000B frames through bridge domain at 2x 138,580pps in 3-node topology
+| TC03: Verify 9000B ref-NDR at 2x 138.58kpps - DUT L2BD - 1thread 1core 1rxq
 | | [Documentation]
-| | ... | VPP with 1 core should pass 9000B frames through bridge domain
-| | ... | at 2x 138,580pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 1 thread, 1 phy core, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 9000 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 1_THREAD_NOHTT_RXQUEUES_1 | SINGLE_THREAD | NDR
 | | ${framesize}= | Set Variable | 9000
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 2core VPP with rxqueues 1 passes 64B frames through bridge domain at 2x 6.9Mpps in 3-node topology
+| TC04: Verify 64B ref-NDR at 2x 6.9Mpps - DUT L2BD - 2thread 2core 1rxq
 | | [Documentation]
-| | ... | VPP with 2 cores should pass 64B frames through bridge domain
-| | ... | at 2x 6.9Mpps in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 2 threads, 2 phy cores, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 64 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 2_THREAD_NOHTT_RXQUEUES_1 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 64
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 2core VPP with rxqueues 1 passes 1518B frames through bridge domain at 2x 812,743pps in 3-node topology
+| TC05: Verify 1518B ref-NDR at 2x 812.74kpps - DUT L2BD - 2thread 2core 1rxq
 | | [Documentation]
-| | ... | VPP with 2 cores should pass 1518B frames through bridge domain
-| | ... | at 2x 812,743pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 2 threads, 2 phy cores, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 1518 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 2_THREAD_NOHTT_RXQUEUES_1 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 1518
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 2core VPP with rxqueues 1 passes 9000B frames through bridge domain at 2x 138,580pps in 3-node topology
+| TC06: Verify 9000B ref-NDR at 2x 138.58kpps - DUT L2BD - 2thread 2core 1rxq
 | | [Documentation]
-| | ... | VPP with 2 cores should pass 9000B frames through bridge domain
-| | ... | at 2x 138,580pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 2 threads, 2 phy cores, \
+| | ... | 1 receive queue per NIC port. [Ver] Verify ref-NDR for 9000 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 2_THREAD_NOHTT_RXQUEUES_1 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 9000
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 4core VPP with rxqueues 2 passes 64B frames through bridge domain at 2x 7.4Mpps in 3-node topology
+| TC07: Verify 64B ref-NDR at 2x 7.4Mpps - DUT L2BD - 4thread 4core 2rxq
 | | [Documentation]
-| | ... | VPP with 4 cores and rxqueues 2 should pass 64B frames through bridge
-| | ... | domain at 2x7.4Mpps in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 4 threads, 4 phy cores, \
+| | ... | 2 receive queues per NIC port. [Ver] Verify ref-NDR for 64 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 4_THREAD_NOHTT_RXQUEUES_2 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 64
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 4core VPP with rxqueues 2 passes 1518B frames through bridge domain at 2x 812,743pps in 3-node topology
+| TC08: Verify 1518B ref-NDR at 2x 812.74kpps - DUT L2BD - 4thread 4core 2rxq
 | | [Documentation]
-| | ... | VPP with 4 cores and rxqueues 2 should pass 1518B frames through bridge
-| | ... | domain at 2x 812,743pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 4 threads, 4 phy cores, \
+| | ... | 2 receive queues per NIC port. [Ver] Verify ref-NDR for 1518 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 4_THREAD_NOHTT_RXQUEUES_2 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 1518
 | | ${duration}= | Set Variable | 10
 | | Then Traffic should pass with no loss | ${duration} | ${rate}
 | | ...                                   | ${framesize} | 3-node-bridge
 
-| 4core VPP with rxqueues 2 passes 9000B frames through bridge domain at 2x 138,580pps in 3-node topology
+| TC09: Verify 9000B ref-NDR at 2x 138.58kpps - DUT L2BD - 4thread 4core 2rxq
 | | [Documentation]
-| | ... | VPP with 4 cores and rxqueues 2should pass 9000B frames through bridge
-| | ... | domain at 2x 138,580pps (2x 10Gbps) in 3-node topology.
+| | ... | [Cfg] DUT runs L2BD config with 4 threads, 4 phy cores, \
+| | ... | 2 receive queues per NIC port. [Ver] Verify ref-NDR for 9000 Byte
+| | ... | frames using single trial throughput test.
 | | [Tags] | 4_THREAD_NOHTT_RXQUEUES_2 | MULTI_THREAD | NDR
 | | ${framesize}= | Set Variable | 9000
 | | ${duration}= | Set Variable | 10