X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fdmm_functional_tests%2Foverview.rst;h=562fa09eb7519a37136ba7b8d30aaea5c84847d5;hp=d30398a2827af48cb25f3aead81fc627edfe2317;hb=b8502d5ccf9030270fafe06fe860143b5f9b78d0;hpb=468da48d3f3ced298ff8dccc76885157dff5cfe7 diff --git a/docs/report/dmm_functional_tests/overview.rst b/docs/report/dmm_functional_tests/overview.rst index d30398a282..562fa09eb7 100644 --- a/docs/report/dmm_functional_tests/overview.rst +++ b/docs/report/dmm_functional_tests/overview.rst @@ -4,20 +4,13 @@ Overview Virtual Topologies ------------------ -CSIT DMM functional tests are executed on virtualized topologies created using -:abbr:`VIRL (Virtual Internet Routing Lab)` simulation platform contributed by -Cisco. VIRL runs on physical baremetal servers hosted by LF FD.io project. -Based on the packet path through server SUTs, one logical topology type -is used for DMM DUT data plane testing: +CSIT DMM functional tests are executed in VM-based virtual topologies +created on demand using :abbr:`VIRL (Virtual Internet Routing Lab)` +simulation platform contributed by Cisco. VIRL runs on physical +baremetal servers hosted by LF FD.io project. -#. NIC-to-NIC switching topologies. - -NIC-to-NIC Switching -~~~~~~~~~~~~~~~~~~~~ - -The simplest logical topology for software data plane application like -DMM is NIC-to-NIC switching. Tested topologies for the 3-Node -testbed is shown in the figure below. +All tests are executed in three-node virtual test topology shown in the +figure below. .. only:: latex @@ -25,42 +18,36 @@ testbed is shown in the figure below. \begin{figure}[H] \centering - \graphicspath{{../_tmp/src/vpp_performance_tests/}} - \includegraphics[width=0.90\textwidth]{logical-3n-nic2nic} - \label{fig:logical-3n-nic2nic} + \graphicspath{{../_tmp/src/vpp_functional_tests/}} + \includegraphics[width=0.90\textwidth]{virtual-3n-nic2nic} + \label{fig:virtual-3n-nic2nic} \end{figure} .. only:: html - .. figure:: ../vpp_performance_tests/logical-3n-nic2nic.svg - :alt: logical-3n-nic2nic + .. figure:: ../vpp_functional_tests/virtual-3n-nic2nic.svg + :alt: virtual-3n-nic2nic :align: center -SUT1 and SUT2 are two VMs (Ubuntu), TG -is a Traffic Generator (TG, another Ubuntu VM). SUTs run sample server-client -application using the DMM libs in Linux user-mode as a Device Under Test (DUT) -within the VM. Currently TG node is not being used in DMM-CSIT. Logical -connectivity between SUTs is provided using virtual NICs using VMs' virtio -driver. - -Virtual testbeds are created on-demand whenever a verification job is started -(e.g. triggered by the gerrit patch submission) and destroyed upon completion -of all functional tests. Each node is a Virtual Machine and each connection -that is drawn on the diagram is available for use in any test case. During the -test execution, all nodes are reachable through the Management network connected -to every node via dedicated virtual NICs and virtual links (not shown above -for clarity). - -DMM Functional Tests Coverage ------------------------------ - -Following DMM functional test areas are covered in the |csit-release| with -results listed in this report: - -- **DMM basic testcase** - DMM has only one test case right now. - The testcase demonstrates single server[DUT1] and single client[DUT2] scenario - using DMM framework and kernel tcp/ip stack. - - - Test case count: 1 - -Total 1 DMM functional test in the |csit-release|. +SUT1 and SUT2 are two VMs (running Ubuntu), TG is a Traffic Generator VM +(running Ubuntu). SUTs run +sample server-client application using the DMM libraries in Linux user- +mode as a Device Under Test (DUT) within the VM. Currently TG node is +not being used in DMM-CSIT. Network connectivity between SUTs and to TG +is provided using virtual NICs and VMs' virtio drivers. + +Functional Tests Coverage +------------------------- + +|csit-release| includes following DMM functionality tested in virtual VM +environment: + ++-----------------------+----------------------------------------------+ +| Functionality | Description | ++=======================+==============================================+ +| DMM basic operation | DMM has only one test case right now. The | +| | testcase demonstrates single server[DUT1] | +| | and single client[DUT2] scenario using DMM | +| | framework and kernel tcp/ip stack. | +| | Test case count: 1. | ++-----------------------+----------------------------------------------+