X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Fgeneral_notes.rst;h=91cd46e6781db8d54135f4f8f5dbf06f7cc1e4fe;hb=5cf543e186c7d04c4d2feaed5e5606539a4df9be;hp=380f109764cb207cbc4bee00b72a531db59dddcb;hpb=cd8d4dc1498a69b4f9541fb4405fd31fd61d81d9;p=csit.git diff --git a/docs/report/introduction/general_notes.rst b/docs/report/introduction/general_notes.rst index 380f109764..91cd46e678 100644 --- a/docs/report/introduction/general_notes.rst +++ b/docs/report/introduction/general_notes.rst @@ -2,66 +2,73 @@ General Notes ============= All CSIT test results listed in this report are sourced and auto-generated -from output.xml Robot Framework (RF) files resulting from LF FD.io Jenkins -jobs execution against |vpp-release| release artifacts. References are -provided to the original LF FD.io Jenkins job results. However, as LF FD.io -Jenkins infrastructure does not automatically archive all jobs (history record -is provided for the last 30 days or 40 jobs only), additional references are -provided to the RF result files that got archived in FD.io nexus online -storage system. +from :file:`output.xml` :abbr:`RF (Robot Framework)` files resulting from +:abbr:`LF (Linux Foundation)` FD.io Jenkins jobs execution against |vpp-release| +release artifacts. References are provided to the original :abbr:`LF (Linux +Foundation)` FD.io Jenkins job results. Additional references are provided to +the :abbr:`RF (Robot Framework)` result files that got archived in FD.io nexus +online storage system. FD.io CSIT project currently covers multiple FD.io system and sub-system -testing areas and this is reflected in this report, where each testing area +testing areas and this is reflected in this report, where each testing area is listed separately, as follows: -#. **VPP Performance Tests** - VPP performance tests are executed in physical +#. **VPP - Performance** - VPP benchmarking tests are executed in physical FD.io testbeds, focusing on VPP network data plane performance at this stage, both for Phy-to-Phy (NIC-to-NIC) and Phy-to-VM-to-Phy (NIC-to-VM-to-NIC) - forwarding topologies. Tested across a range of NICs, 10GE and 40GE + forwarding topologies. Tested across a range of NICs, 10GE, 25GE and 40GE interfaces, range of multi-thread and multi-core configurations. VPP - application runs in host user- mode. TRex is used as a traffic generator. + application runs in host user-mode. TRex is used as a traffic generator. -#. **DPDK Performance Tests** - VPP is using DPDK code to control and drive - the NICs and physical interfaces. Testpmd tests are used as a baseline to - profile the DPDK sub-system of VPP. DPDK performance tests executed in +#. **LXC and Docker Containers VPP memif - Performance** - VPP memif + virtual interface tests interconnect multiple VPP instances running in + containers. VPP vswitch instance runs in bare-metal user-mode + handling Intel x520 NIC 10GbE, Intel x710 NIC 10GbE, Intel xl710 NIC 40GbE + interfaces and connecting over memif (Slave side) virtual interfaces to more + instances of VPP running in LXC or in Docker Containers, both with memif + virtual interfaces (Master side). Tested across a range of multi-thread and + multi-core configurations. TRex is used as a traffic generator. + +#. **Container Topologies Orchestrated by K8s - Performance** - CSIT Container + topologies connected over the memif virtual interface (shared memory + interface). For these tests VPP vswitch instance runs in a Docker Container + handling Intel x520 NIC 10GbE, Intel x710 NIC 10GbE interfaces and connecting + over memif virtual interfaces to more instances of VPP running in Docker + Containers with memif virtual interfaces. All containers are + orchestrated by Kubernetes, with `Ligato `_ for + container networking. TRex is used as a traffic generator. + +#. **DPDK Performance** - VPP is using DPDK code to control and drive + the NICs and physical interfaces. Tests are used as a baseline to + profile performance of the DPDK sub-system. DPDK tests are executed in physical FD.io testbeds, focusing on Testpmd/L3FWD data plane performance for - Phy-to-Phy (NIC-to-NIC). Tests cover a range of NICs, 10GE and 40GE + Phy-to-Phy (NIC-to-NIC). Tested across a range of NICs, 10GE, 25GE and 40GE interfaces, range of multi-thread and multi-core configurations. Testpmd/L3FWD application runs in host user-mode. TRex is used as a traffic generator. -#. **VPP Functional Tests** - VPP functional tests are executed in virtual +#. **VPP Functional** - VPP functional tests are executed in virtual FD.io testbeds focusing on VPP packet processing functionality, including network data plane and in -line control plane. Tests cover vNIC-to-vNIC vNIC-to-VM-to-vNIC forwarding topologies. Scapy is used as a traffic generator. -#. **Honeycomb Functional Tests** - Honeycomb functional tests are executed in +#. **Honeycomb Functional** - Honeycomb functional tests are executed in virtual FD.io testbeds, focusing on Honeycomb management and programming functionality of VPP. Tests cover a range of CRUD operations executed against VPP. -#. **Honeycomb Performance Tests** - Honeycomb performance tests are executed in - physical FD.io testbeds, focusing on the performance of Honeycomb management and programming - functionality of VPP. Tests cover a range of CRUD operations executed - against VPP. - -#. **NSH_SFC Functional Tests** - NSH_SFC functional tests are executed in +#. **NSH_SFC Functional** - NSH_SFC functional tests are executed in virtual FD.io testbeds focusing on NSH_SFC of VPP. Tests cover a range of CRUD operations executed against VPP. -In addition to above, CSIT |release| report does also include VPP unit test -results. VPP unit tests are developed within the FD.io VPP project and as they -complement CSIT system functional tests, they are provided mainly as a reference -and to provide a more complete view of automated testing executed against -|vpp-release|. +#. **DMM Functional** - DMM functional tests are executed in virtual FD.io + testbeds demonstrates single server[DUT1] and single client[DUT2] scenario + using DMM framework and kernel tcp/ip stack. -FD.io CSIT system is developed using two main coding platforms: Robot -Framework (RF) and Python. CSIT |release| source code for the executed test +FD.io CSIT system is developed using two main coding platforms :abbr:`RF (Robot +Framework)` and Python2.7. |csit-release| source code for the executed test suites is available in CSIT branch |release| in the directory -"./tests/". A local copy of CSIT source code can be -obtained by cloning CSIT git repository - "git clone -https://gerrit.fd.io/r/csit". The CSIT testing virtual environment can be run -on a local computer workstation (laptop, server) using Vagrant by following -the instructions in `CSIT tutorials -`_. +:file:`./tests/`. A local copy of CSIT source code +can be obtained by cloning CSIT git repository - :command:`git clone +https://gerrit.fd.io/r/csit`.