CSIT-1229: Add DMM to report
[csit.git] / docs / report / dmm_functional_tests / overview.rst
1 Overview
2 ========
3
4 Virtual Topologies
5 ------------------
6
7 CSIT DMM functional tests are executed on virtualized topologies created using
8 :abbr:`VIRL (Virtual Internet Routing Lab)` simulation platform contributed by
9 Cisco. VIRL runs on physical baremetal servers hosted by LF FD.io project.
10 Based on the packet path through server SUTs, one logical topology type
11 is used for DMM DUT data plane testing:
12
13 #. NIC-to-NIC switching topologies.
14
15 NIC-to-NIC Switching
16 ~~~~~~~~~~~~~~~~~~~~
17
18 The simplest logical topology for software data plane application like
19 DMM is NIC-to-NIC switching. Tested topologies for the 3-Node
20 testbed is shown in the figure below.
21
22 .. only:: latex
23
24     .. raw:: latex
25
26         \begin{figure}[H]
27             \centering
28                 \graphicspath{{../_tmp/src/vpp_performance_tests/}}
29                 \includegraphics[width=0.90\textwidth]{logical-3n-nic2nic}
30                 \label{fig:logical-3n-nic2nic}
31         \end{figure}
32
33 .. only:: html
34
35     .. figure:: ../vpp_performance_tests/logical-3n-nic2nic.svg
36         :alt: logical-3n-nic2nic
37         :align: center
38
39 SUT1 and SUT2 are two VMs (Ubuntu), TG
40 is a Traffic Generator (TG, another Ubuntu VM). SUTs run sample server-client
41 application using the DMM libs in Linux user-mode as a Device Under Test (DUT)
42 within the VM. Currently TG node is not being used in DMM-CSIT. Logical
43 connectivity between SUTs is provided using virtual NICs using VMs' virtio
44 driver.
45
46 Virtual testbeds are created on-demand whenever a verification job is started
47 (e.g. triggered by the gerrit patch submission) and destroyed upon completion
48 of all functional tests. Each node is a Virtual Machine and each connection
49 that is drawn on the diagram is available for use in any test case. During the
50 test execution, all nodes are reachable through the Management network connected
51 to every node via dedicated virtual NICs and virtual links (not shown above
52 for clarity).
53
54 DMM Functional Tests Coverage
55 -----------------------------
56
57 Following DMM functional test areas are covered in the |csit-release| with
58 results listed in this report:
59
60 - **DMM basic testcase** - DMM has only one test case right now.
61   The testcase demonstrates single server[DUT1] and single client[DUT2] scenario
62   using DMM framework and kernel tcp/ip stack.
63
64   - Test case count: 1
65
66 Total 1 DMM functional test in the |csit-release|.