From 5c44d48479824a3b8609da0a70f7857aa44b893d Mon Sep 17 00:00:00 2001 From: Tibor Frank Date: Wed, 8 Aug 2018 08:04:39 +0200 Subject: [PATCH] CSIT-1232: Edit docs/report/nsh_sfc_functional_tests/overview.rst Change-Id: I5c8c81a971e5e2abde59eb144d707eaea0bf1ea2 Signed-off-by: Tibor Frank --- docs/report/nsh_sfc_functional_tests/overview.rst | 142 +++++++++------------- 1 file changed, 55 insertions(+), 87 deletions(-) diff --git a/docs/report/nsh_sfc_functional_tests/overview.rst b/docs/report/nsh_sfc_functional_tests/overview.rst index a3010f0ae6..c9156fb22d 100644 --- a/docs/report/nsh_sfc_functional_tests/overview.rst +++ b/docs/report/nsh_sfc_functional_tests/overview.rst @@ -1,56 +1,44 @@ Overview ======== -Tested Virtual Topologies -------------------------- - -CSIT NSH_SFC 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. -Majority of the tests are executed in the three node logical test topology - -Traffic Generator (TG) node and two Systems Under Test (SUT) nodes connected in -a loop. Some tests use two node logical test topology - TG node and SUT1 node. -Both logical test topologies are shown in the figures below.:: - - +------------------------+ +------------------------+ - | | | | - | +------------------+ | | +------------------+ | - | | <-----------------> | | - | | | | | | | | - | | DUT1 <-----------------> DUT2 | | - | +--^--^------------+ | | +------------^--^--+ | - | | | | | | | | - | | | SUT1 | | SUT2 | | | - +------------------------+ +------------------------+ - | | | | - | | | | - | | +-----------+ | | - | +---------------> <---------------+ | - | | TG | | - +------------------> <------------------+ - +-----------+ - - +------------------------+ - | | - | +------------------+ | - +---------------> <--------------+ - | | | | | | - | |------------> DUT1 <-----------+ | - | | | +------------------+ | | | - | | | | | | - | | | SUT1 | | | - | | +------------------------+ | | - | | | | - | | | | - | | +-----------+ | | - | +---------------> <---------------+ | - | | TG | | - +------------------> <------------------+ - +-----------+ +Virtual Topologies +------------------ + +CSIT NSH_SFC 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 thru server SUTs, one logical +topology type is used for VPP DUT data plane testing: + +#. NIC-to-NIC switching topologies. + +NIC-to-NIC Switching +~~~~~~~~~~~~~~~~~~~~ + +The simplest logical topology for software data plane application like +VPP is NIC-to-NIC switching. Tested topology for the 3-Node +testbeds is shown in the figure below. + +.. only:: latex + + .. raw:: latex + + \begin{figure}[H] + \centering + \graphicspath{{../_tmp/src/vpp_performance_tests/}} + \includegraphics[width=0.90\textwidth]{logical-3n-nic2nic} + \label{fig:logical-3n-nic2nic} + \end{figure} + +.. only:: html + + .. figure:: ../vpp_performance_tests/logical-3n-nic2nic.svg + :alt: logical-3n-nic2nic + :align: center SUT1 and SUT2 are two VMs (Ubuntu or Centos, depending on the test suite), TG -is a Traffic Generator (TG, another Ubuntu VM). SUTs run VPP SW application in -Linux user-mode as a Device Under Test (DUT) within the VM. TG runs Scapy SW +is a Traffic Generator (TG, another Ubuntu VM). SUTs run NSH_SFC 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. Logical connectivity between SUTs and to TG is provided using virtual NICs using VMs' virtio driver. @@ -62,34 +50,6 @@ 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). -For the test cases that require DUT (VPP) to communicate with VM over the -vhost-user interfaces, a nested VM is created on SUT1 and/or SUT2 for the -duration of these particular test cases only. DUT (VPP) test topology with VM -is shown in the figure below including the applicable packet flow thru the VM -(marked in the figure with ``***``).:: - - +------------------------+ +------------------------+ - | +----------+ | | +----------+ | - | | VM | | | | VM | | - | | ****** | | | | ****** | | - | +--^----^--+ | | +--^----^--+ | - | *| |* | | *| |* | - | +------v----v------+ | | +------v----v------+ | - | | * * |**|***********|**| * * | | - | | ***** *******<----------------->******* ***** | | - | | * DUT1 | | | | DUT2 * | | - | +--^---------------+ | | +---------------^--+ | - | *| | | |* | - | *| SUT1 | | SUT2 |* | - +------------------------+ +------------------^-----+ - *| |* - *| |* - *| +-----------+ |* - *| | | |* - *+------------------> TG <------------------+* - ******************* | |******************** - +-----------+ - NSH_SFC Functional Tests Coverage --------------------------------- @@ -97,22 +57,30 @@ Following NSH_SFC functional test areas are covered in the |csit-release| with results listed in this report: - **NSH SFC Classifier** - TG sends some TCP packets to test NSH SFC - Classifier functional. DUT1 will receive these packets from one NIC and loopback - the VXLAN-GPE-NSH encapsulated packets to the TG from other NIC. + Classifier functional. DUT1 will receive these packets from one NIC and + loopback the VXLAN-GPE-NSH encapsulated packets to the TG from other NIC. + - Test case count: 7 + - **NSH SFC Proxy Inbound** - TG sends some VXLAN-GPE-NSH encapsulated packets - to test NSH SFC Proxy Inbound functional. DUT1 will receive these packets from one - NIC and loopback the VXLAN encapsulated packets to the TG from other NIC. + to test NSH SFC Proxy Inbound functional. DUT1 will receive these packets from + one NIC and loopback the VXLAN encapsulated packets to the TG from other NIC. + - Test case count: 6 + - **NSH SFC Proxy Outbound** - TG sends some VXLAN encapsulated packets to test - NSH SFC Proxy Outbound functional. DUT1 will receive these packets from one NIC - and loopback the VXLAN-GPE-NSH encapsulated packets to the TG from other NIC. + NSH SFC Proxy Outbound functional. DUT1 will receive these packets from one + NIC and loopback the VXLAN-GPE-NSH encapsulated packets to the TG from other + NIC. + - Test case count: 6 -- **NSH SFC Service Function Forward** - TG sends some VXLAN-GPE-NSH encapsulated - packets to test NSH SFC Service Function Forward functional. DUT1 will receive these - packets from one NIC and swap the VXLAN-GPE-NSH header, after that DUT1 loopback the - VXLAN-GPE-NSH encapsulated packtes to the TG from other NIC. + +- **NSH SFC Service Function Forward** - TG sends some VXLAN-GPE-NSH + encapsulated packets to test NSH SFC Service Function Forward functional. DUT1 + will receive these packets from one NIC and swap the VXLAN-GPE-NSH header, + after that DUT1 loopback the VXLAN-GPE-NSH encapsulated packtes to the TG from + other NIC. + - Test case count: 6 Total 25 NSH SFC functional tests in the |csit-release|. - -- 2.16.6