Add license info and update structure

This change adds license to all .rst files under userguide.
It also combines all configguide files into user guide.
New reference.rst with list of links.
Updated glossary, removed separate directories for apexlake and yardstick
framework.

Change-Id: I6532ed073905b0fa85a17e759ea7dc3c24acb91f
Signed-off-by: Ana C <ana.cunha@ericsson.com>

diff --git a/docs/configguide/yardstick_testcases/01-introduction.rst b/docs/configguide/yardstick_testcases/01-introduction.rst
deleted file mode 100644 (file)
index 6cca287..0000000
--- a/docs/configguide/yardstick_testcases/01-introduction.rst
+++ /dev/null
@@ -1,38 +0,0 @@
-============
-Introduction
-============
-
-**Welcome to Yardstick's documentation !**
-
-.. _Yardstick: https://wiki.opnfv.org/yardstick
-
-Yardstick_ is an OPNFV Project.
-
-The project's goal is to verify infrastructure compliance, from the perspective
-of a :term:`VNF`.
-
-The Project's scope is the development of a test framework, *Yardstick*, test
-cases and test stimuli to enable :term:`NFVI` verification.
-The Project also includes a sample :term:`VNF`, the :term:`VTC`  and its
-experimental framework, *ApexLake* !
-
-The chapter :doc:`02-methodology` describes the methodology implemented by the
-Yardstick Project for :term:`NFVI` verification. The chapter
-:doc:`03-list-of-tcs` includes a list of available Yardstick test cases.
-
-Yardstick is used for verifying the OPNFV infrastructure and some of the OPNFV
-features, listed in :doc:`03-list-of-tcs`.
-
-The *Yardstick* framework is deployed in several  OPNFV community labs. It is
-installer, infrastructure and application independent.
-
-.. _Pharos: https://wiki.opnfv.org/pharos
-
-.. seealso:: Pharos_ for information on OPNFV community labs.
-
-Contact Yardstick
-=================
-
-Feedback? `Contact us`_
-
-.. _Contact us: opnfv-users@lists.opnfv.org

diff --git a/docs/configguide/yardstick_testcases/glossary.rst b/docs/configguide/yardstick_testcases/glossary.rst
deleted file mode 100644 (file)
index 8ce9a6b..0000000
--- a/docs/configguide/yardstick_testcases/glossary.rst
+++ /dev/null
@@ -1,33 +0,0 @@
-==================
-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
deleted file mode 100644 (file)
index 55d4ea3..0000000
--- a/docs/configguide/yardstick_testcases/index.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-==================
-Yardstick Overview
-==================
-
-.. toctree::
-   :maxdepth: 2
-
-   01-introduction
-   02-methodology
-   04-vtc-overview
-   03-list-of-tcs
-   glossary

diff --git a/docs/userguide/01-introduction.rst b/docs/userguide/01-introduction.rst
new file mode 100644 (file)
index 0000000..90c112a
--- /dev/null
+++ b/docs/userguide/01-introduction.rst
@@ -0,0 +1,61 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
+============
+Introduction
+============
+
+**Welcome to Yardstick's documentation !**
+
+.. _Pharos: https://wiki.opnfv.org/pharos
+.. _Yardstick: https://wiki.opnfv.org/yardstick
+.. _Presentation: https://wiki.opnfv.org/_media/opnfv_summit_-_yardstick_project.pdf
+
+Yardstick_ is an OPNFV Project.
+
+The project's goal is to verify infrastructure compliance, from the perspective
+of a Virtual Network Function (:term:`VNF`).
+
+The Project's scope is the development of a test framework, *Yardstick*, test
+cases and test stimuli to enable Network Function Virtualization Infrastructure
+(:term:`NFVI`) verification.
+The Project also includes a sample :term:`VNF`, the Virtual Traffic Classifier
+(:term:`VTC`)  and its experimental framework, *ApexLake* !
+
+*Yardstick* is used in OPNFV for verifying the OPNFV infrastructure and some of
+the OPNFV features. The *Yardstick* framework is deployed in several OPNFV
+community labs. It is *installer*, *infrastructure* and *application*
+independent.
+
+.. seealso:: Pharos_ for information on OPNFV community labs and this
+   Presentation_ for an overview of *Yardstick*
+
+
+About This Document
+===================
+
+This document consists of the following chapters:
+
+* Chapter :doc:`02-methodology` describes the methodology implemented by the
+  Yardstick Project for :term:`NFVI` verification.
+
+* Chapter :doc:`04-vtc-overview` provides information on the :term:`VTC`.
+
+* Chapter :doc:`apexlake_installation` provides instructions to install the
+  experimental framework *ApexLake* and chapter :doc:`apexlake_api` explains
+  how this framework is integrated in *Yardstick*.
+
+* Chapter :doc:`03-installation` provides instructions to install *Yardstick*.
+
+* Chapter :doc:`03-list-of-tcs` includes a list of available Yardstick
+  test cases.
+
+
+Contact Yardstick
+=================
+
+Feedback? `Contact us`_
+
+.. _Contact us: opnfv-users@lists.opnfv.org

