Merge "bug fix: make installer specific changes for baremetal. cater for fuel"

4 files changed, 176 insertions, 2 deletions

diff --git a/docs/how-to-use-docs/01-introduction.rst b/docs/how-to-use-docs/01-introduction.rst
new file mode 100644
index 00000000..74587e81
--- /dev/null
+++ b/docs/how-to-use-docs/01-introduction.rst
@@ -0,0 +1,30 @@
+============

+Introduction

+============

+

+**Welcome to QTIP's documentation !**

+

+.. _QTIP: https://wiki.opnfv.org/yardstick

+

+QTIP_ is an OPNFV Project.

+

+QTIP aims to benchmark OPNFV platforms through a "Bottom up" approach, testing bare-metal components first.

+

+The overall problem this project tries to solve is the general characterization of an OPNFV platform. It will focus on general performance questions that are common to the platform itself, or applicable to multiple OPNFV use cases. QTIP will provide the capability to quantify a platform's performance behavior in a standardized, rigorous, and open way, and a well-documented methodology to reproduce the results by anyone interested.

+

+The chapter :doc:`02-methodology` describes the methodology implemented by the

+QTIP Project for NFVI performance benchmarking. The chapter

+:doc:`03-list-of-testcases` includes a list of available Yardstick test cases.

+

+The *QTIP* framework is deployed in the Dell OPNFV community lab. It is

+infrastructure and application independent.

+

+.. _Pharos: https://wiki.opnfv.org/pharos

+.. seealso:: Pharos_ for information on OPNFV community labs.

+

+Contact QTIP

+=================

+

+Feedback? `Contact us`_

+

+.. _Contact us: opnfv-users@lists.opnfv.org

diff --git a/docs/how-to-use-docs/index.rst b/docs/how-to-use-docs/index.rst
index 36710b32..bbe991b0 100644
--- a/docs/how-to-use-docs/index.rst
+++ b/docs/how-to-use-docs/index.rst
@@ -19,6 +19,7 @@ Contents:
    :maxdepth: 4
 
    documentation-example.rst
+   01-introduction.rst
 
 Indices and tables
 ==================
diff --git a/docs/user_guides/framework/index.rst b/docs/user_guides/framework/index.rst
index b4817d1b..c9a255ad 100644
--- a/docs/user_guides/framework/index.rst
+++ b/docs/user_guides/framework/index.rst
@@ -1 +1,9 @@
-.. populate before the deadline
+=================================
+QTIP Framework Documentation
+=================================
+
+.. toctree::
+   :numbered:
+   :maxdepth: 2
+
+   installation
diff --git a/docs/user_guides/framework/installation.rst b/docs/user_guides/framework/installation.rst
index ebe23471..c1aa8d9b 100644
--- a/docs/user_guides/framework/installation.rst
+++ b/docs/user_guides/framework/installation.rst
@@ -1 +1,136 @@
-.. Populate this before the deadline
+..
+   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
+==============
+
+QTIP currently supports by using a Docker image or by pulling the repo from the upstream
+repository found at https://git.opnfv.org/qtip. Detailed steps about setting up QTIP using both of these options
+can be found below.
+
+To use QTIP you should have access to an OpenStack environment,
+with at least Nova, Neutron, Glance, Keystone and Heat installed.
+
+The steps needed to run QTIP are:
+
+Running QTIP by pulling the upstream code
+-----------------------------------------
+
+.. _install-dependencies:
+
+Setting QTIP framework on Ubuntu 14.04
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Install dependencies:
+::
+
+  sudo apt-get install python-dev
+  sudo apt-get install python-pip
+  sudo apt-get install build-essential
+  sudo apt-get install git wget
+  sudo pip install python-heatclient python-glanceclient python-neutronclient
+
+
+Download source code and install python dependencies:
+::
+
+  git clone https://git.opnfv.org/qtip
+  cd qtip
+
+Installing QTIP using Docker
+---------------------------------
+
+QTIP has a Docker images on the docker hub which can be pull after docker has been installed.
+
+Installing Docker
+^^^^^^^^^^^^^^^^^
+The first step is to install docker:
+::
+
+  sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
+
+
+Add an entry for your Ubuntu operating system
+::
+
+  Open the /etc/apt/sources.list.d/docker.list file in your favorite editor.
+
+If the file doesn’t exist, create it.
+
+Remove any existing entries.
+
+Add an entry for your Ubuntu operating system.
+
+On Ubuntu Trusty 14.04 (LTS)
+::
+
+  deb https://apt.dockerproject.org/repo ubuntu-trusty main
+
+Update the package manager
+::
+
+  sudo apt-get update
+
+Install Docker:
+::
+
+  sudo apt-get install docker-engine
+
+Starting Docker Daemon:
+::
+
+  sudo service docker start
+
+Pulling opnfv/qtip docker image from docker hub:
+::
+
+  sudo docker pull opnfv/qtip
+
+Verify that opnfv/qtip has been downloaded. It should be listed as an image by running the following command.
+::
+
+  sudo docker images
+ 
+Run the Docker instance:
+::
+
+  docker run opnfv/qtip -i -t bash
+
+Now you are in the container and QTIP can be found in the  /repos/qtip and can be navigated to using the following command.
+
+::
+
+  cd repos/qtip
+
+
+OpenStack parameters and credentials
+------------------------------------
+
+
+Environment variables
+^^^^^^^^^^^^^^^^^^^^^
+Before running QTIP it is necessary to export OpenStack environment variables
+from the OpenStack *openrc* file. This can be done by running the following command.
+::
+
+  source get_env_info.sh -n {INSTALLER_TYPE} -i {INSTALLER_IP}
+  source opnfv-creds.sh
+
+This provides a ``opnfv-creds.sh`` file which can be sources to get the environment variables.
+For running QTIP manually, it is also necessary to export the installer type. ::
+
+  export INSTALLER_TYPE="{installer-type}"
+
+QTIP  default key pair
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+QTIP uses a SSH key pair to connect to the guest image. This key pair can
+be found in the ``data/`` directory. 
+
+Examples
+--------
+QTIP Has been made with the intention of requiring minimal interaction from the user.