8f37fed2840aaadce9521f19a4ff0918de3f5f8c
[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    - **MRR Throughput**: MRR (Maximum Receive Rate) test code has now
10      configurable trial duration and number of consecutive executions.
11      Coverage of MRR tests has been extended across more test
12      scenarios. MRR tests are used for continuous performance trending
13      and for comparison between VPP releases.
14
15    - **MLRsearch Throughput**: MLRsearch algorithm has been introduced
16      for all NDR and PDR throughput tests. All tests that previously
17      used binary search got converted to MLRsearch. Coverage of NDR/PDR
18      tests has been extended across more test scenarios.
19
20    - **L2patch Tests**: Tests measure performance of VPP L2patch, the
21      fastest L2 forwarding path implemented in VPP, that cross-links
22      RX and TX of two physical interfaces.
23
24    - **2-Node Tests**: A new baseline set of 2-node tests covering base
25      ip4, ip6, l2patch, l2bd, l2xc, running on new Xeon Skylake
26      testbeds.
27
28    - **Generated tests**: Simplified and unified test structure, semi-
29      autogenerated by generator script. Test generator is currently
30      able to create test combinations with various frame size and
31      cores combinations. All existing test cases were converted to new
32      format.
33
34    - **Simultaneous Multi-Threading**: SMT-aware detection of server
35      processor operation mode (HyperThreading enabled/disabled) with
36      associated compute resource configuration including thread
37      affinity, number of Rx queues and DPDK I/O mbufs. Tests are
38      automatically tagged during execution to indicate executed thread
39      configuration.
40
41    - **Intel Xeon Skylake Support**: Support for 2-Node and 3-Node
42      physical testbed topologies based on the new SuperMirco servers
43      each with two Intel Xeon Skylake Platinum processors. Full
44      Ansible playbooks refactor for quick server (re)installation and
45      reference pointers of configuration.
46
47 #. PRESENTATION AND ANALYTICS LAYER
48
49    - **Performance trending**: Further improvements of continuous
50      performance trending, anomaly detection and analysis.
51
52 #. TEST FRAMEWORK OPTIMIZATIONS
53
54    - **General Code Housekeeping**: Ongoing RF keywords optimizations,
55      removal of redundant RF keywords.
56
57 .. raw:: latex
58
59     \clearpage
60
61 .. _vpp_known_issues:
62
63 Known Issues
64 ------------
65
66 List of known issues in |csit-release| for VPP performance tests:
67
68 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
69 | #  | JiraID                                  | Issue Description                                                                                                               |
70 +====+=========================================+=================================================================================================================================+
71 | 1  | `CSIT-570                               | Sporadic (1 in 200) NDR discovery test failures on x520. DPDK reporting rx-errors, indicating L1 issue.                         |
72 |    | <https://jira.fd.io/browse/CSIT-570>`_  | Suspected issue with HW combination of X710-X520 in LF testbeds. Not observed outside of LF testbeds.                           |
73 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
74 | 2  | `CSIT-1234                              | VPP IPSecHW scale interface mode 1core, low NDR and PDR 64B throughput in 3n-hsw testbeds, in CSIT-18.07 vs. CSIT-18.04.        |
75 |    | <https://jira.fd.io/browse/CSIT-1234>`_ | ip4ipsecscale1000tnl-ip4base-int 1core CSIT-18.07/18.04 relative change: NDR -31%, PDR -32%, MRR -38%.                          |
76 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
77 | 3  | `CSIT-1242                              | VPP xl710 ip4base test 1core, low NDR and PDR 64B throughput in 3n-hsw testbeds, in CSIT-18.07 vs. CSIT-18.04.                  |
78 |    | <https://jira.fd.io/browse/CSIT-1242>`_ | xl710 ip4base 1core CSIT-18.07/18.04 relative change: NDR -29%, high stdev.                                                     |
79 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
80 | 4  | `CSIT-1243                              | VPP nat44 base test 2core, low NDR and PDR 64B throughput in 3n-skx testbeds, compared to 3n-hsw testbeds.                      |
81 |    | <https://jira.fd.io/browse/CSIT-1243>`_ | ip4base-nat44 2core 3n-skx/3n-hsw relative change: NDR -19%, PDR -22%.                                                          |
82 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
83 | 5  | `CSIT-1245                              | VPP srv6proxy-stat and srv6proxy-masq, much higher NDR and PDR 78B throughput in 3n-hsw testbeds, in CSIT-18.07 vs. CSIT-18.04. |
84 |    | <https://jira.fd.io/browse/CSIT-1245>`_ | Due to wrong test suite configuration in dynamic-proxy mode. Artefact of suite code refactoring.                                |
85 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
86 | 6  | `CSIT-1246                              | Ligato K8S orchestrated tests are failing due to incompatibility of the latest released Ligato vpp-agent with VPP-18.07.        |
87 |    | <https://jira.fd.io/browse/CSIT-1246>`_ | Past vpp-agent releases are not compatible either.                                                                              |
88 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
89 | 7  | `CSIT-1253                              | VPP lbdpdk link bonding tests failing due to interfaces not coming up.                                                          |
90 |    | <https://jira.fd.io/browse/CSIT-1253>`_ | VPP lbdpdk link bonding tests relying on DPDK functionality for bonding fail.                                                   |
91 +----+-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+