IPv6 test cases: Test case specification document example

JIRA: DOVETAIL-9

1. We are keeping the test methodology simple and easy.
   We are reusing existing tests as much as we can from
   IPv6 projects and Tempest API and Scenario tests, which
   are run in FuncTest and Yardstick.

2. We modified "testplan.rst" to briefly describe the test plan,
   i.e. current IPv6 test cases for platform compliance, which
   have passed FuncTest and Yardstick test in Arno and Brahmaputra
   releases. We also leave room for additional IPv6 test cases if
   there are more contributions down the road

3. Original "designspecification.rst", "testprocedure.rst" and
   "testspecification.rst" are not applicable any more here. The
   test design, setup, and execution procedure related specification
   are covered by each test case.

4. Thus "index.rst" only covers "testplan.rst" and the list of test cases.

5. Two examples of test case specification documents are provided
   "ipv6.tc001.specification.rst"
   "ipv6.tc026.specification.rst"

6. A complete set of current IPv6 test cases are listed in
   "ipv6_all_testcases.rst". Once template is agreed, we will converted
   it into specific test case document.

For more background of IPv6, and its features and technical details, please see:
   https://wiki.opnfv.org/display/ipv6/IPv6+Home
   http://artifacts.opnfv.org/ipv6/docs/installationprocedure/index.html

Change-Id: I7e47c73c0f02a407df278c93a3da2142b5cc86e5
Signed-off-by: Bin Hu <bh526r@att.com>

1 files changed, 61 insertions, 0 deletions

diff --git a/docs/testsuites/ipv6/ipv6.tc001.specification.rst b/docs/testsuites/ipv6/ipv6.tc001.specification.rst
new file mode 100644
index 00000000..350ff73d
--- /dev/null
+++ b/docs/testsuites/ipv6/ipv6.tc001.specification.rst
@@ -0,0 +1,61 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) OPNFV
+
+==================================================================================================
+Dovetail IPv6 tc001 specification - Bulk Creation and Deletion of IPv6 Networks, Ports and Subnets
+==================================================================================================
+
+.. table::
+   :class: longtable
+
++-----------------------+----------------------------------------------------------------------------------------------------+
+|test case name         |Bulk creation and deletion of IPv6 networks, ports and subnets                                      |
+|                       |                                                                                                    |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|id                     |dovetail.ipv6.tc001                                                                                 |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|objective              |To verify that platform is able to create/delete networks, ports and subnets in bulk operation      |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|test items             |tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_network            |
+|                       |{idempotent_id('d4f9024d-1e28-4fc1-a6b1-25dbc6fa11e2')}                                             |
+|                       |tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_port               |
+|                       |{idempotent_id('48037ff2-e889-4c3b-b86a-8e3f34d2d060')}                                             |
+|                       |tempest.api.network.test_networks.BulkNetworkOpsIpV6Test.test_bulk_create_delete_subnet             |
+|                       |{idempotent_id('8936533b-c0aa-4f29-8e53-6cc873aec489')}                                             |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|environmental          |                                                                                                    |
+|requirements &         | environment can be deployed on bare metal of virtualized infrastructure                            |
+|preconditions          | deployment can be HA or non-HA                                                                     |
+|                       |                                                                                                    |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|scenario dependencies  | NA                                                                                                 |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|procedural             |Step 1: create/delete network:                                                                      |
+|requirements           |     create 2 networks in one request                                                               |
+|                       |     asserting that the networks are found in the list after creation                               |
+|                       |                                                                                                    |
+|                       |Step 2: create/delete subnet:                                                                       |
+|                       |     create 2 subnets in one request                                                                |
+|                       |     asserting that the subnets are found in the list after creation                                |
+|                       |                                                                                                    |
+|                       |Step 3: create/delete port:                                                                         |
+|                       |     create 2 ports in one request                                                                  |
+|                       |     asserting that the ports are found in the list after creation                                  |
+|                       |                                                                                                    |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|input specifications   |The parameters needed to execute Neutron network APIs.                                              |
+|                       |Refer to Neutron Networking API v2.0 [1]_ [2]_                                                      |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|output specifications  |The responses after executing Network network APIs.                                                 |
+|                       |Refer to Neutron Networking API v2.0 [1]_ [2]_                                                      |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|pass/fail criteria     |If normal response code 200 is returned, the test passes.                                           |
+|                       |Otherwise, the test fails with various error codes.                                                 |
+|                       |Refer to Neutron Networking API v2.0 [1]_ [2]_                                                      |
++-----------------------+----------------------------------------------------------------------------------------------------+
+|test report            |TBD                                                                                                 |
++-----------------------+----------------------------------------------------------------------------------------------------+
+
+.._[1]: http://developer.openstack.org/api-ref/networking/v2/
+.._[2]: http://wiki.openstack.org/wiki/Neutron/APIv2-specification