diff --git a/docs/configguide/yardstick_testcases/02-methodology.rst b/docs/userguide/02-methodology.rst
similarity index 89%
rename from docs/configguide/yardstick_testcases/02-methodology.rst
rename to docs/userguide/02-methodology.rst
index 5097c56..7fdb5f6 100644 (file)
--- a/docs/configguide/yardstick_testcases/02-methodology.rst
+++ b/docs/userguide/02-methodology.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 ===========
 Methodology
 ===========
@@ -6,12 +11,14 @@ Abstract
 ========
 
 This chapter describes the methodology implemented by the Yardstick project for
-verifying the NFV Infrastructure from the perspective of a VNF.
+verifying the :term:`NFVI` from the perspective of a :term:`VNF`.
 
 ETSI-NFV
 ========
 
 .. _NFV-TST001: https://docbox.etsi.org/ISG/NFV/Open/Drafts/TST001_-_Pre-deployment_Validation/
+.. _Yardsticktst: https://wiki.opnfv.org/_media/opnfv_summit_-_bridging_opnfv_and_etsi.pdf
+
 
 The document ETSI GS NFV-TST001_, "Pre-deployment Testing; Report on Validation
 of NFV Environments and Services", recommends methods for pre-deployment
@@ -20,17 +27,19 @@ testing of the functional components of an NFV environment.
 The Yardstick project implements the methodology described in chapter 6, "Pre-
 deployment validation of NFV infrastructure".
 
-The methodology consists in decomposing the typical VNF work-load performance
-metrics into a number of characteristics/performance vectors, which each can be
-represented by distinct test-cases.
+The methodology consists in decomposing the typical :term:`VNF` work-load
+performance metrics into a number of characteristics/performance vectors, which
+each can be represented by distinct test-cases.
 
 The methodology includes five steps:
 
-* *Step1:* Define Infrastruture - the HW, SW and corresponding configuration
-   target for validation; the OPNFV infrastructure, in OPNFV community labs.
+* *Step1:* Define Infrastruture - the Hardware, Software  and corresponding
+   configuration target for validation; the OPNFV infrastructure, in OPNFV
+   community labs.
 
-* *Step2:* Identify VNF type - the application for which the infrastructure is
-   to be validated, and its requirements on the underlying infrastructure.
+* *Step2:* Identify :term:`VNF` type - the application for which the
+   infrastructure is to be validated, and its requirements on the underlying
+   infrastructure.
 
 * *Step3:* Select test cases - depending on the workload that represents the
    application for which the infrastruture is to be validated, the relevant
@@ -41,6 +50,8 @@ The methodology includes five steps:
 
 * *Step5:* Collect results - using the common API for result collection.
 
+.. seealso:: Yardsticktst_ for material on alignment ETSI TST001 and Yardstick.
+
 Metrics
 =======
 
@@ -157,8 +168,8 @@ options).
 | Category| Performance/Speed | Capacity/Scale | Availability/Reliability     |
 |         |                   |                |                              |
 +---------+-------------------+----------------+------------------------------+
-| Compute | TC003             | TC003          |  TC013 [1]_                  |
-|         | TC004             | TC004          |  TC015 [1]_                  |
+| Compute | TC003 [1]_        | TC003 [1]_     |  TC013 [1]_                  |
+|         | TC004 [1]_        | TC004 [1]_     |  TC015 [1]_                  |
 |         | TC014             | TC010          |                              |
 |         | TC024             | TC012          |                              |
 |         |                   |                |                              |

