725b40bee29daf39af6f78ccf351a590556e8274
[csit.git] / docs / report / vpp_performance_tests / csit_release_notes.rst
1 CSIT Release Notes\r
2 ==================\r
3 \r
4 Changes in CSIT |release|\r
5 -------------------------\r
6 \r
7 #. VPP performance test environment changes\r
8 \r
9     - Further optimizations of VM and vhost-user test environment - Qemu virtio\r
10       queue size increased from default value of 256 to 1024.\r
11     - Addition of HW cryptodev devices - Intel QAT 8950 50G - in all three\r
12       LF FD.io physical testbeds.\r
13 \r
14 #. VPP performance test framework changes\r
15 \r
16     - Added VAT command history collection for every test case as part of\r
17       teardown.\r
18 \r
19 #. Added VPP performance tests\r
20 \r
21     - **CGNAT**\r
22 \r
23       - Carrier Grade Network Address Translation tests with varying number\r
24         of users and ports per user: 1u-15p, 10u-15p, 100u-15p, 1000u-15p,\r
25         2000u-15p, 4000u-15p - with Intel x520 NIC.\r
26 \r
27     - **vhost-user tests with one VM**\r
28 \r
29       - L2 Bridge Domain switched-forwarding with Intel x710 NIC, Intel x520\r
30         NIC, Intel xl710 NIC.\r
31       - VXLAN and L2 Bridge Domain switched-forwarding with Intel x520 NIC.\r
32 \r
33     - **vhost-user tests with two VMs service chain**\r
34 \r
35       - L2 cross-connect switched-forwarding with Intel x520 NIC, Intel xl710\r
36         NIC.\r
37       - L2 Bridge Domain switched-forwarding with Intel x520 NIC, Intel xl710\r
38         NIC.\r
39       - IPv4 routed-forwarding with Intel x520 NIC, Intel xl710 NIC.\r
40 \r
41     - **IPSec encryption with**\r
42 \r
43       - AES-GCM, CBC-SHA1 ciphers, in combination with IPv4 routed-forwarding\r
44         with Intel xl710 NIC.\r
45       - CBC-SHA1 ciphers, in combination with LISP-GPE overlay tunneling for\r
46         IPv4-over-IPv4 with Intel xl710 NIC.\r
47 \r
48 Performance Improvements\r
49 ------------------------\r
50 \r
51 Substantial improvements in measured packet throughput have been\r
52 observed in a number of CSIT |release| tests listed below, with relative\r
53 increase  of double-digit percentage points. Relative improvements are\r
54 calculated against the test results listed in CSIT |release-1| report.\r
55 VPP-16.09 numbers are provided for reference.\r
56 \r
57 NDR Throughput\r
58 ~~~~~~~~~~~~~~\r
59 \r
60 Non-Drop Rate Throughput discovery tests:\r
61 \r
62 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
63 | VPP Functionality | Test Name                                                       | VPP-16.09  | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
64 |                   |                                                                 | [Mpps]     | [Mpps]    | [Mpps]    | Relative Change |\r
65 +===================+=================================================================+============+===========+===========+=================+\r
66 | L2XC-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-ndrdisc       | 0.5        | 2.8       | 3.4       | 21%             |\r
67 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
68 | L2BD-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-ndrdisc | 0.4        | 2.7       | 3.1       | 15%             |\r
69 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
70 | IPv4 vhost        | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-ndrdisc     | 0.3        | 2.6       | 3.0       | 15%             |\r
71 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
72 | IPv4 LISP         | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-ndrdisc             | 4.4        | 4.8       | 5.5       | 15%             |\r
73 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
74 | IPv6              | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-ndrdisc                    | 3.0        | 7.3       | 8.1       | 11%             |\r
75 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
76 | IPv6 COP          | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-ndrdisc     | 6.1        | 6.1       | 6.9       | 13%             |\r
77 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
78 | IPv6 iAcl         | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-ndrdisc        | 6.5        | 6.1       | 6.9       | 13%             |\r
79 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
80 | IPv6 FIB 2M       | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-ndrdisc                 | 5.3        | 4.2       | 4.6       | 10%             |\r
81 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
82 \r
83 PDR Throughput\r
84 ~~~~~~~~~~~~~~\r
85 \r
86 Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
87 \r
88 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
89 | VPP Functionality | Test Name                                                       | VPP-16.09 | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
90 |                   |                                                                 | [Mpps]    | [Mpps]    | [Mpps]    | Relative Change |\r
91 +===================+=================================================================+===========+===========+===========+=================+\r
92 | L2XC-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-pdrdisc       | 2.6       | 3.2       | 3.7       | 15%             |\r
93 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
94 | L2BD-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-pdrdisc | 2.1       | 2.9       | 3.3       | 14%             |\r
95 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
96 | IPv4 vhost        | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-pdrdisc     | 2.0       | 2.7       | 3.0       | 11%             |\r
97 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
98 | IPv4 LISP         | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-pdrdisc             | 4.6       | 4.8       | 5.5       | 15%             |\r
99 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
100 | IPv6              | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-pdrdisc                    | 7.7       | 7.3       | 8.1       | 11%             |\r
101 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
102 | IPv6 COP          | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-pdrdisc     | 6.1       | 6.1       | 6.9       | 13%             |\r
103 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
104 | IPv6 iAcl         | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-pdrdisc        | 6.5       | 6.1       | 6.9       | 13%             |\r
105 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
106 | IPv6 FIB 2M       | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-pdrdisc                 | 5.3       | 4.2       | 4.6       | 10%             |\r
107 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
108 \r
109 Measured improvements are in line with VPP code optimizations listed in\r
110 `VPP-17.04 release notes\r
111 <https://docs.fd.io/vpp/17.04/release_notes_1704.html>`_.\r
112 \r
113 Additionally, vhost-VM performance improvements are due to both VPP code\r
114 optimizations as well as due to the FD.io CSIT Linux KVM test environment\r
115 optimizations for vhost-VM tests - see section "2.1.7. Methodology: KVM VM\r
116 vhost".\r
117 \r
118 \r
119 Other Performance Changes\r
120 -------------------------\r
121 \r
122 Other changes in measured packet throughput, with either minor relative\r
123 increase or decrease, have been observed in a number of CSIT |release|\r
124 tests listed below. Relative changes are calculated against the test\r
125 results listed in CSIT |release-1| report.\r
126 \r
127 NDR Throughput\r
128 ~~~~~~~~~~~~~~\r
129 \r
130 Non-Drop Rate Throughput discovery tests:\r
131 \r
132 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
133 | VPP Functionality | Test Name                                                       | VPP-16.09  | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
134 |                   |                                                                 | [Mpps]     | [Mpps]    | [Mpps]    | Relative Change |\r
135 +===================+=================================================================+============+===========+===========+=================+\r
136 | L2XC              | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-ndrdisc                      | 9.4        | 12.7      | 13.1      | 3%              |\r
137 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
138 | L2XC              | 10ge2p1xl710: 64B-1t1c-eth-l2xcbase-ndrdisc                     | 9.5        | 12.2      | 12.4      | 2%              |\r
139 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
140 | L2XC dot1ad       | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-ndrdisc                   | 7.4        | 8.8       | 9.3       | 6%              |\r
141 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
142 | L2XC dot1q        | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-ndrdisc                    | 7.5        | 8.8       | 9.2       | 5%              |\r
143 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
144 | L2XC VxLAN        | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-ndrdisc              | 5.4        | 6.5       | 6.8       | 5%              |\r
145 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
146 | L2BD              | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-ndrdisc                | 7.8        | 10.4      | 10.8      | 4%              |\r
147 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
148 | IPv4              | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ndrdisc                    | 8.7        | 9.7       | 10.6      | 9%              |\r
149 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
150 | IPv4 COP          | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-ndrdisc     | 7.1        | 8.3       | 9.0       | 8%              |\r
151 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
152 | IPv4 iAcl         | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-ndrdisc        | 6.9        | 7.6       | 8.3       | 9%              |\r
153 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
154 | IPv4 FIB 200k     | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-ndrdisc               | 8.5        | 9.0       | 9.7       | 8%              |\r
155 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
156 | IPv4 FIB 20k      | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-ndrdisc                | 8.5        | 9.0       | 9.7       | 8%              |\r
157 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
158 | IPv4 FIB 2M       | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-ndrdisc                 | 8.5        | 7.8       | 8.1       | 4%              |\r
159 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
160 | IPv4 Policer      | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-ndrdisc    | 6.9        | 7.4       | 8.1       | 9%              |\r
161 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
162 | IPv6 FIB 200k     | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-ndrdisc               | 6.5        | 5.3       | 5.3       | 0%              |\r
163 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
164 | IPv6 FIB 20k      | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-ndrdisc                | 6.9        | 6.5       | 6.9       | 6%              |\r
165 +-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
166 \r
167 PDR Throughput\r
168 ~~~~~~~~~~~~~~\r
169 \r
170 Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
171 \r
172 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
173 | VPP Functionality | Test Name                                                       | VPP-16.09 | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
174 |                   |                                                                 | [Mpps]    | [Mpps]    | [Mpps]    | Relative Change |\r
175 +===================+=================================================================+===========+===========+===========+=================+\r
176 | L2XC              | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-pdrdisc                      | 9.4       | 12.7      | 13.4      | 6%              |\r
177 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
178 | L2XC dot1ad       | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-pdrdisc                   | 7.4       | 8.8       | 9.3       | 6%              |\r
179 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
180 | L2XC dot1q        | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-pdrdisc                    | 7.5       | 8.8       | 9.2       | 5%              |\r
181 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
182 | L2XC VxLAN        | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-pdrdisc              | 5.4       | 6.5       | 6.8       | 5%              |\r
183 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
184 | L2BD              | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-pdrdisc                | 7.8       | 10.6      | 10.8      | 2%              |\r
185 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
186 | IPv4              | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-pdrdisc                    | 8.7       | 9.7       | 10.6      | 9%              |\r
187 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
188 | IPv4 COP          | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-pdrdisc     | 7.1       | 8.3       | 9.2       | 11%             |\r
189 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
190 | IPv4 iAcl         | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-pdrdisc        | 7.1       | 7.6       | 8.3       | 9%              |\r
191 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
192 | IPv4 FIB 200k     | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-pdrdisc               | 8.5       | 9.0       | 9.7       | 8%              |\r
193 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
194 | IPv4 FIB 20k      | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-pdrdisc                | 8.5       | 9.0       | 9.7       | 8%              |\r
195 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
196 | IPv4 FIB 2M       | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-pdrdisc                 | 8.3       | 8.1       | 8.1       | 0%              |\r
197 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
198 | IPv4 Policer      | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-pdrdisc    | 7.1       | 7.4       | 8.1       | 9%              |\r
199 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
200 | IPv6 FIB 200k     | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-pdrdisc               | 6.9       | 5.3       | 5.3       | 0%              |\r
201 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
202 | IPv6 FIB 20k      | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-pdrdisc                | 6.9       | 6.5       | 6.9       | 6%              |\r
203 +-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
204 \r
205 Known Issues\r
206 ------------\r
207 \r
208 Here is the list of known issues in CSIT |release| for VPP performance tests:\r
209 \r
210 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
211 | # | Issue                                           | Jira ID    | Description                                                     |\r
212 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
213 | 1 | NDR discovery test failures 1518B frame size    | VPP-663    | VPP reporting errors: dpdk-input Rx ip checksum errors.         |\r
214 |   | for ip4scale200k, ip4scale2m scale IPv4 routed- |            | Observed frequency: all test runs.                              |\r
215 |   | forwarding tests. ip4scale20k tests are fine.   |            |                                                                 |\r
216 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
217 | 2 | Vic1385 and Vic1227 low performance.            | VPP-664    | Low NDR performance.                                            |\r
218 |   |                                                 |            |                                                                 |\r
219 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
220 | 3 | Sporadic NDR discovery test failures on x520.   | CSIT-750   | Suspected issue with HW settings (BIOS, FW) in LF               |\r
221 |   |                                                 |            | infrastructure. Issue can't be replicated outside LF.           |\r
222 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
223 | 4 | VPP in 2t2c setups - large variation            | CSIT-568   | Suspected NIC firmware or DPDK driver issue affecting NDR       |\r
224 |   | of discovered NDR throughput values across      |            | throughput. Applies to XL710 and X710 NICs, x520 NICs are fine. |\r
225 |   | multiple test runs with xl710 and x710 NICs.    |            |                                                                 |\r
226 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
227 | 5 | Lower than expected NDR and PDR throughput with | CSIT-569   | Suspected NIC firmware or DPDK driver issue affecting NDR and   |\r
228 |   | xl710 and x710 NICs, compared to x520 NICs.     |            | PDR throughput. Applies to XL710 and X710 NICs.                 |\r
229 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
230 \r