doc: fixing documentation structure
[csit.git] / tests / vpp / perf / ip4_tunnels / 10ge2p1x710-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-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 | L2BDMACLRN | SCALE | L2BD_1K | DOT1Q | VLAN_1K
19 | ... | ENCAP | VXLAN | L2OVRLAY | IP4UNRLAY | VXLAN_1K | DRV_VFIO_PCI
20 | ... | RXQ_SIZE_0 | TXQ_SIZE_0
21 | ... | dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan
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
27 |
28 | Test Template | Local Template
29 |
30 | Documentation | **RFC2544: Pkt throughput L2BD with IEEE 802.1Q and \
31 | ... | VXLANoIPv4 test cases**
32 | ... |
33 | ... | - **[Top] Network Topologies:** TG-DUT1-DUT2-TG 3-node circular \
34 | ... | topology with single links between nodes.
35 | ... |
36 | ... | - **[Enc] Packet Encapsulations:** Eth-Dot1Q-IPv4 for L2 switching of \
37 | ... | IPv4. \
38 | ... | on TG-DUTn. Eth-IPv4-VXLAN-Eth-IPv4 is applied on link between DUTs.
39 | ... |
40 | ... | - **[Cfg] DUT configuration:** DUT1 and DUT2 are configured with 1k L2 \
41 | ... | bridge domains. VXLAN tunnels are configured between L2BDs on DUT1 and \
42 | ... | DUT2. DUT1 and DUT2 are tested with ${nic_name}.
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 links to DUTs. TG traffic profile \
51 | ... | contains two L3 flow-groups (flow-group per direction, up to 64,5k \
52 | ... | flows per flow-group) with all packets containing Ethernet header, \
53 | ... | IEEE \
54 | ... | 802.1Q header, IPv4 header with IP protocol=61 and static payload. \
55 | ... | MAC addresses are matching MAC addresses of the TG node interfaces.
56 | ... |
57 | ... | - **[Ref] Applicable standard specifications:** RFC2544, RFC7348.
58
59 *** Variables ***
60 | @{plugins_to_enable}= | dpdk_plugin.so | perfmon_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}= | ${50}
70 # Traffic profile:
71 | ${traffic_profile}= | trex-stl-3n-dot1qip4-vlan1kip4src254ip4dst254
72 # Number of VXLAN tunnels
73 | ${vxlan_count}= | ${1000}
74
75 *** Keywords ***
76 | Local Template
77 | | [Documentation]
78 | | ... | - **[Cfg]** Each DUT runs L2BD forwarding config with VLAN and \
79 | | ... | VXLAN and uses ${phy_cores} physical core(s) for worker threads.
80 | | ... | - **[Ver]** Measure NDR and PDR values using MLRsearch algorithm.
81 | |
82 | | ... | *Arguments:*
83 | | ... | - frame_size - Framesize in Bytes in integer or string (IMIX_v4_1).
84 | | ... | Type: integer, string
85 | | ... | - phy_cores - Number of physical cores. Type: integer
86 | | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
87 | |
88 | | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
89 | |
90 | | Set Test Variable | \${frame_size}
91 | |
92 | | Given Set Max Rate And Jumbo
93 | | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
94 | | And Pre-initialize layer driver | ${nic_driver}
95 | | And Apply startup configuration on all VPP DUTs
96 | | When Initialize layer driver | ${nic_driver}
97 | | And Initialize layer interface
98 | | And Initialize L2 bridge domain with VLAN and VXLANoIPv4 in 3-node circular topology
99 | | ... | vxlan_count=${vxlan_count}
100 | | Then Find NDR and PDR intervals using optimized search
101
102 *** Test Cases ***
103 | 64B-1c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
104 | | [Tags] | 64B | 1C
105 | | frame_size=${64} | phy_cores=${1}
106
107 | 64B-2c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
108 | | [Tags] | 64B | 2C
109 | | frame_size=${64} | phy_cores=${2}
110
111 | 64B-4c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
112 | | [Tags] | 64B | 4C
113 | | frame_size=${64} | phy_cores=${4}
114
115 | 1518B-1c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
116 | | [Tags] | 1518B | 1C
117 | | frame_size=${1518} | phy_cores=${1}
118
119 | 1518B-2c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
120 | | [Tags] | 1518B | 2C
121 | | frame_size=${1518} | phy_cores=${2}
122
123 | 1518B-4c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
124 | | [Tags] | 1518B | 4C
125 | | frame_size=${1518} | phy_cores=${4}
126
127 | 9000B-1c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
128 | | [Tags] | 9000B | 1C
129 | | frame_size=${9000} | phy_cores=${1}
130
131 | 9000B-2c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
132 | | [Tags] | 9000B | 2C
133 | | frame_size=${9000} | phy_cores=${2}
134
135 | 9000B-4c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
136 | | [Tags] | 9000B | 4C
137 | | frame_size=${9000} | phy_cores=${4}
138
139 | IMIX-1c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
140 | | [Tags] | IMIX | 1C
141 | | frame_size=IMIX_v4_1 | phy_cores=${1}
142
143 | IMIX-2c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
144 | | [Tags] | IMIX | 2C
145 | | frame_size=IMIX_v4_1 | phy_cores=${2}
146
147 | IMIX-4c-dot1q--ethip4vxlan-l2bdscale1kl2bd1kvlan1kvxlan-ndrpdr
148 | | [Tags] | IMIX | 4C
149 | | frame_size=IMIX_v4_1 | phy_cores=${4}