2aa870c2a0897d50c35787a38e36b8f1510f1cbb
[yardstick.git] / docs / testing / user / userguide / 01-introduction.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International
2 .. License.
3 .. http://creativecommons.org/licenses/by/4.0
4 .. (c) OPNFV, Ericsson AB and others.
5
6 ============
7 Introduction
8 ============
9
10 **Welcome to Yardstick's documentation !**
11
12 .. _Pharos: https://wiki.opnfv.org/pharos
13 .. _Yardstick: https://wiki.opnfv.org/yardstick
14 .. _Presentation: https://wiki.opnfv.org/download/attachments/2925202/opnfv_summit_-_yardstick_project.pdf?version=1&modificationDate=1458848320000&api=v2
15 Yardstick_ is an OPNFV Project.
16
17 The project's goal is to verify infrastructure compliance, from the perspective
18 of a Virtual Network Function (:term:`VNF`).
19
20 The Project's scope is the development of a test framework, *Yardstick*, test
21 cases and test stimuli to enable Network Function Virtualization Infrastructure
22 (:term:`NFVI`) verification.
23 The Project also includes a sample :term:`VNF`, the Virtual Traffic Classifier
24 (:term:`VTC`)  and its experimental framework, *ApexLake* !
25
26 *Yardstick* is used in OPNFV for verifying the OPNFV infrastructure and some of
27 the OPNFV features. The *Yardstick* framework is deployed in several OPNFV
28 community labs. It is *installer*, *infrastructure* and *application*
29 independent.
30
31 .. seealso:: Pharos_ for information on OPNFV community labs and this
32    Presentation_ for an overview of *Yardstick*
33
34
35 About This Document
36 ===================
37
38 This document consists of the following chapters:
39
40 * Chapter :doc:`01-introduction` provides a brief introduction to yardstick
41   project's goal and scope and gives the structure of this document.
42
43 * Chapter :doc:`02-methodology` describes the methodology implemented by the
44   Yardstick Project for :term:`NFVI` verification.
45
46 * Chapter :doc:`03-architecture` provides information on the software architecture
47   of yardstick.
48
49 * Chapter :doc:`04-installation` provides instructions to install *Yardstick*.
50
51 * Chapter :doc:`05-yardstick_plugin` provides information on how to integrate
52   other OPNFV testing projects into *Yardstick*.
53
54 * Chapter :doc:`06-result-store-InfluxDB` provides inforamtion on how to run
55   plug-in test cases and store test results into community's InfluxDB.
56
57 * Chapter :doc:`07-vtc-overview` provides information on the :term:`VTC`.
58
59 * Chapter :doc:`08-apexlake_installation` provides instructions to install the
60   experimental framework *ApexLake*
61
62 * Chapter :doc:`09-apexlake_api` explains how this framework is integrated in
63   *Yardstick*.
64
65 * Chapter :doc:`10-nsb-overview` describes the methodology implemented by the
66   yardstick - Network service benchmarking to test real world usecase for a
67   given VNF
68
69 * Chapter :doc:`11-nsb_installation` provides instructions to install
70   *Yardstick - Network service benchmarking testing*.
71
72 * Chapter :doc:`12-list-of-tcs` includes a list of available Yardstick test
73   cases.
74
75
76 Contact Yardstick
77 =================
78
79 Feedback? `Contact us`_
80
81 .. _Contact us: opnfv-users@lists.opnfv.org
82