X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fdpdk_performance_tests%2Fcsit_release_notes.rst;h=7f190ab201bbc5bb218d85f66f248616290edef3;hb=d63ef8e407fc9db5f8d8d26495a902d9a0a164f0;hp=28e6a37768277878213ea6cdc385dfaa36dcde6d;hpb=ee1321d27bc39baab5bc2615834fd7392b79a160;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 28e6a37768..7f190ab201 100644 --- a/docs/report/dpdk_performance_tests/csit_release_notes.rst +++ b/docs/report/dpdk_performance_tests/csit_release_notes.rst @@ -4,124 +4,57 @@ Release Notes Changes in |csit-release| ------------------------- -#. **DPDK performance tests** - - - *MRR tests* - Maximum Receive Rate tests measure the packet forwarding rate - under the maximum load offered by traffic generator over a set trial - duration, regardless of packet loss. MRR tests are used for continuous - performance trending and for comparison between releases. - - - *MLR tests* - NDR and PDR tests measure the packet forwarding rate using - MLRsearch library by traffic generator. All tests that previously used - binary search were converted to MLRsearch. - - - *2-node tests* - Set of 2-node tests covering testpmd and l3fwd. - - - Increased coverage of NIC specific tests (Intel-xxv710-da2, Intel-x710) - - - *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. - - -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/>`_. - -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/>`_. +#. DPDK PERFORMANCE TESTS + + - **Intel Xeon 2n-skx, 3n-skx and 2n-clx 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, 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 added in subsequent maintenance report version(s) once + the issue is resolved. See :ref:`dpdk_known_issues`. + +#. 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 + mcx556a-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 | ++====+==========================================+==========================================================================================================+ +| 8 | `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. | ++----+------------------------------------------+----------------------------------------------------------------------------------------------------------+