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