doc: fixing documentation structure
[csit.git] / tests / vpp / perf / l2 / 10ge2p1x710-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr.robot
1 # Copyright (c) 2021 Cisco 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 | 3_NODE_SINGLE_LINK_TOPO | PERFTEST | HW_ENV | NDRPDR
18 | ... | NIC_Intel-X710 | ETH | L2BDMACLRN | FEATURE | MACIP | ACL_STATELESS
19 | ... | IACL | ACL10 | 100K_FLOWS | DRV_VFIO_PCI
20 | ... | RXQ_SIZE_0 | TXQ_SIZE_0
21 | ... | eth-l2bdbasemaclrn-macip-iacl10sl-100kflows
22 |
23 | Suite Setup | Setup suite topology interfaces | performance
24 | Suite Teardown | Tear down suite | performance
25 | Test Setup | Setup test | performance
26 | Test Teardown | Tear down test | performance | macipacl
27 |
28 | Test Template | Local Template
29 |
30 | Documentation | **RFC2544: Packet throughput L2BD test cases with ACL**
31 | ... |
32 | ... | - **[Top] Network Topologies:** TG-DUT1-DUT2-TG 3-node circular \
33 | ... | topology with single links between nodes.
34 | ... |
35 | ... | - **[Enc] Packet Encapsulations:** Eth-IPv4 for L2 switching of IPv4.
36 | ... |
37 | ... | - **[Cfg] DUT configuration:** DUT1 is configured with L2 bridge \
38 | ... | domain and MAC learning enabled. DUT2 is configured with L2 cross-\
39 | ... | connects. \
40 | ... | Required MACIP ACL rules are applied to input paths of both DUT1 \
41 | ... | addresses of the TG node interfaces. DUT1 and DUT2 are tested with \
42 | ... | 2p10GE NIC X520 Niantic by Intel.
43 | ... |
44 | ... | - **[Ver] TG verification:** TG finds and reports throughput NDR (Non \
45 | ... | Drop Rate) with zero packet loss tolerance and throughput PDR \
46 | ... | (Partial Drop Rate) with non-zero packet loss tolerance (LT) \
47 | ... | expressed in percentage of packets transmitted. NDR and PDR are \
48 | ... | discovered for different Ethernet L2 frame sizes using MLRsearch \
49 | ... | library.
50 | ... | Test packets are generated by TG on \
51 | ... | links to DUTs. TG traffic profile contains two L3 flow-groups \
52 | ... | (flow-group per direction, ${flows_per_dir} flows per flow-group) with \
53 | ... | all packets containing Ethernet header, IPv4 header with IP \
54 | ... | protocol=61 and static payload. MAC addresses are matching MAC \
55 | ... | addresses of the TG node interfaces.
56 | ... |
57 | ... | - **[Ref] Applicable standard specifications:** RFC2544.
58
59 *** Variables ***
60 | @{plugins_to_enable}= | dpdk_plugin.so | perfmon_plugin.so | acl_plugin.so
61 | ${crypto_type}= | ${None}
62 | ${nic_name}= | Intel-X710
63 | ${nic_driver}= | vfio-pci
64 | ${nic_rxq_size}= | 0
65 | ${nic_txq_size}= | 0
66 | ${nic_pfs}= | 2
67 | ${nic_vfs}= | 0
68 | ${osi_layer}= | L2
69 | ${overhead}= | ${0}
70 # ACL test setup
71 | ${acl_action}= | permit
72 | ${no_hit_aces_number}= | 10
73 | ${flows_per_dir}= | 100k
74 # starting points for non-hitting ACLs
75 | ${src_ip_start}= | 30.30.30.1
76 | ${ip_step}= | ${1}
77 | ${src_mac_start}= | 01:02:03:04:05:06
78 | ${src_mac_step}= | ${1000}
79 | ${src_mac_mask}= | 00:00:00:00:00:00
80 | ${tg_stream1_mac}= | ca:fe:00:00:00:00
81 | ${tg_stream2_mac}= | fa:ce:00:00:00:00
82 | ${tg_mac_mask}= | ff:ff:ff:fe:00:00
83 | ${tg_stream1_subnet}= | 10.0.0.0/15
84 | ${tg_stream2_subnet}= | 20.0.0.0/15
85 # traffic profile
86 | ${traffic_profile}= | trex-stl-3n-ethip4-macsrc100kip4src100k
87
88 *** Keywords ***
89 | Local Template
90 | | [Documentation]
91 | | ... | - **[Cfg]** DUT runs IPv4 routing config. \
92 | | ... | Each DUT uses ${phy_cores} physical core(s) for worker threads.
93 | | ... | - **[Ver]** Measure NDR and PDR values using MLRsearch algorithm.
94 | |
95 | | ... | *Arguments:*
96 | | ... | - frame_size - Framesize in Bytes in integer or string (IMIX_v4_1).
97 | | ... | Type: integer, string
98 | | ... | - phy_cores - Number of physical cores. Type: integer
99 | | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
100 | |
101 | | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
102 | |
103 | | Set Test Variable | \${frame_size}
104 | |
105 | | Given Set Max Rate And Jumbo
106 | | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
107 | | And Pre-initialize layer driver | ${nic_driver}
108 | | And Apply Startup configuration on all VPP DUTs
109 | | When Initialize layer driver | ${nic_driver}
110 | | And Initialize layer interface
111 | | And Initialize L2 bridge domain with MACIP ACLs in circular topology
112 | | Then Find NDR and PDR intervals using optimized search
113
114 *** Test Cases ***
115 | 64B-1c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
116 | | [Tags] | 64B | 1C
117 | | frame_size=${64} | phy_cores=${1}
118
119 | 64B-2c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
120 | | [Tags] | 64B | 2C
121 | | frame_size=${64} | phy_cores=${2}
122
123 | 64B-4c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
124 | | [Tags] | 64B | 4C
125 | | frame_size=${64} | phy_cores=${4}
126
127 | 1518B-1c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
128 | | [Tags] | 1518B | 1C
129 | | frame_size=${1518} | phy_cores=${1}
130
131 | 1518B-2c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
132 | | [Tags] | 1518B | 2C
133 | | frame_size=${1518} | phy_cores=${2}
134
135 | 1518B-4c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
136 | | [Tags] | 1518B | 4C
137 | | frame_size=${1518} | phy_cores=${4}
138
139 | 9000B-1c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
140 | | [Tags] | 9000B | 1C
141 | | frame_size=${9000} | phy_cores=${1}
142
143 | 9000B-2c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
144 | | [Tags] | 9000B | 2C
145 | | frame_size=${9000} | phy_cores=${2}
146
147 | 9000B-4c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
148 | | [Tags] | 9000B | 4C
149 | | frame_size=${9000} | phy_cores=${4}
150
151 | IMIX-1c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
152 | | [Tags] | IMIX | 1C
153 | | frame_size=IMIX_v4_1 | phy_cores=${1}
154
155 | IMIX-2c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
156 | | [Tags] | IMIX | 2C
157 | | frame_size=IMIX_v4_1 | phy_cores=${2}
158
159 | IMIX-4c-eth-l2bdbasemaclrn-macip-iacl10sl-100kflows-ndrpdr
160 | | [Tags] | IMIX | 4C
161 | | frame_size=IMIX_v4_1 | phy_cores=${4}