Include vTC overview in Yardstick documentation

This change includes the vTC overview in Yardstick configguide, the
original vTC/README has been renamed to 04-vTC-overview and added in the
configguide.

The vTC/abbreviations is deleted, all included in glossary.rst

Index and 03-list-of-tcs are updated.

JIRA:-

Change-Id: Ifc5cf1cc258dee6743af189f347e8adbbec6a32f
Signed-off-by: Ana C <ana.cunha@ericsson.com>
(cherry picked from commit 12521edea1e40e73e2fb04f4f230760de324521b)

8 files changed, 198 insertions, 32 deletions

diff --git a/docs/configguide/yardstick_testcases/03-list-of-tcs.rst b/docs/configguide/yardstick_testcases/03-list-of-tcs.rst
index 99be668b8..f72d80b75 100644
--- a/docs/configguide/yardstick_testcases/03-list-of-tcs.rst
+++ b/docs/configguide/yardstick_testcases/03-list-of-tcs.rst
@@ -12,7 +12,8 @@ Yardstick test cases are divided in two main categories:
 described in :doc:`02-methodology`
 
 * *OPNFV Feature Test Cases* - Test Cases developed to verify one or more
-aspect of a feature delivered by an OPNFV Project.
+aspect of a feature delivered by an OPNFV Project, including the test cases
+developed for the :term:`VTC`.
 
 Generic NFVI Test Case Descriptions
 ===================================
@@ -28,15 +29,38 @@ Generic NFVI Test Case Descriptions
    opnfv_yardstick_tc010.rst
    opnfv_yardstick_tc012.rst
    opnfv_yardstick_tc014.rst
-   opnfv_yardstick_tc027.rst
    opnfv_yardstick_tc037.rst
    opnfv_yardstick_tc038.rst
-   opnfv_yardstick_tc040.rst
 
 OPNFV Feature Test Cases
 ========================
 
+IPv6
+----
+
+.. toctree::
+   :maxdepth: 1
+
+   opnfv_yardstick_tc027.rst
+
+Parser
+------
+
+.. toctree::
+   :maxdepth: 1
+
+   opnfv_yardstick_tc040.rst
+
+virtual Traffic Classifier
+--------------------------
+
+.. toctree::
+   :maxdepth: 1
 
+   opnfv_yardstick_tc006.rst
+   opnfv_yardstick_tc007.rst
+   opnfv_yardstick_tc020.rst
+   opnfv_yardstick_tc021.rst
 
 Templates
 =========
