summaryrefslogtreecommitdiffstats
path: root/docs/user_guides
diff options
context:
space:
mode:
authorMofassirArif <Mofassir_Arif@dellteam.com>2016-01-18 03:21:00 -0800
committerMofassirArif <Mofassir_Arif@dellteam.com>2016-01-18 03:21:00 -0800
commit254ebb0efff73faa2285cf9f1ce70298a9787cb0 (patch)
treef1db3134cc453762dec3b9fe347b2f017b6c8dc5 /docs/user_guides
parent28258ccf7196e24ad53617edb14c344ff63130fb (diff)
bug fix: make installer specific changes for baremetal. cater
for fuel Change-Id: Ie8c233873041238e3fc1aaaa653653552c7c7428 Signed-off-by: MofassirArif <Mofassir_Arif@dellteam.com>
Diffstat (limited to 'docs/user_guides')
-rw-r--r--docs/user_guides/framework/index.rst10
-rw-r--r--docs/user_guides/framework/installation.rst137
2 files changed, 145 insertions, 2 deletions
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.