doc: fixing documentation structure
[csit.git] / tests / vpp / perf / lb / 2n1l-10ge2p1x710-ethip4-loadbalancer-maglev-ndrpdr.robot
1 # Copyright (c) 2021 Intel and/or its affiliates.
2 # Licensed under the Apache License, Version 2.0 (the "License");
3 # you may not use this file except in compliance with the License.
4 # You may obtain a copy of the License at:
5 #
6 #     http://www.apache.org/licenses/LICENSE-2.0
7 #
8 # Unless required by applicable law or agreed to in writing, software
9 # distributed under the License is distributed on an "AS IS" BASIS,
10 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11 # See the License for the specific language governing permissions and
12 # limitations under the License.
13
14 *** Settings ***
15 | Resource | resources/libraries/robot/shared/default.robot
16 |
17 | Force Tags | 2_NODE_SINGLE_LINK_TOPO | PERFTEST | HW_ENV | NDRPDR
18 | ... | NIC_Intel-X710 | ETH | IP4 | LOADBALANCER_MAGLEV | DRV_VFIO_PCI
19 | ... | RXQ_SIZE_0 | TXQ_SIZE_0
20 | ... | ethip4-loadbalancer-maglev
21 |
22 | Suite Setup | Setup suite topology interfaces | performance
23 | Suite Teardown | Tear down suite | performance
24 | Test Setup | Setup test | performance
25 | Test Teardown | Tear down test | performance
26 |
27 | Test Template | Local Template
28 |
29 | Documentation | **RFC2544: Pkt throughput loadbalancer maglev test cases**
30 | ... |
31 | ... | - **[Top] Network Topologies:** TG-DUT1-TG 2-node circular topology \
32 | ... | with single links between nodes.
33 | ... |
34 | ... | - **[Enc] Packet Encapsulations:** Eth-IPv4-UDP for LoadBalancer maglev.
35 | ... |
36 | ... | - **[Cfg] DUT configuration:** DUT1 is configured with LoadBalancer \
37 | ... | maglev and one static IPv4 /24 route entries. DUT1 tested with \
38 | ... | with ${nic_name}.
39 | ... |
40 | ... | - **[Ver] TG verification:** TG finds and reports throughput NDR (Non \
41 | ... | Drop Rate) with zero packet loss tolerance and throughput PDR \
42 | ... | (Partial Drop Rate) with non-zero packet loss tolerance (LT) \
43 | ... | expressed in percentage of packets transmitted. NDR and PDR are \
44 | ... | discovered for different Ethernet L2 frame sizes using MLRsearch \
45 | ... | library.
46 | ... | Test packets are generated by TG on links to DUT. TG traffic profile \
47 | ... | contains two L4 flow-groups (maglev use flow-group is only from TG \
48 | ... | to DUT, 6 flows for flow-group) with all packets containing Ethernet \
49 | ... | header, IPv4 header with IP protocol=17 and static payload. MAC \
50 | ... | addresses are matching MAC addresses of the TG node interfaces.
51 | ... |
52 | ... | - **[Ref] Applicable standard specifications:** RFC2544.
53
54 *** Variables ***
55 | @{plugins_to_enable}= | dpdk_plugin.so | perfmon_plugin.so | lb_plugin.so
56 | ${crypto_type}= | ${None}
57 | ${nic_name}= | Intel-X710
58 | ${nic_driver}= | vfio-pci
59 | ${nic_rxq_size}= | 0
60 | ${nic_txq_size}= | 0
61 | ${nic_pfs}= | 2
62 | ${nic_vfs}= | 0
63 | ${osi_layer}= | L3
64 | ${overhead}= | ${0}
65 # Traffic profile:
66 | ${traffic_profile}= | trex-stl-2n-ethip4udp-lb
67 | ${traffic_directions}= | ${1}
68
69 *** Keywords ***
70 | Local Template
71 | | [Documentation]
72 | | ... | - **[Cfg]** DUT runs LoadBalancer maglev config. \
73 | | ... | Each DUT uses ${phy_cores} physical core(s) for worker threads.
74 | | ... | - **[Ver]** Measure NDR and PDR values using MLRsearch algorithm.
75 | |
76 | | ... | *Arguments:*
77 | | ... | - frame_size - Framesize in Bytes in integer or string (IMIX_v4_1).
78 | | ... | Type: integer, string
79 | | ... | - phy_cores - Number of physical cores. Type: integer
80 | | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
81 | |
82 | | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
83 | |
84 | | Set Test Variable | \${frame_size}
85 | |
86 | | Given Set Max Rate And Jumbo
87 | | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
88 | | And Pre-initialize layer driver | ${nic_driver}
89 | | And Apply startup configuration on all VPP DUTs
90 | | When Initialize layer driver | ${nic_driver}
91 | | And Initialize layer interface
92 | | And Initialize loadbalancer maglev
93 | | Then Find NDR and PDR intervals using optimized search
94
95 *** Test Cases ***
96 | 64B-1c-ethip4-loadbalancer-maglev-ndrpdr
97 | | [Tags] | 64B | 1C
98 | | frame_size=${64} | phy_cores=${1}
99
100 | 64B-2c-ethip4-loadbalancer-maglev-ndrpdr
101 | | [Tags] | 64B | 2C
102 | | frame_size=${64} | phy_cores=${2}
103
104 | 64B-4c-ethip4-loadbalancer-maglev-ndrpdr
105 | | [Tags] | 64B | 4C
106 | | frame_size=${64} | phy_cores=${4}
107
108 | 1518B-1c-ethip4-loadbalancer-maglev-ndrpdr
109 | | [Tags] | 1518B | 1C
110 | | frame_size=${1518} | phy_cores=${1}
111
112 | 1518B-2c-ethip4-loadbalancer-maglev-ndrpdr
113 | | [Tags] | 1518B | 2C
114 | | frame_size=${1518} | phy_cores=${2}
115
116 | 1518B-4c-ethip4-loadbalancer-maglev-ndrpdr
117 | | [Tags] | 1518B | 4C
118 | | frame_size=${1518} | phy_cores=${4}
119
120 | 9000B-1c-ethip4-loadbalancer-maglev-ndrpdr
121 | | [Tags] | 9000B | 1C
122 | | frame_size=${9000} | phy_cores=${1}
123
124 | 9000B-2c-ethip4-loadbalancer-maglev-ndrpdr
125 | | [Tags] | 9000B | 2C
126 | | frame_size=${9000} | phy_cores=${2}
127
128 | 9000B-4c-ethip4-loadbalancer-maglev-ndrpdr
129 | | [Tags] | 9000B | 4C
130 | | frame_size=${9000} | phy_cores=${4}
131
132 | IMIX-1c-ethip4-loadbalancer-maglev-ndrpdr
133 | | [Tags] | IMIX | 1C
134 | | frame_size=IMIX_v4_1 | phy_cores=${1}
135
136 | IMIX-2c-ethip4-loadbalancer-maglev-ndrpdr
137 | | [Tags] | IMIX | 2C
138 | | frame_size=IMIX_v4_1 | phy_cores=${2}
139
140 | IMIX-4c-ethip4-loadbalancer-maglev-ndrpdr
141 | | [Tags] | IMIX | 4C
142 | | frame_size=IMIX_v4_1 | phy_cores=${4}