X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fintroduction%2Foverview.rst;h=c3537a9f66499cc4b431abe513b16f3b489c4fea;hp=e3b343c815876b9e8455c2c6aa4641f89f93576f;hb=468da48d3f3ced298ff8dccc76885157dff5cfe7;hpb=223a5c2eed4a935b27d390b89aa849a3825d86bb diff --git a/docs/report/introduction/overview.rst b/docs/report/introduction/overview.rst index e3b343c815..c3537a9f66 100644 --- a/docs/report/introduction/overview.rst +++ b/docs/report/introduction/overview.rst @@ -1,23 +1,93 @@ -Overview -======== - -This is the Fast Data Project (FD.io) Continuous System Integration and Testing -(CSIT) project report for CSIT |release| system testing of VPP-17.01 release. -Initial sections of the report describe FD.io functional and performance tests -and their continuous execution achieved in CSIT |release|. This is followed by -high-level overview of FD.io test environments running in Linux Foundation -(LF) FD.io Continuous Performance Labs), CSIT |release| release notes and -result highlights. Subsequent sections list the functional and performance -detailed test results generated by LF FD.io Jenkins system executing CSIT jobs -running tests against the VPP-17.01 release and associated sub-systems -(HoneyComb, DPDK). - -FD.io CSIT system is developed using two main coding platforms: Robot -Framework (RF) and Python. 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 -`_. +Overview +======== + +This is the **F**\ast **D**\ata **I**/**O** Project (**FD.io**) **C**\ontinuous +**S**\ystem **I**\ntegration and **T**\esting (**CSIT**) project report for +|csit-release| system testing of |vpp-release|. + +This is the full html version, there is also a reduced +`PDF version of this report`_. + +The report describes CSIT functional and performance tests and their +continuous execution delivered in |csit-release|. A high-level overview is +provided for each CSIT test environment running in :abbr:`LF (Linux Foundation)` +FD.io Continuous Performance Labs. This is followed by summary of all executed +tests against the |vpp-release| and associated FD.io projects and sub-systems +(Honeycomb, DPDK, NSH_SFC), |csit-release| release notes, result highlights and +known issues discovered in CSIT. More detailed description of each environment, +pointers to CSIT test code documentation and detailed test resuls with links to +the source data files are also provided. + +|csit-release| report contains following main sections and sub-sections: + +#. **Introduction** - general introduction to CSIT project; *Overview* - + this section; *General Notes* - general notes related to this report; + *Physical Testbeds* - Description of physical testbeds used in CSIT; + *Performance Test Methodology* - Methodologies used in CSIT. + +#. **VPP Performance** - VPP performance tests executed in physical + FD.io testbeds; *Overview* - tested topologies, test coverage and naming + specifics, methodology for multi-core, packet throughput and latency, and + KVM VM vhost tests; *CSIT Release Notes* - changes in |csit-release|, added + tests, performance changes, environment or methodology changes, known CSIT + issues; *Packet Throughput Graphs* and *Packet Latency + Graphs* - plotted NDR, PDR throughput and latency results from multiple + test job executions; *Throughput Speedup Multi-Core* - plotted core + configuration speedup comparision; *Test Environment* - environment + description; *VPP HTTP Server Performance Results* - plotted HTTP Server + performance; *Documentation* - CSIT source code documentation for VPP + performance tests. + +#. **DPDK Performance** - DPDK performance tests executed in + physical FD.io testbeds; *Overview* - tested topologies, test coverage; + *CSIT Release Notes* - changes in |csit-release|, any known CSIT issues; + *Packet Throughput Graphs* and *Packet Latency Graphs* + - plotted NDR, PDR throughput and latency results from multiple test job + executions; *Test Environment* - environment description; *Documentation* - + CSIT source code documentation for DPDK performance tests. + +#. **VPP Functional** - VPP functional tests executed in virtual + FD.io testbeds; *Overview* - tested virtual topologies, test coverage and + naming specifics; *CSIT Release Notes* - changes in |csit-release|, added + tests, environment or methodology changes, known CSIT issues, tests to be + added; *Test Environment* - environment description ; *Documentation* - + source code documentation for VPP functional tests. + +#. **Honeycomb Functional** - Honeycomb functional tests executed in + virtual FD.io testbeds; *Overview* - tested virtual topologies, test + coverage and naming specifics; *CSIT Release Notes* - changes in CSIT + |release|, added tests, environment or methodology changes, known CSIT issues; + *Test Environment* - environment description; + *Documentation* - source code documentation for Honeycomb functional tests. + +#. **NSH_SFC Functional** - NSH_SFC functional tests executed in + virtual FD.io testbeds; *Overview* - tested virtual topologies, test + coverage and naming specifics; *CSIT Release Notes* - changes in CSIT + |release|, added tests, environment or methodology changes, known CSIT issues; + *Test Environment* - environment description; + *Documentation* - source code documentation for NSH_SFC functional tests. + +#. **DMM Functional** - DMM functional tests executed in + virtual FD.io testbeds; *Overview* - tested virtual topologies, test + coverage and naming specifics; *CSIT Release Notes* - changes in CSIT + |release|, added tests, environment or methodology changes, known CSIT issues; + *Test Environment* - environment description; + *Documentation* - source code documentation for DMM functional tests. + +#. **Detailed Results** - auto-generated results from CSIT jobs + executions using CSIT Robot Framework output files as source data; *VPP + Performance Results*, *DPDK Performance Results*, *VPP Functional + Results*, *Honeycomb Functional Results*, *VPPtest Functional Results*. + +#. **Test Configuration** - auto-generated DUT configuration data from CSIT jobs + executions using CSIT Robot Framework output files as source data; *VPP + Performance Test Configs*, *VPP Functional Test Configs*. + +#. **Test Operational Data** - auto-generated DUT operational data from CSIT jobs + executions using CSIT Robot Framework output files as source data; *VPP + Performance Operational Data*. + +#. **CSIT Framework Documentation** - description of the overall CSIT + framework design hierarchy, CSIT test naming convention, followed by + description of Presentation and Analytics Layer (PAL) introduced in + CSIT-17.07 and description of CSIT RF Tags.