aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/apidocs/index.rst4
-rw-r--r--docs/apidocs/qtip_restful_api.rst4
-rw-r--r--docs/configguide/configuration.rst8
-rw-r--r--docs/configguide/index.rst4
-rw-r--r--docs/designspec/dashboard.rst70
-rw-r--r--docs/designspec/index.rst13
-rw-r--r--docs/overview/index.rst5
-rw-r--r--docs/overview/overview.rst4
-rw-r--r--docs/userguide/index.rst4
-rw-r--r--docs/userguide/introduction.rst4
10 files changed, 102 insertions, 18 deletions
diff --git a/docs/apidocs/index.rst b/docs/apidocs/index.rst
index 916fab08..241a2680 100644
--- a/docs/apidocs/index.rst
+++ b/docs/apidocs/index.rst
@@ -3,9 +3,9 @@
.. (c) 2015 Dell Inc.
.. (c) 2016 ZTE Corp.
-****************
+################
QTIP Configguide
-****************
+################
.. toctree::
:maxdepth: 2
diff --git a/docs/apidocs/qtip_restful_api.rst b/docs/apidocs/qtip_restful_api.rst
index ca77224c..3f3297d5 100644
--- a/docs/apidocs/qtip_restful_api.rst
+++ b/docs/apidocs/qtip_restful_api.rst
@@ -3,8 +3,8 @@
.. (c) 2015 Dell Inc.
.. (c) 2016 ZTE Corp.
-
+****************
Qtip restful api
-================
+****************
You can get all the Qtip restful api by http://qtip_server_ip:5000/api/spec.html.
diff --git a/docs/configguide/configuration.rst b/docs/configguide/configuration.rst
index d6d2fd5d..78e96492 100644
--- a/docs/configguide/configuration.rst
+++ b/docs/configguide/configuration.rst
@@ -16,7 +16,7 @@ to configure OPNFV with this specific installer
Installing QTIP using Docker
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+============================
QTIP has a Docker images on the docker hub. Pulling opnfv/qtip docker image
from docker hub:
@@ -50,11 +50,11 @@ be navigated to using the following command.
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
@@ -69,7 +69,7 @@ environment variables.
QTIP default key pair
-""""""""""""""""""""""
+----------------------
QTIP uses a SSH key pair to connect to the guest image. You should generate key pair
before running QTIP test. And put key pair in the ``config/`` directory.
diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst
index 291a809b..d5e05d63 100644
--- a/docs/configguide/index.rst
+++ b/docs/configguide/index.rst
@@ -4,9 +4,9 @@
.. (c) 2016 ZTE Corp.
-=================
+#################
QTIP Config Guide
-=================
+#################
.. toctree::
:maxdepth: 2
diff --git a/docs/designspec/dashboard.rst b/docs/designspec/dashboard.rst
new file mode 100644
index 00000000..ad5520b6
--- /dev/null
+++ b/docs/designspec/dashboard.rst
@@ -0,0 +1,70 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2016 ZTE Corp.
+
+
+*********
+Dashboard
+*********
+
+The dashboard gives user an intuitive view of benchmark result.
+
+Purpose
+=======
+
+The basic element to be displayed is QPI a.k.a. QTIP Performance Index. But it
+is also important to show user
+
+#. How is the final score calculated?
+#. Under what condition is the test plan executed?
+#. How many runs of a performance tests have been executed and is there any deviation?
+#. Comparison of benchmark result from different PODs or configuration
+
+Templates
+=========
+
+Different board templates are created to satisfy the above requirements.
+
+Composition
+-----------
+
+QTIP gives a simple score but there must be a complex formula behind it. This
+view explains the composition of the QPI.
+
+Condition
+---------
+
+The condition of a benchmark result includes
+
+* System Under Test
+
+ * Hardware environment
+ * Hypervisor version
+ * Operation System release version
+ * System Configuration
+
+* Test Tools
+
+ * Release version
+ * Configuration
+
+* Test Facility
+
+ * Laboratory
+ * Engineer
+ * Date
+
+Conditions that do NOT have an obvious affect on the test result may be ignored,
+e.g. temperature, power supply.
+
+Deviation
+---------
+
+Performance tests are usually repeated many times to reduce random disturbance.
+This view shall show an overview of deviation among different runs.
+
+Comparison
+----------
+
+Comparison can be done between different PODs or different configuration on the
+same PODs.
diff --git a/docs/designspec/index.rst b/docs/designspec/index.rst
new file mode 100644
index 00000000..e9b3f9fd
--- /dev/null
+++ b/docs/designspec/index.rst
@@ -0,0 +1,13 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) 2016 ZTE Corp.
+
+
+##########################
+QTIP Design Specifications
+##########################
+
+.. toctree::
+ :maxdepth: 2
+
+ dashboard.rst
diff --git a/docs/overview/index.rst b/docs/overview/index.rst
index 731b8d49..9a387360 100644
--- a/docs/overview/index.rst
+++ b/docs/overview/index.rst
@@ -3,9 +3,10 @@
.. (c) 2016 ZTE Corp.
-=====================
+
+#####################
QTIP Project Overview
-=====================
+#####################
.. toctree::
:maxdepth: 2
diff --git a/docs/overview/overview.rst b/docs/overview/overview.rst
index aa09c7c3..4fd42356 100644
--- a/docs/overview/overview.rst
+++ b/docs/overview/overview.rst
@@ -3,9 +3,9 @@
.. (c) 2015 Dell Inc.
.. (c) 2016 ZTE Corp.
-========
+********
Overview
-========
+********
.. _QTIP: https://wiki.opnfv.org/platform_performance_benchmarking
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index 5ae4f345..4be3e498 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -4,9 +4,9 @@
.. (c) 2016 ZTE Corp.
-===============
+###############
QTIP User Guide
-===============
+###############
.. toctree::
:maxdepth: 2
diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst
index 4876d0e2..d0d9f3c1 100644
--- a/docs/userguide/introduction.rst
+++ b/docs/userguide/introduction.rst
@@ -13,8 +13,8 @@ run QTIP the first time when the user pull QTIP image on to their host machine.
In order to install and config QTIP please follow the instructions in the
configuration.rst located in docs/configguide/configuration.rst.
-QTIP Directory structure:
--------------------------
+QTIP Directory structure
+========================
The QTIP directory has been sectioned off into multiple folders to facilitate
segmenting information into relevant categories. The folders that concern