summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLincoln Lavoie <lylavoie@iol.unh.edu>2016-02-24 17:34:06 -0500
committerChristopherPrice <christopher.price@ericsson.com>2016-03-02 10:16:40 +0100
commit85b579d153aa713e1b89faa7fcfa7a9a934829ad (patch)
treee03d2c8221e1a61f52ef8480bf9754218af6dcf4
parent328ca6847ee842ac8050d723114e2b54d3cd71ea (diff)
Initial test plan structure for Brahmaputra
Created the initial structure for the plugfest test plan. * Created a base directory and document structure * Created contributor guidelines * Created test case template * adjusted for: http://artifacts.opnfv.org/releng/docs/how-to-use-docs/documentation-example.html * cp: reformatted the directories and structure to use the RST format * (we cannot review odt format in our toolchain, so use rst) * cp: added an index.rst structure to establish structure without numbering * cp: will ad anothe job to include dovetail in the docs toolchain Change-Id: I4ef997da51b3b85e391629d6e08fadf87257fc6a
-rw-r--r--docs/plugfest_test_plan/INFO13
-rw-r--r--docs/plugfest_test_plan/application/testcases.rst23
-rw-r--r--docs/plugfest_test_plan/deployment/testcase1.rst40
-rw-r--r--docs/plugfest_test_plan/deployment/testcase2.rst40
-rw-r--r--docs/plugfest_test_plan/deployment/testcases.rst22
-rw-r--r--docs/plugfest_test_plan/index.rst19
-rw-r--r--docs/plugfest_test_plan/integration/testcases.rst25
-rw-r--r--docs/plugfest_test_plan/preface.rst15
-rw-r--r--docs/plugfest_test_plan/setup/setup.rst21
-rw-r--r--docs/plugfest_test_plan/setup/testframeworkconfig.rst10
-rw-r--r--docs/plugfest_test_plan/templates/template.rst38
11 files changed, 266 insertions, 0 deletions
diff --git a/docs/plugfest_test_plan/INFO b/docs/plugfest_test_plan/INFO
new file mode 100644
index 00000000..b643abc6
--- /dev/null
+++ b/docs/plugfest_test_plan/INFO
@@ -0,0 +1,13 @@
+This directory contains the test plan being developed by the OPNFV Dovetail
+project team for the plugfest test events. The test plan is broken up into
+files containing its individual sections to allow developers to easily
+collaborate, without causing collisions.
+
+Developer Guidelines
+1. Please check with a project leader before creating a new directory.
+2. Please use a number scheme for file names to logical order the files as
+ the document should read when a “natural sort” operation is applied.
+3. The LibreOffice format has been selected to provide a file format that
+ allows the inclusion of figures, pictures, and tables. Please keep all
+ files in this format, or as a raw text file.
+
diff --git a/docs/plugfest_test_plan/application/testcases.rst b/docs/plugfest_test_plan/application/testcases.rst
new file mode 100644
index 00000000..0e49c5c8
--- /dev/null
+++ b/docs/plugfest_test_plan/application/testcases.rst
@@ -0,0 +1,23 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+===============================
+Dovetail integration test cases
+===============================
+
+.. This file includes test cases for VNF application deployment on the OPNFV platform.
+
+.. The setup.rst file organises and imports the relevant RST files in this
+.. directory and includes them in the overall plugfest documentation.
+
+We can add some general text here around the application test cases.
+The test case descriptions should likely be organised as single rst
+files in this directory that are imported below the toctree command below.
+
+.. toctree::
+ :maxdepth: 2
+
+ ./testcase1.rst
+ ./testcase2.rst
+ ./testcase_etc.rst
+
diff --git a/docs/plugfest_test_plan/deployment/testcase1.rst b/docs/plugfest_test_plan/deployment/testcase1.rst
new file mode 100644
index 00000000..6014bda3
--- /dev/null
+++ b/docs/plugfest_test_plan/deployment/testcase1.rst
@@ -0,0 +1,40 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Test case one
+-------------
+
+Purpose
+^^^^^^^
+
+This test case is the first and therefore most important test case.
+As the first you should take care to do all the set-up found in the
+`Plugfest setup and configuration`_ section.
+
+References
+^^^^^^^^^^
+
+Somewhere in `ETSI`_ there is a useful link.
+
+Test Setup
+^^^^^^^^^^
+
+1. The number 1 is of special relevance to this test case.
+2. Do not stray to the number 2.
+3. This step needs to be performed only once.
+
+Method of Procedure
+^^^^^^^^^^^^^^^^^^^
+
+1. Count to one.
+2. Stop, if you counted further a retest is required.
+
+Expected Results
+^^^^^^^^^^^^^^^^
+
+1. You arrived at 1.
+2. This results is used to indicate the pass/fail status for the test case executor.
+3. To pass a test case, it all individual metrics would be expected to “pass”.
+
+.. _ETSI: http://www.etsi.org/
+
diff --git a/docs/plugfest_test_plan/deployment/testcase2.rst b/docs/plugfest_test_plan/deployment/testcase2.rst
new file mode 100644
index 00000000..9c906146
--- /dev/null
+++ b/docs/plugfest_test_plan/deployment/testcase2.rst
@@ -0,0 +1,40 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Test case two
+-------------
+
+Purpose
+^^^^^^^
+
+This test case is the second and no one really cares for it.
+If you have it in you please refer to the `Plugfest setup and configuration`_ section,
+it's OK to simply amble on at this stage. *(It's only the second test case)*
+
+References
+^^^^^^^^^^
+
+Somewhere in `ETSI`_ there may be a useful link.
+
+Test Setup
+^^^^^^^^^^
+
+1. The number 2 is kind of important.
+2. Try and get to the number 2.
+3. It's OK if you only count to 1 we understand.
+
+Method of Procedure
+^^^^^^^^^^^^^^^^^^^
+
+1. Count to two.
+2. Stop, if you counted to something else we forgive you.
+
+Expected Results
+^^^^^^^^^^^^^^^^
+
+1. You arrived at 2.
+2. This results is used to indicate the pass/fail status for the test case itself.
+3. To pass a test case, metrics would be expected to “pass” 1 and not stray to 3.
+
+.. _ETSI: http://www.etsi.org/
+
diff --git a/docs/plugfest_test_plan/deployment/testcases.rst b/docs/plugfest_test_plan/deployment/testcases.rst
new file mode 100644
index 00000000..bb8dc9d1
--- /dev/null
+++ b/docs/plugfest_test_plan/deployment/testcases.rst
@@ -0,0 +1,22 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+==============================
+Dovetail deployment test cases
+==============================
+
+.. This file includes the test cases specific to the OPNFV deployment testing.
+
+.. The setup.rst file organises and imports the relevant RST files in this
+.. directory and includes them in the overall plugfest documentation.
+
+We can add some general text here around the deployment test cases.
+The test case descriptions should likely be organised as single rst
+files in this directory that are inported below the toctree command below.
+
+.. toctree::
+ :maxdepth: 2
+
+ ./testcase1.rst
+ ./testcase2.rst
+
diff --git a/docs/plugfest_test_plan/index.rst b/docs/plugfest_test_plan/index.rst
new file mode 100644
index 00000000..61de3bd5
--- /dev/null
+++ b/docs/plugfest_test_plan/index.rst
@@ -0,0 +1,19 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+**************************
+OPNFV Plugfest - test plan
+**************************
+
+.. This index.rst file is used to structure and organise the content in these directories.
+.. The documentation toolchain will create web and pdf versions of the content of this file.
+
+.. toctree::
+ :maxdepth: 2
+
+ ./preface
+ ./setup/setup.rst
+ ./deployment/testcases.rst
+ ./integration/testcases.rst
+ ./application/testcases.rst
+
diff --git a/docs/plugfest_test_plan/integration/testcases.rst b/docs/plugfest_test_plan/integration/testcases.rst
new file mode 100644
index 00000000..d0f01156
--- /dev/null
+++ b/docs/plugfest_test_plan/integration/testcases.rst
@@ -0,0 +1,25 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+===============================
+Dovetail integration test cases
+===============================
+
+.. This file includes test cases for testing integration
+.. between the OPNFV platform and network equipment (i.e. SDN Controllers,
+.. Routers, etc.).
+
+.. The setup.rst file organises and imports the relevant RST files in this
+.. directory and includes them in the overall plugfest documentation.
+
+We can add some general text here around the integration test cases.
+The test case descriptions should likely be organised as single rst
+files in this directory that are imported below the toctree command below.
+
+.. toctree::
+ :maxdepth: 2
+
+ ./testcase1.rst
+ ./testcase2.rst
+ ./testcase_etc.rst
+
diff --git a/docs/plugfest_test_plan/preface.rst b/docs/plugfest_test_plan/preface.rst
new file mode 100644
index 00000000..fab3d7f9
--- /dev/null
+++ b/docs/plugfest_test_plan/preface.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Abstract
+========
+
+Describe in a few sentences the intention of this document,
+how it should be used and the intended audience.
+
+Scope
+=====
+
+Describe in a few sentences the intended scope of the document including
+any limitations and constraints the reader shoudl be aware of when
+reading the document.
diff --git a/docs/plugfest_test_plan/setup/setup.rst b/docs/plugfest_test_plan/setup/setup.rst
new file mode 100644
index 00000000..c52af2cc
--- /dev/null
+++ b/docs/plugfest_test_plan/setup/setup.rst
@@ -0,0 +1,21 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+================================
+Plugfest setup and configuration
+================================
+
+.. This directory includes files and information for the test
+.. equipment, setup, configuration, and other general items that apply
+.. to multiple test cases.
+
+.. The setup.rst file organises and imports the relevant RST files in this
+.. directory and includes them in the overall plugfest documentation.
+
+We can add some general text here introducing the setup and configuration
+before digging into the details of each of the necessary sub chapters.
+
+.. toctree::
+ :maxdepth: 2
+
+ ./testframeworkconfig.rst
diff --git a/docs/plugfest_test_plan/setup/testframeworkconfig.rst b/docs/plugfest_test_plan/setup/testframeworkconfig.rst
new file mode 100644
index 00000000..e958b42c
--- /dev/null
+++ b/docs/plugfest_test_plan/setup/testframeworkconfig.rst
@@ -0,0 +1,10 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+---------------------------------------
+Configuring the dovetail test framework
+---------------------------------------
+
+.. This file should outline how to configure the test framework for DoveTail
+
+Text required to be added here regarding the test framework configuration.
diff --git a/docs/plugfest_test_plan/templates/template.rst b/docs/plugfest_test_plan/templates/template.rst
new file mode 100644
index 00000000..6c655cca
--- /dev/null
+++ b/docs/plugfest_test_plan/templates/template.rst
@@ -0,0 +1,38 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Test case title
+---------------
+
+Purpose
+^^^^^^^
+
+Description of the intended purpose of the test case.
+Purpose may also describe the cause/need of the test case,
+such as, describing a specific high availability failover cause.
+
+References
+^^^^^^^^^^
+
+Pointer to specific reference in standard, architecture, or other documentation.
+
+Test Setup
+^^^^^^^^^^
+
+1. List of equipment or software specific to this test case.
+2. List of steps required to prepare the devices / network for testing.
+3. These steps need to be performed only once.
+
+Method of Procedure
+^^^^^^^^^^^^^^^^^^^
+
+1. List of steps to perform the actual test case
+2. These steps might be performed multiple times, if a retest is required.
+
+Expected Results
+^^^^^^^^^^^^^^^^
+
+1. List of specific results expected from the procedure.
+2. These results / test metrics are used to indicate the pass/fail status for the test case.
+3. To pass a test case, it all individual metrics would be expected to “pass.”
+