Report: release_notes updates including skx, clx microcode issue.
[csit.git] / docs / report / vpp_performance_tests / csit_release_notes.rst
1 Release Notes
2 =============
3
4 Changes in |csit-release|
5 -------------------------
6
7 #. VPP PERFORMANCE TESTS
8
9    - **Intel Xeon 2n-skx, 3n-skx and 2n-clx testbeds**: VPP test data is
10      not included in this report version. This is due to performance
11      and behaviour inconsistency following the upgrade to the latest
12      Ubuntu 18.04 LTS kernel version (4.15.0-72-generic) and
13      associated microcode packages (skx ucode 0x2000064, clx ucode
14      0x500002c). Test data will be added in subsequent maintenance
15      report version(s) once the issue is resolved. See
16      :ref:`vpp_known_issues`.
17
18    - **Service density 2n-skx tests**: Added new NF density tests with
19      IPsec encryption between DUTs.
20
21    - **AVF tests**: Full test coveraged based on code changes in CSIT core
22      layer (driver/interface awareness) and generated by suite generator
23      (Intel Fortville NICs only).
24
25    - **Hoststack TCP/IP tests**: Major refactor of VPP Hoststack TCP/IP
26      performance tests using WRK generator talking to the VPP HTTP
27      static server plugin measuring connections per second and
28      requests per second. Added iperf3 tests with LDPreload.
29
30    - **Latency HDRHistogram**: Added High Dynamic Range Histogram
31      latency measurements based on the new capability in TRex traffic
32      generator. HDRH latency data presented in latency packet
33      percentile graphs and in detailed results tables.
34
35    - **Mellanox MCX556A-EDAT tests**: Added tests with Mellanox
36      ConnectX5-2p100GE NICs in 2n-clx testbeds using VPP native rdma
37      driver.
38
39    - **IPsec reconfiguration tests**: Added tests measuring the impact of IPsec
40      tunnels creations and removals.
41
42    - **Load Balancer tests**: Added VPP performance tests for Maglev,
43      L3DSR (Direct Server Return), Layer 4 Load Balancing NAT Mode.
44
45 #. TEST FRAMEWORK
46
47    - **CSIT Python3 support**: Full migration of CSIT from Python2.7 to
48      Python3.6. This change includes library migration, PIP dependency upgrade,
49      CSIT container images, infrastructure packages ugrade/installation.
50
51    - **CSIT PAPI support**: Finished conversion of CSIT VAT L1 keywords
52      to PAPI L1 KWs in CSIT using VPP Python bindings (VPP PAPI).
53      Redesign of key components of PAPI Socket Executor and PAPI
54      history. Due to issues with PAPI performance, VAT is still used
55      in CSIT for all VPP scale tests. See known issues below.
56
57    - **Test Suite Generator**: Added capability to generate suites for
58      different drivers per NIC model including DPDK, AVF, RDMA.
59      Extended coverage for all tests.
60
61    - **General Code Housekeeping**: Ongoing RF keywords optimizations,
62      removal of redundant RF keywords and aligning of suite/test
63      setup/teardowns.
64
65
66 #. PRESENTATION AND ANALYTICS LAYER
67
68    - **Graphs layout improvements**: Improved performance graphs layout
69      for better readibility and maintenance: test grouping, axis
70      labels, descriptions, other informative decoration.
71
72    - **Latency graphs**: Min/Avg/Max group bar latency graphs are
73      replaced with packet latency percentile distributon at different
74      background packet loads based on TRex latency hdrhistogram
75      measurements.
76
77 .. raw:: latex
78
79     \clearpage
80
81 .. _vpp_known_issues:
82
83 Known Issues
84 ------------
85
86 List of known issues in |csit-release| for VPP performance tests:
87
88 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
89 | #  | JiraID                                  | Issue Description                                                                                         |
90 +====+=========================================+===========================================================================================================+
91 | 1  | `CSIT-570                               | Sporadic (1 in 200) NDR discovery test failures on x520. DPDK reporting rx-errors, indicating L1 issue.   |
92 |    | <https://jira.fd.io/browse/CSIT-570>`_  | Suspected issue with HW combination of X710-X520 in LF testbeds. Not observed outside of LF testbeds.     |
93 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
94 | 2  | `VPP-662                                | 9000B packets not supported by NICs VIC1227 and VIC1387.                                                  |
95 |    | <https://jira.fd.io/browse/VPP-662>`_   |                                                                                                           |
96 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
97 | 3  | `CSIT-1498                              | Memif tests are sporadically failing on initialization of memif connection.                               |
98 |    | <https://jira.fd.io/browse/CSIT-1498>`_ |                                                                                                           |
99 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
100 | 4  | `VPP-1677                               | 9000B ip4 nat44: VPP crash + coredump.                                                                    |
101 |    | <https://jira.fd.io/browse/VPP-1677>`_  | VPP crashes very often in case that NAT44 is configured and it has to process IP4 jumbo frames (9000B).   |
102 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
103 | 5  | `CSIT-1591                              | All CSIT scale tests can not use PAPI due to much slower performance compared to VAT/CLI (it takes much   |
104 |    | <https://jira.fd.io/browse/CSIT-1499>`_ | longer to program VPP). This needs to be addressed on the PAPI side.                                      |
105 |    +-----------------------------------------+                                                                                                           |
106 |    | `VPP-1763                               |                                                                                                           |
107 |    | <https://jira.fd.io/browse/VPP-1763>`_  |                                                                                                           |
108 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
109 | 6  | `VPP-1675                               | IPv4 IPSEC 9000B packet tests are failing as no packet is forwarded.                                      |
110 |    | <https://jira.fd.io/browse/VPP-1675>`_  | Reason: chained buffers are not supported.                                                                |
111 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
112 | 7  | `CSIT-1593                              | IPv4 AVF 9000B packet tests are failing on 3n-skx while passing on 2n-skx.                                |
113 |    | <https://jira.fd.io/browse/CSIT-1593>`_ |                                                                                                           |
114 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
115 | 8  | `CSIT-1675                              | Intel Xeon 2n-skx, 3n-skx and 2n-clx testbeds behaviour and performance became inconsistent following     |
116 |    | <https://jira.fd.io/browse/CSIT-1675>`_ | the upgrade to the latest Ubuntu 18.04 LTS kernel version (4.15.0-72-generic) and associated microcode    |
117 |    |                                         | packages (skx ucode 0x2000064, clx ucode 0x500002c). VPP as well as DPDK L3fwd tests are affected.        |
118 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
119