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=31f3701a38f61f4d1fa819bfe97478d8d91e8633;hp=363c2e70f11c285cad7a055829be4ee72d169a55;hpb=ce1088d88744f2c040801c9852565d522b3feb68;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 363c2e70f1..7f190ab201 100644 --- a/docs/report/dpdk_performance_tests/csit_release_notes.rst +++ b/docs/report/dpdk_performance_tests/csit_release_notes.rst @@ -4,114 +4,57 @@ Release Notes Changes in |csit-release| ------------------------- -No code changes apart from bug fixes. - -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 VPP releases to -verify test results repeatability, with percentage change calculated for -mean values. Note that the standard deviation is quite high for a small -number of packet throughput tests, what indicates poor test results -repeatability and makes the relative change of mean throughput value not -fully representative for these tests. The root causes behind poor -results repeatability vary between the test cases. - -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-vpp-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-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -Comparison Across Testbeds --------------------------- - -Relative performance changes in measured packet throughputon 3-Node Skx testbed -are calculated against the results measured on 3-Node Hsw testbed. - -NDR Changes -~~~~~~~~~~~ - -NDR 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-vpp-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-vpp-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 | -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ -| 1 | Testpmd in 1t1c and 2t2c setups - large variation | CSIT-569 | Suspected NIC firmware or DPDK driver issue affecting NDR | -| | of discovered NDR throughput values across | | throughput. Applies to XL710 and X710 NICs, no issues observed | -| | multiple test runs with xl710 and x710 NICs. | | on x520 NICs. | -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ -| 2 | Lower than expected NDR throughput with xl710 | CSIT-571 | Suspected NIC firmware or DPDK driver issue affecting NDR | -| | and x710 NICs, compared to x520 NICs. | | throughput. Applies to XL710 and X710 NICs. | -+---+---------------------------------------------------+------------+-----------------------------------------------------------------+ ++----+------------------------------------------+----------------------------------------------------------------------------------------------------------+ +| # | 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. | ++----+------------------------------------------+----------------------------------------------------------------------------------------------------------+