X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fdpdk_performance_tests%2Fcsit_release_notes.rst;h=0c207e5a52d527917fac69563581a9120ccf8cbb;hb=b65cedf47183b73af225fb8d6c6a35886a0d761f;hp=bd08c57bbacbd9363537ed7cbdac66b187d7f7d4;hpb=9e00a9702f6b17ff85c597a0915ffb8b693e87ba;p=csit.git diff --git a/docs/report/dpdk_performance_tests/csit_release_notes.rst b/docs/report/dpdk_performance_tests/csit_release_notes.rst index bd08c57bba..0c207e5a52 100644 --- a/docs/report/dpdk_performance_tests/csit_release_notes.rst +++ b/docs/report/dpdk_performance_tests/csit_release_notes.rst @@ -4,172 +4,67 @@ Release Notes Changes in |csit-release| ------------------------- -#. **DPDK performance tests** - - - **MRR Throughput**: MRR (Maximum Receive Rate) test code has now - configurable trial duration and number of consecutive executions. - Coverage of MRR tests has been extended across more test - scenarios. MRR tests are used for continuous performance trending - and for comparison between DPDK releases. - - - **MLRsearch Throughput**: MLRsearch algorithm has been introduced - for all NDR and PDR throughput tests. All tests that previously - used binary search got converted to MLRsearch. Coverage of NDR/PDR - tests has been extended across more test scenarios. - - - **2-Node Tests**: A new set of 2-node tests covering DPDK Testpmd - and L3fwd, running on new Xeon Skylake testbeds. - - - **More NICs**: Increased coverage of NIC models tested: Intel- - xxv710-da2, Intel-x710-da4. - - - **Generated tests**: Simplified and unified test structure, semi- - autogenerated by generator script. Test generator is currently - able to create test combinations with various frame size and - cores combinations. All existing test cases were converted to new - format. - -#. **Presentation and Analytics Layer** - - - **Performance trending**: Added continuous performance trending with - anomaly detection and analysis for DPDK. - -Performance Changes -------------------- - -Relative performance changes in measured packet throughput in |csit-release| -are calculated against the results from |csit-release-1| -report. Listed mean and standard deviation values are computed based on -a series of the same tests executed against respective DPDK releases to -verify test results repeatability, with percentage change calculated for -mean values. - -NDR Changes -~~~~~~~~~~~ - -NDR throughput changes between releases are available in a CSV and pretty ASCII -formats: - - - `csv format for 1t1c <../_static/dpdk/performance-changes-1t1c-ndr.csv>`_, - - `csv format for 2t2c <../_static/dpdk/performance-changes-2t2c-ndr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/dpdk/performance-changes-1t1c-ndr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/dpdk/performance-changes-2t2c-ndr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_ - with Robot Framework result - files csit-dpdk-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -PDR Changes -~~~~~~~~~~~ - -PDR throughput changes between releases are available in a CSV and pretty ASCII -formats: - - - `csv format for 1t1c <../_static/dpdk/performance-changes-1t1c-pdr.csv>`_, - - `csv format for 2t2c <../_static/dpdk/performance-changes-2t2c-pdr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/dpdk/performance-changes-1t1c-pdr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/dpdk/performance-changes-2t2c-pdr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_ - with Robot Framework result - files csit-dpdk-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -MRR Changes -~~~~~~~~~~~ - -MRR small packet throughput changes between releases are available in a -CSV and pretty ASCII formats: - - - `csv format for 1t1c <../_static/dpdk/performance-changes-1t1c-mrr.csv>`_, - - `csv format for 2t2c <../_static/dpdk/performance-changes-2t2c-mrr.csv>`_, - - `csv format for 4t4c <../_static/dpdk/performance-changes-4t4c-mrr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/dpdk/performance-changes-1t1c-mrr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/dpdk/performance-changes-2t2c-mrr.txt>`_, - - `pretty ASCII format for 4t4c <../_static/dpdk/performance-changes-4t4c-mrr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_, - with Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -Comparison Across Testbeds --------------------------- - -Relative performance changes in measured packet throughput on 3-Node Skx testbed -are calculated against the results measured on 3-Node Hsw testbed. - -NDR Changes -~~~~~~~~~~~ - -NDR throughput changes between testbeds are available in a CSV and pretty ASCII -formats: - - - `csv format for ndr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_, - - `pretty ASCII format for ndr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_ and - `FD.io test executor dpdk performance job 3n-skx`_ - with Robot Framework result - files csit-dpdk-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -PDR Changes -~~~~~~~~~~~ - -PDR throughput changes between testbeds are available in a CSV and pretty ASCII -formats: - - - `csv format for pdr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_, - - `pretty ASCII format for pdr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_ and - `FD.io test executor dpdk performance job 3n-skx`_ - with Robot Framework result - files csit-dpdk-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -MRR Changes -~~~~~~~~~~~ - -MRR throughput changes between testbeds are available in a -CSV and pretty ASCII formats: - - - `csv format for mrr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_, - - `pretty ASCII format for mrr <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor dpdk performance job 3n-hsw`_ and - `FD.io test executor dpdk performance job 3n-skx`_ - with Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. +#. DPDK PERFORMANCE TESTS + + - **Intel Xeon 2n-skx, 3n-skx testbeds**: Testpmd and L3fwd + performance test data is not included in this report version. + This is due to the lower performance and behaviour inconsistency + of these systems following the upgrade of processor microcode + packages (skx ucode 0x2000064) as part of updating Ubuntu 18.04 + LTS kernel version. Tested VPP and DPDK applications (L3fwd) are + affected. Skx test data will be added in subsequent maintenance + report version(s) once the issue is resolved. See + :ref:`dpdk_known_issues`. + + - **Intel Xeon 2n-clx testbeds**: DPDK performance test data is now + included in this report, after resolving the issue of lower + performance and behaviour inconsistency of these systems due to + the Linux kernel driven upgrade of processor microcode packages + to 0x500002c. The resolution is to use latest SuperMicro BIOS 3.2 + (for X11DPG-QT motherboards used) that upgrades processor + microcode to 0x500002c, AND NOT kernel provided ucode package as + it does put THE system into sub-optimal state. + + +#. DPDK RELEASE VERSION CHANGE + + - |csit-release| tested |dpdk-release|, as used by |vpp-release|. + +#. TEST ENVIRONMENT + + - **TRex Fortville NIC Performance**: Received FVL fix from Intel + resolving TRex low throughput issue. TRex per FVL NIC throughput + increased from ~27 Mpps to the nominal ~37 Mpps. For detail see + `CSIT-1503 `_ and `TRex-519 + `_]. + + - **New Intel Xeon Cascadelake Testbeds**: Added performance tests + for 2-Node-Cascadelake (2n-clx) testbeds with x710, xxv710 and + cx556a-edat NIC cards. + +.. + // Alternative Note for 1st Bullet when bad microcode Skx, Clx results are published + - **Intel Xeon 2n-skx, 3n-skx and 2n-clx testbeds**: Testpmd and + L3fwd performance test data is included in this report version, + but it shows lower performance and behaviour inconsistency of + these systems following the upgrade of processor microcode + packages (skx ucode 0x2000064, clx ucode 0x500002c) as part of + updating Ubuntu 18.04 LTS kernel version. Tested VPP and DPDK + applications (L3fwd) are affected. Skx and Clx test data will be + corrected in subsequent maintenance report version(s) once the + issue is resolved. See :ref:`vpp_known_issues`. + +.. _dpdk_known_issues: Known Issues ------------ -Here is the list of known issues in |csit-release| for Testpmd performance tests: +List of known issues in |csit-release| for DPDK performance tests: -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ -| # | Issue | Jira ID | Description | -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ -| | No known issues | | | -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ ++----+------------------------------------------+----------------------------------------------------------------------------------------------------------+ +| # | JiraID | Issue Description | ++====+==========================================+==========================================================================================================+ +| 1 | `CSIT-1675 | Intel Xeon 2n-skx, 3n-skx and 2n-clx testbeds behaviour and performance became inconsistent following | +| | `_ | the upgrade to the latest Ubuntu 18.04 LTS kernel version (4.15.0-72-generic) and associated microcode | +| | | packages (skx ucode 0x2000064, clx ucode 0x500002c). VPP as well as DPDK L3fwd tests are affected. | ++----+------------------------------------------+----------------------------------------------------------------------------------------------------------+