diff --git a/docs/userguide/yardstick_framework/03-installation.rst b/docs/userguide/03-installation.rst
similarity index 92%
rename from docs/userguide/yardstick_framework/03-installation.rst
rename to docs/userguide/03-installation.rst
index 31f8a92..47a3ea8 100644 (file)
--- a/docs/userguide/yardstick_framework/03-installation.rst
+++ b/docs/userguide/03-installation.rst
@@ -1,14 +1,13 @@
-..
-   TODO As things will change, then this document has to be revised before the
-   next release. Steps:
-   1. Verify that the instructions below are correct and have not been changed.
-   2. Add everything that is currently missing and should be included in this document.
-   3. Make sure each title has a paragraph or an introductory sentence under it.
-   4. Make sure each sentence is grammatically correct and easily understandable.
-   5. Remove this comment section.
-
-Installation
-==============
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
+Yardstick Installation
+======================
+
+Abstract
+--------
 
 Yardstick currently supports installation on Ubuntu 14.04 or by using a Docker
 image. Detailed steps about installing Yardstick using both of these options

diff --git a/docs/configguide/yardstick_testcases/03-list-of-tcs.rst b/docs/userguide/03-list-of-tcs.rst
similarity index 90%
rename from docs/configguide/yardstick_testcases/03-list-of-tcs.rst
rename to docs/userguide/03-list-of-tcs.rst
index bb3fbba..de48c7b 100644 (file)
--- a/docs/configguide/yardstick_testcases/03-list-of-tcs.rst
+++ b/docs/userguide/03-list-of-tcs.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 ====================
 Yardstick Test Cases
 ====================

diff --git a/docs/configguide/yardstick_testcases/04-vtc-overview.rst b/docs/userguide/04-vtc-overview.rst
similarity index 74%
rename from docs/configguide/yardstick_testcases/04-vtc-overview.rst
rename to docs/userguide/04-vtc-overview.rst
index 95159a9..82b20ca 100644 (file)
--- a/docs/configguide/yardstick_testcases/04-vtc-overview.rst
+++ b/docs/userguide/04-vtc-overview.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, National Center of Scientific Research "Demokritos" and others.
+
 ==========================
 Virtual Traffic Classifier
 ==========================
@@ -16,10 +21,11 @@ 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
+The virtual Traffic Classifier (:term:`VTC`) :term:`VNF`, comprises of a
+Virtual Network Function Component (:term:`VNFC`). The :term:`VNFC` contains
+both the Traffic Inspection module, and the Traffic forwarding module, needed
+to run the :term:`VNF`. The exploitation of Deep Packet Inspection
+(:term:`DPI`) methods for traffic classification is built around two basic
 assumptions:
 
 * third parties unaffiliated with either source or recipient are able to
