summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMorgan Richomme <morgan.richomme@orange.com>2016-02-24 17:29:04 +0100
committerMorgan Richomme <morgan.richomme@orange.com>2016-02-25 07:05:31 +0000
commit789c020b206f971a14a2afeecc3a27e3138eca5c (patch)
tree0f873d4f0d200e2fa725103b9c913cac7cd57a28
parenta6a9abbe091ebbcf1c90c2377637070eb0febdb8 (diff)
minor fix on format + add doctor references
Change-Id: I0e2d1d56557eef2940ee033bfe482ea89ae1c83f Signed-off-by: Morgan Richomme <morgan.richomme@orange.com> (cherry picked from commit 3ed935546cf0e3f74362cffdd59d796ac7f4e2ab)
-rw-r--r--docs/userguide/index.rst21
-rw-r--r--docs/userguide/introduction.rst93
2 files changed, 62 insertions, 52 deletions
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index 790343b08..3309896ba 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -182,11 +182,10 @@ SDN Controllers
---------------
Brahmaputra introduces new SDN controllers.
-There are currently 3 possible controllers:
+There are currently 2 possible controllers:
* OpenDaylight (ODL)
* ONOS
- * OpenContrail (OCL)
OpenDaylight
^^^^^^^^^^^^
@@ -282,12 +281,6 @@ The test cases may be described as follows:
NULL in ONOS or not
-OpenContrail
-^^^^^^^^^^^^
-TODO OVNO
-
-
-
Features
--------
@@ -365,6 +358,12 @@ include::
However, these parameters must not be changed, as they are the values expected
by the Promise test suite.
+Doctor
+^^^^^^
+Doctor test case: Doctor-notification: immediate notification for fault
+management.
+The Doctor test is successful if the notification time is below 1 second.
+
.. include:: ./runfunctest.rst
Test results
@@ -377,9 +376,11 @@ http://artifacts.opnfv.org/functest/brahmaputra/docs/results/index.html
Test Dashboard
==============
-Based on results collected in CI, a test dashboard is dynamically generated.
-The URL of this dashboard is TODO LF
+Based on results collected in CI, a test dashboard is dynamically generated:
+https://www.opnfv.org/opnfvtestgraphs/per-test-projects/default
+A specific dashboard has been created for functest:
+http://testresults.opnfv.org/dashboard/
.. include:: ./troubleshooting.rst
diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst
index b130fe1cf..c4fe75771 100644
--- a/docs/userguide/introduction.rst
+++ b/docs/userguide/introduction.rst
@@ -8,54 +8,59 @@ Functest is the OPNFV project primarily targeting function testing.
In the Continuous Integration pipeline, it is launched after an OPNFV fresh
installation to validate and verify the basic functions of the infrastructure.
-The current list of test suites can be distributed in 3 main domains::
-
- +----------------+----------------+-------------------------------------------+
- | Domain | Test suite | Comments |
- +================+================+===========================================+
- | | vPing | NFV "Hello World" using SSH connection |
- | | | and floatting IP |
- | +----------------+-------------------------------------------+
- | VIM | vPing_userdata | Ping using userdata and cloud-init |
- | | | mechanism |
- | +----------------+-------------------------------------------+
- |(Virtualised | Tempest | OpenStack reference test suite `[2]`_ |
- | Infrastructure +----------------+-------------------------------------------+
- | Manager) | Rally bench | OpenStack testing tool benchmarking |
- | | | OpenStack modules `[3]`_ |
- +----------------+----------------+-------------------------------------------+
- | | OpenDaylight | Opendaylight Test suite |
- | +----------------+-------------------------------------------+
- | Controllers | ONOS | Test suite of ONOS L2 and L3 functions |
- | +----------------+-------------------------------------------+
- | | OpenContrail | |
- +----------------+----------------+-------------------------------------------+
- | Features | vIMS | Example of a real VNF deployment to show |
- | | | the NFV capabilities of the platform. |
- | | | The IP Multimedia Subsytem is a typical |
- | | | Telco test case, referenced by ETSI. |
- | | | It provides a fully functional VoIP System|
- | +----------------+-------------------------------------------+
- | | Promise | Resource reservation and management |
- | | | project to identify NFV related |
- | | | requirements and realize resource |
- | | | reservation for future usage by capacity |
- | | | management of resource pools regarding |
- | | | compute, network and storage. |
- | +----------------+-------------------------------------------+
- | | SDNVPN | |
- +----------------+----------------+-------------------------------------------+
+The current list of test suites can be distributed in 3 main domains VIM,
+Controllers and Features.
+
++----------------+----------------+-------------------------------------------+
+| Domain | Test suite | Comments |
++================+================+===========================================+
+| | vPing | NFV "Hello World" using SSH connection |
+| | | and floatting IP |
+| +----------------+-------------------------------------------+
+| VIM | vPing_userdata | Ping using userdata and cloud-init |
+| | | mechanism |
+| +----------------+-------------------------------------------+
+|(Virtualised | Tempest | OpenStack reference test suite `[2]`_ |
+| Infrastructure +----------------+-------------------------------------------+
+| Manager) | Rally bench | OpenStack testing tool benchmarking |
+| | | OpenStack modules `[3]`_ |
++----------------+----------------+-------------------------------------------+
+| | OpenDaylight | Opendaylight Test suite |
+| +----------------+-------------------------------------------+
+| Controllers | ONOS | Test suite of ONOS L2 and L3 functions |
+| | | See `ONOSFW User Guide`_ for details |
++----------------+----------------+-------------------------------------------+
+| Features | vIMS | Example of a real VNF deployment to show |
+| | | the NFV capabilities of the platform. |
+| | | The IP Multimedia Subsytem is a typical |
+| | | Telco test case, referenced by ETSI. |
+| | | It provides a fully functional VoIP System|
+| +----------------+-------------------------------------------+
+| | Promise | Resource reservation and management |
+| | | project to identify NFV related |
+| | | requirements and realize resource |
+| | | reservation for future usage by capacity |
+| | | management of resource pools regarding |
+| | | compute, network and storage. |
+| | | See `Promise User Guide`_ for details |
+| +----------------+-------------------------------------------+
+| | Doctor | Doctor platform, as of Brahmaputra release|
+| | | , provides the two features: |
+| | | * Immediate Notification |
+| | | * Consistent resource state awareness |
+| | | (compute), see `Doctor User Guide`_ for |
+| | | details |
++----------------+----------------+-------------------------------------------+
+
Functest includes different test suites with several test cases within. Some
-of the tests are developed by Functest team members whereas others are integrated
-from upstream communities or other OPNFV projects. For example,
+of the tests are developed by Functest team members whereas others are
+integrated from upstream communities or other OPNFV projects. For example,
`Tempest <http://docs.openstack.org/developer/tempest/overview.html>`_ is the
OpenStack integration test suite and Functest is in charge of the selection,
integration and automation of the tests that fit in OPNFV.
The Tempest suite has been customized but no new test cases have been created.
-Some OPNFV feature projects (e.g. SDNVPN) have written some Tempest tests cases
-and pushed upstream to be used by Functest.
The results produced by the tests run from CI are pushed and collected in a NoSQL
database. The goal is to populate the database with results from different sources
@@ -71,7 +76,7 @@ relatively complex NFV scenario on top of the OPNFV infrastructure.
Functest considers OPNFV as a black box.
OPNFV, since the Brahmaputra release, offers lots of potential combinations:
- * 3 controllers (OpenDayligh, ONOS, OpenContrail)
+ * 2 controllers (OpenDayligh, ONOS)
* 4 installers (Apex, Compass, Fuel, Joid)
Most of the tests are runnable on any combination, but some others might have
@@ -80,3 +85,7 @@ restrictions imposed by the installers or the available deployed features.
Details on working with the functest suites can be found at
http://artifacts.opnfv.org/functest/brahmaputra/userguide/index.html
+.. _`Doctor User Guide`: http://artifacts.opnfv.org/opnfvdocs/brahmaputra/docs/userguide/featureusage-doctor.html
+.. _`Promise User Guide`: http://artifacts.opnfv.org/promise/brahmaputra/docs/userguide/index.html
+.. _`ONOSFW User Guide`: http://artifacts.opnfv.org/onosfw/brahmaputra/docs/userguide/index.html
+