diff --git a/docs/configguide/yardstick_testcases/04-vtc-overview.rst b/docs/configguide/yardstick_testcases/04-vtc-overview.rst
new file mode 100644
index 000000000..95159a9bc
--- /dev/null
+++ b/docs/configguide/yardstick_testcases/04-vtc-overview.rst
@@ -0,0 +1,114 @@
+==========================
+Virtual Traffic Classifier
+==========================
+
+Abstract
+========
+
+.. _TNOVA: http://www.t-nova.eu/
+.. _TNOVAresults: http://www.t-nova.eu/results/
+.. _Yardstick: https://wiki.opnfv.org/yardstick
+
+This chapter provides an overview of the virtual Traffic Classifier, a
+contribution to OPNFV Yardstick_ from the EU Project TNOVA_.
+Additional documentation is available in TNOVAresults_.
+
+Overview
+========
+
+The virtual Traffic Classifier :term:`VNF`, the :term:`VTC`, comprises of a
+:term:`VNFC`. The :term:`VNFC` contains both the Traffic Inspection module, and
+the Traffic forwarding module, needed to run the VNF. The exploitation of
+:term:`DPI` methods for traffic classification is built around two basic
+assumptions:
+
+* third parties unaffiliated with either source or recipient are able to
+inspect each IP packet’s payload
+
+* the classifier knows the relevant syntax of each application’s packet
+payloads (protocol signatures, data patterns, etc.).
+
+The proposed :term:`DPI` based approach will only use an indicative, small
+number of the initial packets from each flow in order to identify the content
+and not inspect each packet.
+
+In this respect it follows the :term:`PBFS`. This method uses a table to track
+each session based on the 5-tuples (src address, dest address, src port,dest
+port, transport protocol) that is maintained for each flow.
+
+Concepts
+========
+
+* *Traffic Inspection*: The process of packet analysis and application
+identification of network traffic that passes through the :term:`VTC`.
+
+* *Traffic Forwarding*: The process of packet forwarding from an incoming
+network interface to a pre-defined outgoing network interface.
+
+* *Traffic Rule Application*: The process of packet tagging, based on a
+predefined set of rules. Packet tagging may include e.g. :term:`ToS` field
+modification.
+
+Architecture
+============
+
+The Traffic Inspection module is the most computationally intensive component
+of the :term:`VNF`. It implements filtering and packet matching algorithms in
+order to support the enhanced traffic forwarding capability of the :term:`VNF`.
+The component supports a flow table (exploiting hashing algorithms for fast
+indexing of flows) and an inspection engine for traffic classification.
+
+The implementation used for these experiments exploits the nDPI library.
+The packet capturing mechanism is implemented using libpcap. When the
+:term:`DPI` engine identifies a new flow, the flow register is updated with the
+appropriate information and transmitted across the Traffic Forwarding module,
+which then applies any required policy updates.
+
+The Traffic Forwarding moudle is responsible for routing and packet forwarding.
+It accepts incoming network traffic, consults the flow table for classification
+information for each incoming flow and then applies pre-defined policies
+marking e.g. :term:`ToS`/:term:`DSCP` multimedia traffic for :term:`QoS`
+enablement on the forwarded traffic.
+It is assumed that the traffic is forwarded using the default policy until it
+is identified and new policies are enforced.
+
+The expected response delay is considered to be negligible, as only a small
+number of packets are required to identify each flow.
+
+Graphical Overview
+==================
+
+.. code-block:: console
+
+  +----------------------------+
+  |                            |
+  | Virtual Traffic Classifier |
+  |                            |
+  |     Analysing/Forwarding   |
+  |        ------------>       |
+  |     ethA          ethB     |
+  |                            |
+  +----------------------------+
+       |              ^
+       |              |
+       v              |
+  +----------------------------+
+  |                            |
+  |     Virtual Switch         |
+  |                            |
+  +----------------------------+
+
+Install
+=======
+
+run the build.sh with root privileges
+
+Run
+===
+
+sudo ./pfbridge -a eth1 -b eth2
+
+Development Environment
+=======================
+
+Ubuntu 14.04
diff --git a/docs/configguide/yardstick_testcases/glossary.rst b/docs/configguide/yardstick_testcases/glossary.rst
index 67e126f58..8ce9a6ba0 100644
--- a/docs/configguide/yardstick_testcases/glossary.rst
+++ b/docs/configguide/yardstick_testcases/glossary.rst
@@ -5,11 +5,29 @@ Yardstick Glossary
 .. glossary::
    :sorted:
 
+   DPI
+     Deep Packet Inspection
+
+   DSCP
+     Differentiated Services Code Point
+
+   PBFS
+     Packet Based per Flow State
+
+   QoS
+     Quality of Service
+
    VNF
      Virtual Network Function
 
+   VNFC
+     Virtual Network Function Component
+
    NFVI
      Network Function Virtualization Infrastructure
 
+   ToS
+     Type of Service
+
    VTC
      Virtual Traffic Classifier
diff --git a/docs/configguide/yardstick_testcases/index.rst b/docs/configguide/yardstick_testcases/index.rst
index ccea55ccb..55d4ea3e1 100644
--- a/docs/configguide/yardstick_testcases/index.rst
+++ b/docs/configguide/yardstick_testcases/index.rst
@@ -7,5 +7,6 @@ Yardstick Overview
 
    01-introduction
    02-methodology
+   04-vtc-overview
    03-list-of-tcs
    glossary
diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst
index b9fbf016e..b68315078 100644
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst
+++ b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst
@@ -1,13 +1,14 @@
-.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
-.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
-
-
 *************************************
 Yardstick Test Case Description TC006
 *************************************
+
+.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
+.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
+
 +-----------------------------------------------------------------------------+
 |Network Performance                                                          |
-+==============+==============================================================+
+|                                                                             |
++--------------+--------------------------------------------------------------+
 |test case id  | OPNFV_YARDSTICK_TC006_Virtual Traffic Classifier Data Plane  |
 |              | Throughput Benchmarking Test.                                |
 |              |                                                              |
@@ -74,7 +75,9 @@ Yardstick Test Case Description TC006
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
 |references    | DPDK Pktgen: DPDKpktgen_                                     |
+|              |                                                              |
 |              | ETSI-NFV-TST001                                              |