@@ -32,9 +38,10 @@ 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.
+In this respect it follows the Packet Based per Flow State (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
 ========
@@ -46,8 +53,8 @@ identification of network traffic that passes through the :term:`VTC`.
 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.
+predefined set of rules. Packet tagging may include e.g. Type of Service
+(:term:`ToS`) field modification.
 
 Architecture
 ============
@@ -67,8 +74,9 @@ 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.
+marking e.g. :term:`ToS`/Differentiated Services Code Point (:term:`DSCP`)
+multimedia traffic for Quality of Service (: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.
 

diff --git a/docs/configguide/yardstick_testcases/Yardstick_task_templates.rst b/docs/userguide/Yardstick_task_templates.rst
similarity index 94%
rename from docs/configguide/yardstick_testcases/Yardstick_task_templates.rst
rename to docs/userguide/Yardstick_task_templates.rst
index 8185062..e8130dd 100755 (executable)
--- a/docs/configguide/yardstick_testcases/Yardstick_task_templates.rst
+++ b/docs/userguide/Yardstick_task_templates.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 Task Template Syntax
 ====================
 

diff --git a/docs/userguide/apexlake_framework/apexlake_api.rst b/docs/userguide/apexlake_api.rst
similarity index 90%
rename from docs/userguide/apexlake_framework/apexlake_api.rst
rename to docs/userguide/apexlake_api.rst
index 2ef3e43..35a1dbe 100644 (file)
--- a/docs/userguide/apexlake_framework/apexlake_api.rst
+++ b/docs/userguide/apexlake_api.rst
@@ -1,8 +1,18 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
+
 =================================
 Apexlake API Interface Definition
 =================================
 
-The API interface provided by the framework to enable the execution of test cases is defined as follows.
+Abstract
+--------
+
+The API interface provided by the framework to enable the execution of test
+cases is defined as follows.
 
 
 init

diff --git a/docs/userguide/apexlake_framework/index.rst b/docs/userguide/apexlake_framework/index.rst
deleted file mode 100644 (file)
index 47ebfcd..0000000
--- a/docs/userguide/apexlake_framework/index.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-********************************
-Apexlake Framework Documentation
-********************************
-
-.. toctree::
-      :numbered:
-   :maxdepth: 2
-
-   apexlake_installation
-   apexlake_api
-

diff --git a/docs/userguide/apexlake_framework/apexlake_installation.rst b/docs/userguide/apexlake_installation.rst
similarity index 77%
rename from docs/userguide/apexlake_framework/apexlake_installation.rst
rename to docs/userguide/apexlake_installation.rst
index 2e129bf..4870c2e 100644 (file)
--- a/docs/userguide/apexlake_framework/apexlake_installation.rst
+++ b/docs/userguide/apexlake_installation.rst
@@ -1,3 +1,9 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
+
 .. _DPDK: http://dpdk.org/doc/nics
 .. _DPDK-pktgen: https://github.com/Pktgen/Pktgen-DPDK/
 .. _SRIOV: https://wiki.openstack.org/wiki/SR-IOV-Passthrough-For-Networking
@@ -7,35 +13,46 @@
 ============================
 Apexlake Installation Guide
 ============================
-ApexLake is a framework that provides automatic execution of experiments and related data collection to enable
-a user validate infrastructure from the perspective of a Virtual Network Function (VNF).
-In the context of Yardstick, a virtual Traffic Classifier (vTC) network function is utilized.
+
+Abstract
+--------
+
+ApexLake is a framework that provides automatic execution of experiments and
+related data collection to enable a user validate infrastructure from the
+perspective of a Virtual Network Function (:term:`VNF`).
+
+In the context of Yardstick, a virtual Traffic Classifier (:term:`VTC`) network
+function is utilized.
 
 
 Framework Hardware Dependencies
 ===============================
-In order to run the framework there are some hardware related dependencies for ApexLake.
+
+In order to run the framework there are some hardware related dependencies for
+ApexLake.
 
 The framework needs to be installed on the same physical node where DPDK-pktgen_
 is installed.
-The installation requires the physical node hosting the packet generator must have 2 NICs
-which are DPDK_ compatible.
 
-The 2 NICs will be connected to the switch where the OpenStack VM network is managed.
+The installation requires the physical node hosting the packet generator must
+have 2 NICs which are DPDK_ compatible.
 
-The switch used must support multicast traffic and IGMP snooping.
+The 2 NICs will be connected to the switch where the OpenStack VM
+network is managed.
+
+The switch used must support multicast traffic and :term:`IGMP` snooping.
 Further details about the configuration are provided at the following here_.
 
-The corresponding ports to which the cables are connected need to be configured as VLAN trunks
-using two of the VLAN IDs available for Neutron.
+The corresponding ports to which the cables are connected need to be configured
+as VLAN trunks using two of the VLAN IDs available for Neutron.
 Note the VLAN IDs used as they will be required in later configuration steps.
 
 
 Framework Software Dependencies
 ===============================
 Before starting the framework, a number of dependencies must first be installed.
-The following describes the set of instructions to be executed via the Linux shell in order to install
-and configure the required dependencies.
+The following describes the set of instructions to be executed via the Linux
+shell in order to install and configure the required dependencies.
 
 1. Install Dependencies.
 
@@ -66,10 +83,11 @@ After entering the Apexlake directory, run the following command.
 
 4. Create Two Networks based on VLANs in Neutron.
 
-To enable network communications between the packet generator and the compute node,
-two networks must be created via Neutron and mapped to the VLAN IDs
+To enable network communications between the packet generator and the compute
+node, two networks must be created via Neutron and mapped to the VLAN IDs
 that were previously used in the configuration of the physical switch.
-The following shows the typical set of commands required to configure Neutron correctly.
+The following shows the typical set of commands required to configure Neutron
+correctly.
 
 ::
 
@@ -100,17 +118,24 @@ The following shows the typical set of commands required to configure Neutron co
 
 The VLAN tags must also be included in the test case Yardstick yaml file
 as parameters for the following test cases:
-    - TC 006
-    - TC 007
-    - TC 020
-    - TC 021
+
+    * :doc:`opnfv_yardstick_tc006`
+
+    * :doc:`opnfv_yardstick_tc007`
+
+    * :doc:`opnfv_yardstick_tc020`
+
+    * :doc:`opnfv_yardstick_tc021`
 
 
 Install and Configure DPDK Pktgen
 +++++++++++++++++++++++++++++++++
+
 Execution of the framework is based on DPDK Pktgen.
-If DPDK Pktgen has not installed, it is necessary to download, install, compile and configure it.
-The user can create a directory and download the dpdk packet generator source code:
+If DPDK Pktgen has not installed, it is necessary to download, install, compile
+and configure it.
+The user can create a directory and download the dpdk packet generator source
+code:
 
 ::
 
@@ -118,17 +143,20 @@ The user can create a directory and download the dpdk packet generator source co
     mkdir dpdk_pktgen
     git clone https://github.com/pktgen/Pktgen-DPDK.git
 
-For instructions on the installation and configuration of DPDK and DPDK Pktgen please follow the official
-DPDK Pktgen README file.
-Once the installation is completed, it is necessary to load the DPDK kernel driver, as follow:
+For instructions on the installation and configuration of DPDK and DPDK Pktgen
+please follow the official DPDK Pktgen README file.
+Once the installation is completed, it is necessary to load the DPDK kernel
+driver, as follow:
 
 ::
 
     insmod uio
     insmod DPDK_DIR/x86_64-native-linuxapp-gcc/kmod/igb_uio.ko
 
-It is necessary to set the configuration file  to support the desired Pktgen configuration.
-A description of the required configuration parameters and supporting examples is provided in the following:
+It is necessary to set the configuration file  to support the desired Pktgen
+configuration.
+A description of the required configuration parameters and supporting examples
+is provided in the following:
 
 ::
 
@@ -166,18 +194,21 @@ A description of the required configuration parameters and supporting examples i
 
 
 To find the parameters related to names of the NICs and the addresses of the PCI buses
-the user may find it useful to run the DPDK tool nic_bind as follows:
+the user may find it useful to run the :term:`DPDK` tool nic_bind as follows:
 
 ::
 
     DPDK_DIR/tools/dpdk_nic_bind.py --status
 
 Lists the NICs available on the system, and shows the available drivers and bus addresses for each interface.
-Please make sure to select NICs which are DPDK compatible.
+Please make sure to select NICs which are :term:`DPDK` compatible.
 
 Installation and Configuration of smcroute
 ++++++++++++++++++++++++++++++++++++++++++
-The user is required to install smcroute which is used by the framework to support multicast communications.
+
+The user is required to install smcroute which is used by the framework to
+support multicast communications.
+
 The following is the list of commands required to download and install smroute.
 
 ::
@@ -193,7 +224,8 @@ The following is the list of commands required to download and install smroute.
     sudo make install
     cd ..
 
-It is also requires the creation a configuration file using the following command:
+It is also requires the creation a configuration file using the following
+command:
 
     SMCROUTE_NIC=(name of the nic)
 
@@ -211,7 +243,8 @@ Then create the smcroute configuration file /etc/smcroute.conf
     echo mgroup from $SMCROUTE_NIC group 224.192.16.1 > /etc/smcroute.conf
 
 
-At the end of this procedure it will be necessary to perform the following actions to add the user to the sudoers:
+At the end of this procedure it will be necessary to perform the following
+actions to add the user to the sudoers:
 
 ::
 
@@ -221,7 +254,9 @@ At the end of this procedure it will be necessary to perform the following actio
 
 Experiment using SR-IOV Configuration on the Compute Node
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-To enable SR-IOV interfaces on the physical NIC of the compute node, a compatible NIC is required.
-NIC configuration depends on model and vendor. After proper configuration to support SR-IOV,
-a proper configuration of OpenStack is required.
-For further information, please refer to the _SRIOV configuration guide
+
+To enable :term:`SR-IOV` interfaces on the physical NIC of the compute node, a
+compatible NIC is required.
+NIC configuration depends on model and vendor. After proper configuration to
+support :term:`SR-IOV`, a proper configuration of OpenStack is required.
+For further information, please refer to the SRIOV_ configuration guide

diff --git a/docs/userguide/glossary.rst b/docs/userguide/glossary.rst
new file mode 100644 (file)
index 0000000..f8ff418
--- /dev/null
+++ b/docs/userguide/glossary.rst
@@ -0,0 +1,65 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
+========
+Glossary
+========
+
+.. glossary::
+   :sorted:
+
+   API
+     Application Programming Interface
+
+   DPI
+     Deep Packet Inspection
+
+   DPDK
+     Data Plane Development Kit
+
+   DSCP
+     Differentiated Services Code Point
+
+   IGMP
+     Internet Group Management Protocol
+
+   IOPS
+     Input/Output Operations Per Second
+
+   NIC
+     Network Interface Controller
+
+   PBFS
+     Packet Based per Flow State
+
+   QoS
+     Quality of Service
+
+   VLAN
+     Virtual LAN
+
+   VM
+     Virtual Machine
+
+   VNF
+     Virtual Network Function
+
+   VNFC
+     Virtual Network Function Component
+
+   NFVI
+     Network Function Virtualization Infrastructure
+
+   SR-IOV
+     Single Root IO Virtualization
+
+   SUT
+     System Under Test
+
+   ToS
+     Type of Service
+
+   VTC
+     Virtual Traffic Classifier

diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
new file mode 100644 (file)
index 0000000..3cad237
--- /dev/null
+++ b/docs/userguide/index.rst
@@ -0,0 +1,21 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
+==================
+Yardstick Overview
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   01-introduction
+   02-methodology
+   04-vtc-overview
+   apexlake_installation
+   apexlake_api
+   03-installation
+   03-list-of-tcs
+   glossary
+   references

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc001.rst b/docs/userguide/opnfv_yardstick_tc001.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc001.rst
rename to docs/userguide/opnfv_yardstick_tc001.rst
index 810bad4..4cf4b94 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc001.rst
+++ b/docs/userguide/opnfv_yardstick_tc001.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC001
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc002.rst b/docs/userguide/opnfv_yardstick_tc002.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc002.rst
rename to docs/userguide/opnfv_yardstick_tc002.rst
index 56350f5..193fc53 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc002.rst
+++ b/docs/userguide/opnfv_yardstick_tc002.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC002
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc005.rst b/docs/userguide/opnfv_yardstick_tc005.rst
similarity index 96%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc005.rst
rename to docs/userguide/opnfv_yardstick_tc005.rst
index 83b6aed..a181aa9 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc005.rst
+++ b/docs/userguide/opnfv_yardstick_tc005.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC005
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst b/docs/userguide/opnfv_yardstick_tc006.rst
similarity index 98%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst
rename to docs/userguide/opnfv_yardstick_tc006.rst
index b683150..2ccb417 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc006.rst
+++ b/docs/userguide/opnfv_yardstick_tc006.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
 *************************************
 Yardstick Test Case Description TC006
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst b/docs/userguide/opnfv_yardstick_tc007.rst
similarity index 98%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst
rename to docs/userguide/opnfv_yardstick_tc007.rst
index a7a4776..87663f8 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc007.rst
+++ b/docs/userguide/opnfv_yardstick_tc007.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
 *************************************
 Yardstick Test Case Description TC007
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc008.rst b/docs/userguide/opnfv_yardstick_tc008.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc008.rst
rename to docs/userguide/opnfv_yardstick_tc008.rst
index e176e63..a4ecaf6 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc008.rst
+++ b/docs/userguide/opnfv_yardstick_tc008.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC008
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc009.rst b/docs/userguide/opnfv_yardstick_tc009.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc009.rst
rename to docs/userguide/opnfv_yardstick_tc009.rst
index e4002a8..d6f4453 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc009.rst
+++ b/docs/userguide/opnfv_yardstick_tc009.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC009
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc010.rst b/docs/userguide/opnfv_yardstick_tc010.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc010.rst
rename to docs/userguide/opnfv_yardstick_tc010.rst
index ebb74ea..ab793de 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc010.rst
+++ b/docs/userguide/opnfv_yardstick_tc010.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC010
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc011.rst b/docs/userguide/opnfv_yardstick_tc011.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc011.rst
rename to docs/userguide/opnfv_yardstick_tc011.rst
index 6760ce0..1c643cd 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc011.rst
+++ b/docs/userguide/opnfv_yardstick_tc011.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC011
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc012.rst b/docs/userguide/opnfv_yardstick_tc012.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc012.rst
rename to docs/userguide/opnfv_yardstick_tc012.rst
index e7889c1..ffce06e 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc012.rst
+++ b/docs/userguide/opnfv_yardstick_tc012.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC012
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc014.rst b/docs/userguide/opnfv_yardstick_tc014.rst
similarity index 96%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc014.rst
rename to docs/userguide/opnfv_yardstick_tc014.rst
index 68d36ec..27d390a 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc014.rst
+++ b/docs/userguide/opnfv_yardstick_tc014.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC014
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc019.rst b/docs/userguide/opnfv_yardstick_tc019.rst
similarity index 98%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc019.rst
rename to docs/userguide/opnfv_yardstick_tc019.rst
index 482260b..1af5022 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc019.rst
+++ b/docs/userguide/opnfv_yardstick_tc019.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC019
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst b/docs/userguide/opnfv_yardstick_tc020.rst
similarity index 98%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst
rename to docs/userguide/opnfv_yardstick_tc020.rst
index 9a5130f..f2f1d40 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc020.rst
+++ b/docs/userguide/opnfv_yardstick_tc020.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
 *************************************
 Yardstick Test Case Description TC020
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst b/docs/userguide/opnfv_yardstick_tc021.rst
similarity index 98%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst
rename to docs/userguide/opnfv_yardstick_tc021.rst
index a493ddf..c7adc87 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc021.rst
+++ b/docs/userguide/opnfv_yardstick_tc021.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Intel Corporation and others.
+
 *************************************
 Yardstick Test Case Description TC021
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc024.rst b/docs/userguide/opnfv_yardstick_tc024.rst
similarity index 96%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc024.rst
rename to docs/userguide/opnfv_yardstick_tc024.rst
index 1e8d4e6..ffdacb1 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc024.rst
+++ b/docs/userguide/opnfv_yardstick_tc024.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC024
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc025.rst b/docs/userguide/opnfv_yardstick_tc025.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc025.rst
rename to docs/userguide/opnfv_yardstick_tc025.rst
index 0bc0b78..0e2e9a5 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc025.rst
+++ b/docs/userguide/opnfv_yardstick_tc025.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC025
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc027.rst b/docs/userguide/opnfv_yardstick_tc027.rst
similarity index 95%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc027.rst
rename to docs/userguide/opnfv_yardstick_tc027.rst
index 56c8227..6215e6d 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc027.rst
+++ b/docs/userguide/opnfv_yardstick_tc027.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC027
 *************************************
@@ -8,7 +13,7 @@ Yardstick Test Case Description TC027
 |IPv6 connectivity between nodes on the tenant network                        |
 |                                                                             |
 +--------------+--------------------------------------------------------------+
-|test case id  | OPNFV_YARDSTICK_TC002_IPv6 connectivity                      |
+|test case id  | OPNFV_YARDSTICK_TC027_IPv6 connectivity                      |
 |              |                                                              |
 +--------------+--------------------------------------------------------------+
 |metric        | RTT, Round Trip Time                                         |

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc028.rst b/docs/userguide/opnfv_yardstick_tc028.rst
similarity index 96%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc028.rst
rename to docs/userguide/opnfv_yardstick_tc028.rst
index 8ac5f49..24206f3 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc028.rst
+++ b/docs/userguide/opnfv_yardstick_tc028.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co., Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC028
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc037.rst b/docs/userguide/opnfv_yardstick_tc037.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc037.rst
rename to docs/userguide/opnfv_yardstick_tc037.rst
index 5c91f6b..3ed1fa5 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc037.rst
+++ b/docs/userguide/opnfv_yardstick_tc037.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC037
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc038.rst b/docs/userguide/opnfv_yardstick_tc038.rst
similarity index 97%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc038.rst
rename to docs/userguide/opnfv_yardstick_tc038.rst
index 93c2cf3..692c768 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc038.rst
+++ b/docs/userguide/opnfv_yardstick_tc038.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
 *************************************
 Yardstick Test Case Description TC038
 *************************************

diff --git a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc040.rst b/docs/userguide/opnfv_yardstick_tc040.rst
similarity index 95%
rename from docs/configguide/yardstick_testcases/opnfv_yardstick_tc040.rst
rename to docs/userguide/opnfv_yardstick_tc040.rst
index 044ccf1..d62fbf7 100644 (file)
--- a/docs/configguide/yardstick_testcases/opnfv_yardstick_tc040.rst
+++ b/docs/userguide/opnfv_yardstick_tc040.rst
@@ -1,3 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Huawei Technologies Co.,Ltd and others.
+
 *************************************
 Yardstick Test Case Description TC040
 *************************************

diff --git a/docs/userguide/references.rst b/docs/userguide/references.rst
new file mode 100644 (file)
index 0000000..5519261
--- /dev/null
+++ b/docs/userguide/references.rst
@@ -0,0 +1,50 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
+
+==========
+References
+==========
+
+
+OPNFV
+=====
+
+* Parser wiki: https://wiki.opnfv.org/parser
+* Pharos wiki: https://wiki.opnfv.org/pharos
+* VTC: https://wiki.opnfv.org/vtc
+* Yardstick CI: https://build.opnfv.org/ci/view/yardstick/
+* Yardstick and ETSI TST001 presentation: https://wiki.opnfv.org/_media/opnfv_summit_-_bridging_opnfv_and_etsi.pdf
+* Yardstick Project presentation: https://wiki.opnfv.org/_media/opnfv_summit_-_yardstick_project.pdf
+* Yardstick wiki: https://wiki.opnfv.org/yardstick
+
+References used in Test Cases
+=============================
+
+* cirros-image: https://download.cirros-cloud.net
+* cyclictest: https://rt.wiki.kernel.org/index.php/Cyclictest
+* DPDKpktgen: https://github.com/Pktgen/Pktgen-DPDK/
+* DPDK supported NICs: http://dpdk.org/doc/nics
+* fio: http://www.bluestop.org/fio/HOWTO.txt
+* iperf3: https://iperf.fr/
+* Lmbench man-pages: http://manpages.ubuntu.com/manpages/trusty/lat_mem_rd.8.html
+* Memory bandwidth man-pages: http://manpages.ubuntu.com/manpages/trusty/bw_mem.8.html
+* unixbench: https://github.com/kdlucas/byte-unixbench/blob/master/UnixBench
+* mpstat man-pages: http://manpages.ubuntu.com/manpages/trusty/man1/mpstat.1.html
+* pktgen: https://www.kernel.org/doc/Documentation/networking/pktgen.txt
+* SR-IOV: https://wiki.openstack.org/wiki/SR-IOV-Passthrough-For-Networking
+
+Research
+========
+
+* NCSRD: http://www.demokritos.gr/?lang=en
+* T-NOVA: http://www.t-nova.eu/
+* T-NOVA Results: http://www.t-nova.eu/results/
+
+Standards
+=========
+
+* ETSI NFV: http://www.etsi.org/technologies-clusters/technologies/nfv
+* ETSI GS-NFV TST 001: https://docbox.etsi.org/ISG/NFV/Open/Drafts/TST001_-_Pre-deployment_Validation/
+* RFC2544: https://www.ietf.org/rfc/rfc2544.txt

diff --git a/docs/configguide/yardstick_testcases/testcase_description_v2_template.rst b/docs/userguide/testcase_description_v2_template.rst
similarity index 95%
rename from docs/configguide/yardstick_testcases/testcase_description_v2_template.rst
rename to docs/userguide/testcase_description_v2_template.rst
index 1b8754b..91c2a7e 100644 (file)
--- a/docs/configguide/yardstick_testcases/testcase_description_v2_template.rst
+++ b/docs/userguide/testcase_description_v2_template.rst
@@ -1,7 +1,7 @@
-.. Template to be used for test case descriptions in Yardstick Project.
-   Write one .rst per test case.
-   Upload the .rst for the test case in /docs/source/yardstick directory.
-   Review in Gerrit.
+.. This work is licensed under a Creative Commons Attribution 4.0 International
+.. License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV, Ericsson AB and others.
 
 *************************************
 Yardstick Test Case Description TCXXX

diff --git a/docs/userguide/yardstick_framework/index.rst b/docs/userguide/yardstick_framework/index.rst
deleted file mode 100644 (file)
index f982c30..0000000
--- a/docs/userguide/yardstick_framework/index.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-=================================
-Yardstick Framework Documentation
-=================================
-
-.. toctree::
-   :numbered:
-   :maxdepth: 2
-
-   03-installation