diff options
author | Ana C <ana.cunha@ericsson.com> | 2016-01-07 15:00:56 +0100 |
---|---|---|
committer | Ana Cunha <ana.cunha@ericsson.com> | 2016-01-08 11:47:09 +0000 |
commit | 0bbef8513b2ed9166d57e3467d62c823a134d4e6 (patch) | |
tree | 27ff2091069e93268e8f451578d9dd5aa7551ff4 /docs/configguide/vTC | |
parent | e7e3490a1c77c182a5ab7259bdcc998d7050f385 (diff) |
Rename folders in yardstick/docs
Adapt the naming of the folders under yardstick/docs to the naming adopted by
the release documentation defined by opnfvdocs.
JIRA: -
Change-Id: Icc57720d585abbbf7252bcbf76e2f2a403cb1732
Signed-off-by: Ana C <ana.cunha@ericsson.com>
(cherry picked from commit 463a69e878d891b897fe70af15434615baf6a2e9)
Diffstat (limited to 'docs/configguide/vTC')
-rw-r--r-- | docs/configguide/vTC/README.rst | 87 | ||||
-rw-r--r-- | docs/configguide/vTC/abbreviations.rst | 5 |
2 files changed, 92 insertions, 0 deletions
diff --git a/docs/configguide/vTC/README.rst b/docs/configguide/vTC/README.rst new file mode 100644 index 000000000..ae6fefa59 --- /dev/null +++ b/docs/configguide/vTC/README.rst @@ -0,0 +1,87 @@ +========================== +Virtual Traffic Classifier +========================== + +Overview +======== + +The virtual Traffic Classifier VNF [1], comprises in the current version of +1 VNFC [2]. The VNFC contains both the Traffic Inspection module, and the +Traffic forwarding module, needed to run the VNF. The exploitation of DPI +methods for traffic classification is built around two basic assumptions: + +(i) third parties unaffiliated with either source or recipient are able to +inspect each IP packet’s payload and +(ii) the classifier knows the relevant syntax of each application’s packet +payloads (protocol signatures, data patterns, etc.). + +The proposed 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 Packet Based per Flow State (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 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. ToS field +modification. + +Architecture +============ + +The Traffic Inspection module is the most computationally intensive component +of the VNF. It implements filtering and packet matching algorithms in order to +support the enhanced traffic forwarding capability of the 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 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. type of Service/Differentiated Services Code Point (TOS/DSCP) +multimedia traffic for 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 +================== + +Install +======= + +run the build.sh with root privileges + +Run +=== + +sudo ./pfbridge -a eth1 -b eth2 + +Custom Image +============ + +TBD + +Development Environment +======================= + +Ubuntu 14.04 >= VM diff --git a/docs/configguide/vTC/abbreviations.rst b/docs/configguide/vTC/abbreviations.rst new file mode 100644 index 000000000..a713ee66b --- /dev/null +++ b/docs/configguide/vTC/abbreviations.rst @@ -0,0 +1,5 @@ +Abbreviations for the virtual Traffic Classifier +================================================ + +[1] VNF - Virtual Network Function +[2] VNFC - Virtual Network Function Component |