-CSIT Release Notes\r
-==================\r
-\r
-Changes in CSIT |release|\r
--------------------------\r
-\r
-#. VPP performance test environment changes\r
-\r
- - Further optimizations of VM and vhost-user test environment - various\r
- Qemu virtio queue size testing with value of 256 and 1024. Applied\r
- Linux CFS optimization to run VPP worker threads and Qemu worker threads\r
- with highest priority.\r
-\r
-#. VPP performance test framework changes\r
-\r
- - Full code review, optimization and refactor.\r
-\r
-#. T-rex changes\r
-\r
- - Full refactor of T-rex driver and introduce of traffic profiles that\r
- improves readability, manageability of traffic profiles for various\r
- test scenarios.\r
-\r
-#. Added VPP performance tests\r
-\r
- - **LXC memif**\r
-\r
- - Memif interface tests interconnecting two VPP instances on single SUT.\r
- Master VPP instance running on native OS with Intel x520 NIC and guest\r
- VPP instance running in Linux Container (LXC) doing the L2 cross\r
- connect loop. LXC running in privileged mode is pinned to dedicated\r
- cores. All VPP instances are same version.\r
-\r
- - **Stateful Security Groups**\r
-\r
- - **VM vhost use cases**\r
-\r
-Performance Improvements\r
-------------------------\r
-\r
-Substantial improvements in measured packet throughput have been\r
-observed in a number of CSIT |release| tests listed below, with relative\r
-increase of double-digit percentage points. Relative improvements are\r
-calculated against the test results listed in CSIT |release-1| report.\r
-VPP-16.09 numbers are provided for reference.\r
-\r
-NDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Non-Drop Rate Throughput discovery tests:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name | VPP-16.09 | VPP-17.01 | VPP-17.04 | VPP-17.07 | 17.04 to 17.07 |\r
-| | | [Mpps] | [Mpps] | [Mpps] | [Mpps] | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+===========+=================+\r
-| L2XC-vhost-VM | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-ndrdisc | 0.5 | 2.8 | 3.4 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2BD-vhost-VM | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-ndrdisc | 0.4 | 2.7 | 3.1 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 vhost | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-ndrdisc | 0.3 | 2.6 | 3.0 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 LISP | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-ndrdisc | 4.4 | 4.8 | 5.5 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-ndrdisc | 3.0 | 7.3 | 8.1 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 COP | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-ndrdisc | 6.1 | 6.1 | 6.9 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 iAcl | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-ndrdisc | 6.5 | 6.1 | 6.9 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 2M | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-ndrdisc | 5.3 | 4.2 | 4.6 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-\r
-PDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name | VPP-16.09 | VPP-17.01 | VPP-17.04 | VPP-17.07 | 17.04 to 17.07 |\r
-| | | [Mpps] | [Mpps] | [Mpps] | [Mpps] | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+===========+=================+\r
-| L2XC-vhost-VM | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-pdrdisc | 2.6 | 3.2 | 3.7 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2BD-vhost-VM | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-pdrdisc | 2.1 | 2.9 | 3.3 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 vhost | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-pdrdisc | 2.0 | 2.7 | 3.0 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 LISP | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-pdrdisc | 4.6 | 4.8 | 5.5 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-pdrdisc | 7.7 | 7.3 | 8.1 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 COP | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-pdrdisc | 6.1 | 6.1 | 6.9 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 iAcl | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-pdrdisc | 6.5 | 6.1 | 6.9 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 2M | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-pdrdisc | 5.3 | 4.2 | 4.6 | | ??% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-\r
-Measured improvements are in line with VPP code optimizations listed in\r
-`VPP-17.07 release notes\r
-<https://docs.fd.io/vpp/17.07/release_notes_1707.html>`_.\r
-\r
-Other Performance Changes\r
--------------------------\r
-\r
-Other changes in measured packet throughput, with either minor relative\r
-increase or decrease, have been observed in a number of CSIT |release|\r
-tests listed below. Relative changes are calculated against the test\r
-results listed in CSIT |release-1| report.\r
-\r
-NDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Non-Drop Rate Throughput discovery tests:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name | VPP-16.09 | VPP-17.01 | VPP-17.04 | VPP-17.07 | 17.04 to 17.07 |\r
-| | | [Mpps] | [Mpps] | [Mpps] | [Mpps] | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+===========+=================+\r
-| L2XC | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-ndrdisc | 9.4 | 12.7 | 13.1 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC | 10ge2p1xl710: 64B-1t1c-eth-l2xcbase-ndrdisc | 9.5 | 12.2 | 12.4 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1ad | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-ndrdisc | 7.4 | 8.8 | 9.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1q | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-ndrdisc | 7.5 | 8.8 | 9.2 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC VxLAN | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-ndrdisc | 5.4 | 6.5 | 6.8 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2BD | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-ndrdisc | 7.8 | 10.4 | 10.8 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ndrdisc | 8.7 | 9.7 | 10.6 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 COP | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-ndrdisc | 7.1 | 8.3 | 9.0 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 iAcl | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-ndrdisc | 6.9 | 7.6 | 8.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 200k | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-ndrdisc | 8.5 | 9.0 | 9.7 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 20k | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-ndrdisc | 8.5 | 9.0 | 9.7 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 2M | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-ndrdisc | 8.5 | 7.8 | 8.1 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 Policer | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-ndrdisc | 6.9 | 7.4 | 8.1 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 200k | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-ndrdisc | 6.5 | 5.3 | 5.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 20k | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-ndrdisc | 6.9 | 6.5 | 6.9 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-\r
-PDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name | VPP-16.09 | VPP-17.01 | VPP-17.04 | VPP-17.07 | 17.04 to 17.07 |\r
-| | | [Mpps] | [Mpps] | [Mpps] | [Mpps] | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+===========+=================+\r
-| L2XC | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-pdrdisc | 9.4 | 12.7 | 13.4 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1ad | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-pdrdisc | 7.4 | 8.8 | 9.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1q | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-pdrdisc | 7.5 | 8.8 | 9.2 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2XC VxLAN | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-pdrdisc | 5.4 | 6.5 | 6.8 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| L2BD | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-pdrdisc | 7.8 | 10.6 | 10.8 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-pdrdisc | 8.7 | 9.7 | 10.6 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 COP | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-pdrdisc | 7.1 | 8.3 | 9.2 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 iAcl | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-pdrdisc | 7.1 | 7.6 | 8.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 200k | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-pdrdisc | 8.5 | 9.0 | 9.7 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 20k | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-pdrdisc | 8.5 | 9.0 | 9.7 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 2M | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-pdrdisc | 8.3 | 8.1 | 8.1 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv4 Policer | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-pdrdisc | 7.1 | 7.4 | 8.1 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 200k | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-pdrdisc | 6.9 | 5.3 | 5.3 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 20k | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-pdrdisc | 6.9 | 6.5 | 6.9 | | ?% |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------+-----------------+\r
-\r
-Known Issues\r
-------------\r
-\r
-Here is the list of known issues in CSIT |release| for VPP performance tests:\r
-\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| # | Issue | Jira ID | Description |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 1 | NDR discovery test failures 1518B frame size | VPP-663 | VPP reporting errors: dpdk-input Rx ip checksum errors. |\r
-| | for ip4scale200k, ip4scale2m scale IPv4 routed- | | Observed frequency: all test runs. |\r
-| | forwarding tests. ip4scale20k tests are fine. | | |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 2 | Vic1385 and Vic1227 low performance. | VPP-664 | Low NDR performance. |\r
-| | | | |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 3 | Sporadic NDR discovery test failures on x520. | CSIT-750 | Suspected issue with HW settings (BIOS, FW) in LF |\r
-| | | | infrastructure. Issue can't be replicated outside LF. |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 4 | VPP in 2t2c setups - large variation | CSIT-568 | Suspected NIC firmware or DPDK driver issue affecting NDR |\r
-| | of discovered NDR throughput values across | | throughput. Applies to XL710 and X710 NICs, x520 NICs are fine. |\r
-| | multiple test runs with xl710 and x710 NICs. | | |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 5 | Lower than expected NDR and PDR throughput with | CSIT-569 | Suspected NIC firmware or DPDK driver issue affecting NDR and |\r
-| | xl710 and x710 NICs, compared to x520 NICs. | | PDR throughput. Applies to XL710 and X710 NICs. |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-\r
+Release Notes
+=============
+
+Changes in |csit-release|
+-------------------------
+
+#. VPP PERFORMANCE TESTS
+
+ - **Service density 2n-skx tests**: Added higher NF density tests with two
+ NFs' data-plane threads sharing a physical core. VPP IPv4 routing is now
+ used as a VNF payload similar to CNF tests.
+
+ - **Soak Tests**: Optimized performamce soak tests framework
+ code for extended time duration tests and throughput discovery
+ at given PLR and at give total test time e.g. minutes, hours,
+ days, weeks. See updated
+ :ref:`test_methodology` section for more details.
+
+#. TEST FRAMEWORK
+
+ - **Qemu code refactor**: Complete code refactor of the key components of
+ QemuUtil.py and QemuManager.py (L1 and L2 KW counterparts). Added
+ implementation of kernel-image-kvm based VM replacing the previously used
+ NestedVM images. Added ability to run VPP as a payload in VNF.
+
+ - **CSIT PAPI Support**: Continued conversion of CSIT VAT L1 keywords to
+ PAPI L1 KWs in CSIT using VPP Python bindings. Redesign of key components
+ of PAPI Executor and PAPI history.
+
+ - **General Code Housekeeping**: Ongoing RF keywords optimizations,
+ removal of redundant RF keywords.
+
+ - **Test suite generator**: Added capability to generate suites for
+ different NIC models as well as throughput search algorithm types. Uses
+ base tests suites as source.
+
+ - **TOX verification**: Added verifications for test suite generator.
+
+#. PRESENTATION AND ANALYTICS LAYER
+
+ - **Graphs Layout Improvements**: Improved performance graphs layout
+ for better readibility and maintenance: test grouping, axis
+ labels, descriptions, other informative decoration.
+
+..
+ #. MISCELLANEOUS
+
+ - **2n-dnv Tests (3rd Party)**: Published performance tests for 2n-
+ dnv (2-Node Atom Denverton) from 3rd party testbeds running FD.io
+ |csit-release| automated testing code.
+ Only graphs for Packet Throughput and Speedup Multi-core and not
+ for Packet Latency were published as there are no results for Packet
+ Latency available.
+
+.. raw:: latex
+
+ \clearpage
+
+.. _vpp_known_issues:
+
+Known Issues
+------------
+
+List of known issues in |csit-release| for VPP performance tests:
+
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| # | JiraID | Issue Description |
++====+=========================================+==========================================================================================================+
+| 1 | `CSIT-570 | Sporadic (1 in 200) NDR discovery test failures on x520. DPDK reporting rx-errors, indicating L1 issue. |
+| | <https://jira.fd.io/browse/CSIT-570>`_ | Suspected issue with HW combination of X710-X520 in LF testbeds. Not observed outside of LF testbeds. |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| 2 | `CSIT-1503 | [`TRex-519 <https://trex-tgn.cisco.com/youtrack/issue/trex-519>`_] XL710/XXV710 with FW 6.0.1 will have |
+| | <https://jira.fd.io/browse/CSIT-1503>`_ | Rx drop rate of 27MPPS. |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| 3 | `CSIT-1501 | Sporadic crypto backend fails loading `VPP-1670 <https://jira.fd.io/browse/VPP-1670>`_ |
+| | <https://jira.fd.io/browse/CSIT-1501>`_ | |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| 4 | `CSIT-1427 | Sporadic HW aes-128-cbc-sha1 tunnel-interface tests are failing. |
+| | <https://jira.fd.io/browse/CSIT-1427>`_ | `VPP-1671 <https://jira.fd.io/browse/VPP-1671>`_ |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| 5 | `CSIT-1498 | Memif tests are sporadically failing on initialization of memif connection. |
+| | <https://jira.fd.io/browse/CSIT-1498>`_ | |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
+| 6 | `CSIT-1499 | AVF tests are sporadically failing on initialization of AVF interface. |
+| | <https://jira.fd.io/browse/CSIT-1499>`_ | |
++----+-----------------------------------------+----------------------------------------------------------------------------------------------------------+
Code Review / csit.git / blobdiff