+|              |                                                              |
 |              | RFC 2544: rfc2544_                                           |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
@@ -99,10 +102,10 @@ Yardstick Test Case Description TC006
 |              |      (For further instructions please refer to the ApexLake  |
 |              |      documentation).                                         |
 |              |                                                              |
-+-----------------------------------------------------------------------------+
++--------------+--------------------------------------------------------------+
 |test sequence | Description and expected results                             |
 |              |                                                              |
-+-----------------------------------------------------------------------------+
++--------------+--------------------------------------------------------------+
 |step  1       | The vTC is deployed, according to the user-defined           |
 |              | configuration                                                |
 |              |                                                              |
diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst
index ec372c232..a7a4776d5 100644
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst
+++ b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst
@@ -1,15 +1,14 @@
-.. image:: ../../etc/opnfv-logo.png
-  :height: 40
-  :width: 200
-  :alt: OPNFV
-  :align: left
-
 *************************************
 Yardstick Test Case Description TC007
 *************************************
+
+.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
+.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
+
 +-----------------------------------------------------------------------------+
 |Network Performance                                                          |
-+==============+==============================================================+
+|                                                                             |
++--------------+--------------------------------------------------------------+
 |test case id  | OPNFV_YARDSTICK_TC007_Virtual Traffic Classifier Data Plane  |
 |              |  Throughput Benchmarking Test in Presence of Noisy           |
 |              |  neighbours                                                  |
@@ -89,9 +88,11 @@ Yardstick Test Case Description TC007
 |              | hence it needs to be installed by the user.                  |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
-|references    | DPDK Pktgen: https://github.com/Pktgen/Pktgen-DPDK/          |
+|references    | DPDKpktgen_                                                  |
+|              |                                                              |
 |              | ETSI-NFV-TST001                                              |
-|              | RFC 2544  https://www.ietf.org/rfc/rfc2544.txt               |
+|              |                                                              |
+|              | rfc2544_                                                     |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
 |applicability | Test can be configured with different flavors, vNIC type     |
diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst
index cda5420b0..9a5130f71 100644
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst
+++ b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst
@@ -1,15 +1,14 @@
-.. image:: ../../etc/opnfv-logo.png
-  :height: 40
-  :width: 200
-  :alt: OPNFV
-  :align: left
-
 *************************************
 Yardstick Test Case Description TC020
 *************************************
+
+.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
+.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
+
 +-----------------------------------------------------------------------------+
 |Network Performance                                                          |
-+==============+==============================================================+
+|                                                                             |
++--------------+--------------------------------------------------------------+
 |test case id  | OPNFV_YARDSTICK_TC0020_Virtual Traffic Classifier            |
 |              | Instantiation Test                                           |
 |              |                                                              |
@@ -71,9 +70,11 @@ Yardstick Test Case Description TC020
 |              | hence it needs to be installed by the user.                  |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
-|references    | DPDK Pktgen: https://github.com/Pktgen/Pktgen-DPDK/          |
+|references    | DPDKpktgen_                                                  |
+|              |                                                              |
 |              | ETSI-NFV-TST001                                              |
-|              | RFC 2544  https://www.ietf.org/rfc/rfc2544.txt               |
+|              |                                                              |
+|              | rfc2544_                                                     |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
 |applicability | Test can be configured with different flavors, vNIC type     |
diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst
index 1094e4f29..a493ddfc0 100644
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst
+++ b/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst
@@ -1,12 +1,14 @@
-.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
-.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
-
 *************************************
 Yardstick Test Case Description TC021
 *************************************
+
+.. _DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
+.. _rfc2544: https://www.ietf.org/rfc/rfc2544.txt
+
 +-----------------------------------------------------------------------------+
 |Network Performance                                                          |
-+==============+==============================================================+
+|                                                                             |
++--------------+--------------------------------------------------------------+
 |test case id  | OPNFV_YARDSTICK_TC0021_Virtual Traffic Classifier            |
 |              | Instantiation Test in Presence of Noisy Neighbours           |
 |              |                                                              |
@@ -83,7 +85,9 @@ Yardstick Test Case Description TC021
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
 |references    | DPDK Pktgen: DPDK Pktgen: DPDKpktgen_                        |
+|              |                                                              |
 |              | ETSI-NFV-TST001                                              |
+|              |                                                              |
 |              | RFC 2544: rfc2544_                                           |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+