Add test area 'forwarding packets through virtual networks in data path'

JIRA: DOVETAIL-473

According to Dovetail addendum doc, add one test area about basic cloud
capability 'forwarding packets through virtual networks in data path'.

Add the test specification about this test area.

Change-Id: I26416ecca6b89a94cf48ba0f55308df0fa6e1677
Signed-off-by: xudan <xudan16@huawei.com>

2 files changed, 151 insertions, 0 deletions

diff --git a/docs/testing/developer/testscope/index.rst b/docs/testing/developer/testscope/index.rst
index bb966c3f..ac8f63cd 100644
--- a/docs/testing/developer/testscope/index.rst
+++ b/docs/testing/developer/testscope/index.rst
@@ -683,3 +683,9 @@ Simple Virtual Machine Resource Scheduling on Multiple Nodes
 | tempest.api.compute.servers.test_server_group.ServerGroupTestJSON.test_create_delete_server_group_with_anti_affinity_policy
 | tempest.api.compute.servers.test_server_group.ServerGroupTestJSON.test_list_server_groups
 | tempest.api.compute.servers.test_server_group.ServerGroupTestJSON.test_show_server_group
+
+--------------------------------------------------------
+Forwarding Packets Through Virtual Networks in Data Path
+--------------------------------------------------------
+
+| tempest.scenario.test_network_basic_ops.TestNetworkBasicOps.test_mtu_sized_frames
diff --git a/docs/testing/user/testspecification/forwardingpackets/index.rst b/docs/testing/user/testspecification/forwardingpackets/index.rst
new file mode 100644
index 00000000..ed2d55f0
--- /dev/null
+++ b/docs/testing/user/testspecification/forwardingpackets/index.rst
@@ -0,0 +1,145 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Huawei Technologies Co.,Ltd
+
+==================================================
+Forwarding Packets in Data Path test specification
+==================================================
+
+.. toctree::
+   :maxdepth: 2
+
+Scope
+=====
+
+This test area evaluates the ability of the system under test to support basic packet forwarding.
+The test in this test area will evaluate basic packet forwarding through virtual IPv4 networks
+in data path, including creating server and verifying network connectivity to the created server
+with ping operation using MTU sized packets.
+
+References
+==========
+
+N/A
+
+Definitions and abbreviations
+=============================
+
+The following terms and abbreviations are used in conjunction with this test
+area
+
+- API - Application Programming Interface
+- ICMP - Internet Control Message Protocol
+- MTU - Maximum Transmission Unit
+- NFVi - Network Functions Virtualization infrastructure
+- SSH - Secure Shell
+- VIM - Virtual Infrastructure Manager
+- VM - Virtual Machine
+
+System Under Test (SUT)
+=======================
+
+The system under test is assumed to be the NFVi and VIM in operation on a
+Pharos compliant infrastructure.
+
+Test Area Structure
+===================
+
+The test area is structured based on the basic operations of forwarding packets
+in data path through virtual networks. Specifically, the test performs
+clean-up operations which return the system to the same state as before the test.
+
+Test Descriptions
+=================
+
+API Used and Reference
+----------------------
+
+Security Groups: https://developer.openstack.org/api-ref/network/v2/index.html#security-groups-security-groups
+
+- create security group
+- delete security group
+
+Networks: https://developer.openstack.org/api-ref/networking/v2/index.html#networks
+
+- create network
+- delete network
+
+Routers and interface: https://developer.openstack.org/api-ref/networking/v2/index.html#routers-routers
+
+- create router
+- delete router
+- add interface to router
+
+Subnets: https://developer.openstack.org/api-ref/networking/v2/index.html#subnets
+
+- create subnet
+- delete subnet
+
+Servers: https://developer.openstack.org/api-ref/compute/
+
+- create keypair
+- create server
+- delete server
+- add/assign floating ip
+
+Ports: https://developer.openstack.org/api-ref/networking/v2/index.html#ports
+
+- create port
+- delete port
+
+Floating IPs: https://developer.openstack.org/api-ref/networking/v2/index.html#floating-ips-floatingips
+
+- create floating ip
+- delete floating ip
+
+----------------------------
+MTU Sized Frames Fit Through
+----------------------------
+
+Test case specification
+-----------------------
+
+tempest.scenario.test_network_basic_ops.TestNetworkBasicOps.test_mtu_sized_frames
+
+Test preconditions
+------------------
+
+* Nova has been configured to boot VMs with Neutron-managed networking
+* Neutron net-mtu extension API
+* One public network
+
+Basic test flow execution description and pass/fail criteria
+------------------------------------------------------------
+
+Test execution
+''''''''''''''
+
+* Test action 1: Create a security group SG1, which has rules for allowing
+  incoming and outgoing SSH and ICMP traffic
+* Test action 2: Create a neutron network NET1
+* Test action 3: Create a tenant router R1 which routes traffic to public network
+* Test action 4: Create a subnet SUBNET1 and add it as router interface
+* Test action 5: Create a server VM1 with SG1 and NET1, and assign a floating
+  ip FIP1 (via R1) to VM1
+* Test action 6: Set MTU size to be the default MTU size of the SUT's network
+* Test action 7: Host sends MTU sized ICMP packets to VM1 using ``ping``
+* **Test assertion 1:** Ping FIP1 using MTU sized packets successfully
+* Test action 8: SSH to VM1 with FIP1
+* **Test assertion 2:** SSH to VM1 with FIP1 successfully
+* Test action 9: Delete SG1, NET1, SUBNET1, R1, VM1 and FIP1
+
+Pass / fail criteria
+''''''''''''''''''''
+
+This test evaluates the network connectivity using MTU sized frames.
+Specifically, the test verifies that:
+
+* With Neutron net-mtu extension configured, MTU sized packets can fit through network.
+
+In order to pass this test, all test assertions listed in the test execution above need to pass.
+
+Post conditions
+---------------
+
+N/A