docs/testing/user/userguide/index.rst

   1 .. _functest-userguide:
   2
   3 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   4 .. SPDX-License-Identifier: CC-BY-4.0
   5
   6 ===================
   7 Functest User Guide
   8 ===================
   9
  10 .. toctree::
  11    :maxdepth: 2
  12
  13 Version history
  14 ===============
  15 +------------+----------+------------------+----------------------------------+
  16 | **Date**   | **Ver.** | **Author**       | **Comment**                      |
  17 |            |          |                  |                                  |
  18 +------------+----------+------------------+----------------------------------+
  19 | 2016-08-17 | 1.0.0    | Juha Haapavirta  | Colorado release                 |
  20 |            |          | Column Gaynor    |                                  |
  21 +------------+----------+------------------+----------------------------------+
  22 | 2017-01-23 | 1.0.1    | Morgan Richomme  | Adaptations for Danube           |
  23 +------------+----------+------------------+----------------------------------+
  24 | 2017-08-16 | 1.0.2    | Morgan Richomme  | Adaptations for Euphrates        |
  25 +------------+----------+------------------+----------------------------------+
  26
  27
  28 Introduction
  29 ============
  30
  31 The goal of this document is to describe the OPNFV Functest test cases and to
  32 provide a procedure to execute them.
  33
  34 **IMPORTANT**: It is assumed here that Functest has been properly deployed
  35 following the installation guide procedure  `[1]`_.
  36
  37 .. include:: ./test_overview.rst
  38
  39 .. include:: ./test_details.rst
  40
  41 .. include:: ./runfunctest.rst
  42
  43 .. include:: ./test_results.rst
  44
  45 .. include:: ./reporting.rst
  46
  47 .. figure:: ../../../images/functest-reporting-status.png
  48    :align: center
  49    :alt: Functest reporting portal Fuel status page
  50
  51 .. include:: ./troubleshooting.rst
  52
  53
  54 References
  55 ==========
  56
  57 `[1]`_: Functest configuration guide
  58
  59 `[2]`_: OpenStack Tempest documentation
  60
  61 `[3]`_: Rally documentation
  62
  63 `[4]`_: Functest in depth (Danube)
  64
  65 `[5]`_: Clearwater vIMS blueprint
  66
  67 `[6]`_: NIST web site
  68
  69 `[7]`_: OpenSCAP web site
  70
  71 `[8]`_: Refstack client
  72
  73 `[9]`_: Defcore
  74
  75 `[10]`_: OpenStack interoperability procedure
  76
  77 `[11]`_: Robot Framework web site
  78
  79 `[12]`_: Functest User guide
  80
  81 `[13]`_: SNAPS wiki
  82
  83 `[14]`_: vRouter
  84
  85 `[15]`_: Testing OpenStack Tempest part 1
  86
  87 `[16]`_: Running Functest through internal REST API
  88
  89 `[17]`_: OPNFV Test API
  90
  91 `OPNFV main site`_: OPNFV official web site
  92
  93 `Functest page`_: Functest wiki page
  94
  95 IRC support chan: #opnfv-functest
  96
  97 .. _`[1]`: http://docs.opnfv.org/en/latest/submodules/functest/docs/testing/user/configguide/index.html
  98 .. _`[2]`: http://docs.openstack.org/developer/tempest/overview.html
  99 .. _`[3]`: https://rally.readthedocs.org/en/latest/index.html
 100 .. _`[4]`: http://events.linuxfoundation.org/sites/events/files/slides/Functest%20in%20Depth_0.pdf
 101 .. _`[5]`: https://github.com/Orange-OpenSource/opnfv-cloudify-clearwater/blob/master/openstack-blueprint.yaml
 102 .. _`[6]`: https://scap.nist.gov/
 103 .. _`[7]`: https://github.com/OpenSCAP/openscap
 104 .. _`[8]`: https://github.com/openstack/refstack-client
 105 .. _`[9]`: https://github.com/openstack/defcore
 106 .. _`[10]`: https://github.com/openstack/interop/blob/master/2016.08/procedure.rst
 107 .. _`[11]`: http://robotframework.org/
 108 .. _`[12]`: http://docs.opnfv.org/en/latest/submodules/functest/docs/testing/user/userguide/index.html
 109 .. _`[13]`: https://wiki.opnfv.org/display/PROJ/SNAPS-OO
 110 .. _`[14]`: https://github.com/oolorg/opnfv-functest-vrouter
 111 .. _`[15]`: https://aptira.com/testing-openstack-tempest-part-1/
 112 .. _`[16]`: https://wiki.opnfv.org/display/functest/Running+test+cases+via+new+Functest+REST+API
 113 .. _`[17]`: http://docs.opnfv.org/en/latest/testing/testing-dev.html
 114 .. _`OPNFV main site`: http://www.opnfv.org
 115 .. _`Functest page`: https://wiki.opnfv.org/functest
 116 .. _`OpenRC`: http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html
 117 .. _`Rally installation procedure`: https://rally.readthedocs.org/en/latest/tutorial/step_0_installation.html
 118 .. _`config_functest.yaml` : https://git.opnfv.org/cgit/functest/tree/functest/ci/config_functest.yaml
 119 .. _`Functest reporting`: http://testresults.opnfv.org/reporting/master/functest/status-apex.html