diff options
author | Lovett, Trevor <trevor.lovett@att.com> | 2019-02-15 18:17:14 -0600 |
---|---|---|
committer | Lovett, Trevor <trevor.lovett@att.com> | 2019-02-16 08:47:41 -0600 |
commit | bcbac1a1498b4f064fba575f7cbe8cb9b3663cd8 (patch) | |
tree | 8a185fa51017e0788162dec8ffa5d9d9d7d697cc /docs/installation.rst | |
parent | 023d74cc2d436659398743c412a602c6c1777fcb (diff) |
[VVP] Doc for GUI, Docker, and Deprecation
Revising documentation to reflect the deprecation
of the VVP web application as well as adding
documentation for the new additions such as:
* Alternate report options
* Native GUI tool
* Docker execution
Change-Id: Ia1b1e99e7d5fb657286efb281049e4550a80d1b6
Issue-ID: VVP-137
Signed-off-by: Lovett, Trevor (tl2972) <tl2972@att.com>
Diffstat (limited to 'docs/installation.rst')
-rw-r--r-- | docs/installation.rst | 52 |
1 files changed, 46 insertions, 6 deletions
diff --git a/docs/installation.rst b/docs/installation.rst index 0353ec4..a20bbed 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -1,14 +1,54 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -.. Copyright 2017 AT&T Intellectual Property. All rights reserved. +.. Copyright 2019 AT&T Intellectual Property. All rights reserved. + +.. _vvp-installation: Installation -================== +============ + +The VNF Validation Platform (VVP) can be run from source as a normal +Python executable or a Docker image is provided. This section will +describe how to setup and install the ``vvp/validation-scripts`` and +run from source. -Installation happens through the vvp-devkit project. +Installation and configuration of Docker is beyond the scope of this document, +but you can refer to the :ref:`Docker Execution <vvp-docker-execution>` +instructions for more details on running the validations as from +the Docker image. -Environment +Pre-requisites -------------- -Steps ----------- +This document assumes you have the following system-level utilities +installed. + +Please refer to the respective sites for these tools for the appropriate +installation instructions for your given operating system. + +* `Python 3.6+ <https://www.python.org/downloads/>`__ +* `Git <https://git-scm.com/>`__ + +Setup +------ + +The source code for VVP can be obtained from the `ONAP Gerrit site <https://gerrit.onap.org/r/#/admin/projects/vvp/validation-scripts>`__ +or its `GitHub mirror <https://github.com/onap/vvp-validation-scripts>`__. + +1. Clone the source from your desired repository host: + + Choose **one** of the following ``git clone`` commands:: + + > git clone https://github.com/onap/vvp-validation-scripts.git + > git clone https://gerrit.onap.org/r/vvp/validation-scripts + +2. (*Optional*) If desired, you can create a virtual Python environment to + avoid installing VVP's dependencies in your system level installation + of Python:: + + > python -m venv vvp + > source vvp/activate + +3. Install the required dependencies with the following command:: + + > python pip install -r requirements.txt |