doc: fixing documentation structure
[csit.git] / tests / vpp / perf / ip4 / 2n1l-10ge2p1x710-ethip4udp-nat44ed-h1024-p63-s64512-tput-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 | 2_NODE_SINGLE_LINK_TOPO | PERFTEST | HW_ENV | NDRPDR
18 | ... | NIC_Intel-X710 | ETH | IP4FWD | NAT44 | UDP | UDP_TPUT | DRV_VFIO_PCI
19 | ... | SCALE | HOSTS_1024 | RXQ_SIZE_0 | TXQ_SIZE_0
20 | ... | ethip4udp-nat44ed-h1024-p63-s64512-tput
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 | nat-ed
26 |
27 | Test Template | Local Template
28 |
29 | # TODO CSIT-1765: Unify suite Documentation.
30 | Documentation | **TPUT on lightweight UDP transactions with NAT44ED**
31 | ... |
32 | ... | - **[Top] Network Topologies:** TG-DUT1-TG 2-node circular topology \
33 | ... | with single links between nodes.
34 | ... |
35 | ... | - **[Enc] Packet Encapsulations:** Eth-IPv4-UDP for IPv4 routing.
36 | ... |
37 | ... | - **[Cfg] DUT configuration:** DUT1 is configured with IPv4. \
38 | ... | routing and two static IPv4 /24 route entries. DUT1 is tested with \
39 | ... | with ${nic_name}.
40 | ... |
41 | ... | - **[Ver] TG verification:** TG finds and reports throughput NDR (Non \
42 | ... | Drop Rate) with zero packet loss tolerance and throughput PDR \
43 | ... | (Partial Drop Rate) with non-zero packet loss tolerance (LT) \
44 | ... | expressed in percentage of packets transmitted. NDR and PDR are \
45 | ... | discovered for different Ethernet L2 frame sizes using MLRsearch \
46 | ... | library.
47 | ... | Test packets are generated by TG on links to DUTs. TG traffic profile \
48 | ... | contains client and server ASTF programs, generating packets \
49 | ... | containing Ethernet header, IPv4 header, UDP header and static \
50 | ... | MAC 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 | nat_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}= | L7
64 | ${overhead}= | ${0}
65 # IP settings
66 | ${tg_if1_ip4}= | 10.0.0.2
67 | ${tg_if1_mask}= | ${20}
68 | ${tg_if2_ip4}= | 12.0.0.2
69 | ${tg_if2_mask}= | ${20}
70 | ${dut1_if1_ip4}= | 10.0.0.1
71 | ${dut1_if1_mask}= | ${24}
72 | ${dut1_if2_ip4}= | 12.0.0.1
73 | ${dut1_if2_mask}= | ${24}
74 | ${dest_net}= | 20.0.0.0
75 | ${dest_mask}= | ${22}
76 # NAT settings
77 | ${nat_mode}= | endpoint-dependent
78 | ${in_net}= | 192.168.0.0
79 | ${in_mask}= | ${22}
80 | ${out_net}= | 68.142.68.0
81 | ${out_net_end}= | 68.142.68.0
82 | ${out_mask}= | ${32}
83 # Scale settings
84 | ${n_hosts}= | ${1024}
85 | ${n_ports}= | ${63}
86 | ${n_sessions}= | ${${n_hosts} * ${n_ports}}
87 | ${transaction_scale}= | ${n_sessions}
88 | ${packets_per_transaction_and_direction}= | ${33}
89 # Ramp-up settings
90 | ${ramp_up_rate}= | ${36000}
91 # Traffic profile
92 | ${traffic_profile}= | trex-astf-ethip4udp-${n_hosts}h-pps
93 | ${transaction_type}= | udp_pps
94 | ${disable_latency}= | ${True}
95
96 *** Keywords ***
97 | Local Template
98 | | [Documentation]
99 | | ... | - **[Cfg]** DUT runs NAT44 ${nat_mode} configuration. \
100 | | ... | Each DUT uses ${phy_cores} physical core(s) for worker threads.
101 | | ... | - **[Ver]** Measure NDR and PDR values using MLRsearch algorithm.
102 | |
103 | | ... | *Arguments:*
104 | | ... | - frame_size - Framesize in Bytes in integer or string (IMIX_v4_1).
105 | | ... | Type: integer, string
106 | | ... | - phy_cores - Number of physical cores. Type: integer
107 | | ... | - rxq - Number of RX queues, default value: ${None}. Type: integer
108 | |
109 | | [Arguments] | ${frame_size} | ${phy_cores} | ${rxq}=${None}
110 | |
111 | | Set Test Variable | \${frame_size}
112 | | ${pre_stats}= | Create List
113 | | ... | vpp-clear-stats | vpp-enable-packettrace | vpp-enable-elog
114 | | ... | vpp-clear-runtime
115 | | Set Test Variable | ${pre_stats}
116 | | ${post_stats}= | Create List
117 | | ... | vpp-show-stats | vpp-show-packettrace | vpp-show-elog
118 | | ... | vpp-show-runtime
119 | | Set Test Variable | ${post_stats}
120 | |
121 | | Given Set Max Rate And Jumbo
122 | | And Add worker threads to all DUTs | ${phy_cores} | ${rxq}
123 | | And Pre-initialize layer driver | ${nic_driver}
124 | | And Apply startup configuration on all VPP DUTs
125 | | When Initialize layer driver | ${nic_driver}
126 | | And Initialize layer interface
127 | | And Initialize IPv4 forwarding for NAT44 in circular topology
128 | | And Initialize NAT44 endpoint-dependent mode in circular topology
129 | | Then Send ramp-up traffic
130 | | And Verify NAT44 UDP sessions number on DUT1 node
131 | | And Find NDR and PDR intervals using optimized search
132 | | And Verify NAT44 UDP sessions number on DUT1 node
133
134 *** Test Cases ***
135 | 64B-1c-ethip4udp-nat44ed-h1024-p63-s64512-tput-ndrpdr
136 | | [Tags] | 64B | 1C
137 | | frame_size=${64} | phy_cores=${1}
138
139 | 64B-2c-ethip4udp-nat44ed-h1024-p63-s64512-tput-ndrpdr
140 | | [Tags] | 64B | 2C
141 | | frame_size=${64} | phy_cores=${2}
142
143 | 64B-4c-ethip4udp-nat44ed-h1024-p63-s64512-tput-ndrpdr
144 | | [Tags] | 64B | 4C
145 | | frame_size=${64} | phy_cores=${4}