X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fvpp_functional_tests%2Foverview.rst;fp=docs%2Freport%2Fvpp_functional_tests%2Foverview.rst;h=0000000000000000000000000000000000000000;hb=9063ade3cc3652a320b8f81a6b5211fcc7ab087d;hp=510f204bdf6b169b6068c00b1a84e144ee5dbc02;hpb=32c7c25c5bfa7577543129dec02e790a88b60a2b;p=csit.git diff --git a/docs/report/vpp_functional_tests/overview.rst b/docs/report/vpp_functional_tests/overview.rst deleted file mode 100644 index 510f204bdf..0000000000 --- a/docs/report/vpp_functional_tests/overview.rst +++ /dev/null @@ -1,121 +0,0 @@ -Overview -======== - -Virtual Topologies ------------------- - -CSIT VPP 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. Based on the packet path -thru SUT VMs, two distinct logical topology types are used for VPP DUT -data plane testing: - -#. vNIC-to-vNIC switching topologies. -#. Nested-VM service switching topologies. - -vNIC-to-vNIC Switching -~~~~~~~~~~~~~~~~~~~~~~ - -The simplest virtual topology for software data plane application like -VPP is vNIC-to-vNIC switching. Tested virtual topologies for 2-Node and -3-Node testbeds are shown in figures below. - -.. only:: latex - - .. raw:: latex - - \begin{figure}[H] - \centering - \graphicspath{{../_tmp/src/vpp_functional_tests/}} - \includegraphics[width=0.90\textwidth]{virtual-2n-nic2nic} - \label{fig:virtual-2n-nic2nic} - \end{figure} - -.. only:: html - - .. figure:: ../vpp_functional_tests/virtual-2n-nic2nic.svg - :alt: virtual-2n-nic2nic - :align: center - - -.. only:: latex - - .. raw:: latex - - \begin{figure}[H] - \centering - \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_functional_tests/virtual-3n-nic2nic.svg - :alt: virtual-3n-nic2nic - :align: center - -SUT1 and SUT2 are two VMs (running Ubuntu or Centos, depending on the test -suite), TG is a Traffic Generator (running Ubuntu VM). SUTs run VPP -SW application in Linux user-mode as a Device Under Test (DUT) within -the VM. TG runs Scapy SW application as a packet Traffic Generator. -Network connectivity between SUTs and to TG is provided using virtual -NICs and VMs' virtio drivers. - -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 thru -the Management network connected to every node via dedicated virtual -NICs and virtual links (not shown above for clarity). - -Nested-VM Service Switching -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Nested-VM (Virtual Machine) service switching topology test cases -require VPP DUT to communicate with nested-VM(s) over vhost-user virtual -interfaces. Nested-VM(s) is(are) created on SUT1 and/or SUT2 for the -duration of these particular test cases only. Virtual test topology with -nested-VM(s) is shown in the figure below. - -.. only:: latex - - .. raw:: latex - - \begin{figure}[H] - \centering - \graphicspath{{../_tmp/src/vpp_functional_tests/}} - \includegraphics[width=0.90\textwidth]{virtual-3n-vm-vhost} - \label{fig:virtual-3n-vm-vhost} - \end{figure} - -.. only:: html - - .. figure:: ../vpp_functional_tests/virtual-3n-vm-vhost.svg - :alt: virtual-3n-vm-vhost - :align: center - -Functional Tests Coverage -------------------------- - -|csit-release| includes following VPP functionality tested in virtual VM -environment: - -+-----------------------+----------------------------------------------+ -| Functionality | Description | -+=======================+==============================================+ -| LISP | Locator/ID Separation Protocol overlay | -| | tunnels and locator/id mapping control. | -+-----------------------+----------------------------------------------+ - -Functional Tests Naming ------------------------ - -|csit-release| follows a common structured naming convention for all -performance and system functional tests, introduced in CSIT-17.01. - -The naming should be intuitive for majority of the tests. Complete -description of CSIT test naming convention is provided on -:ref:`csit_test_naming`.