Suite: bridge_domain

Files: bridge_domain_untagged.robot.
Minor updates to test cases documentation.

Change-Id: Ifcf3a6d07942e242bbb121c0446520480e5f9c88
Signed-off-by: Maciek Konstantynowicz <mkonstan@cisco.com>

Conflicts:
	tests/suites/bridge_domain/bridge_domain_untagged.robot

Change-Id: Ifcf3a6d07942e242bbb121c0446520480e5f9c88
Signed-off-by: Jan Gelety <jgelety@cisco.com>

1 files changed, 80 insertions, 44 deletions

diff --git a/tests/suites/bridge_domain/bridge_domain_untagged.robot b/tests/suites/bridge_domain/bridge_domain_untagged.robot
index cef84c7cd0..8df8713581 100644
--- a/tests/suites/bridge_domain/bridge_domain_untagged.robot
+++ b/tests/suites/bridge_domain/bridge_domain_untagged.robot
@@ -21,13 +21,25 @@
 | Test Setup | Run Keywords | Setup all DUTs before test
 | ...        | AND          | Setup all TGs before traffic script
 | Test Teardown | Show Packet Trace on All DUTs | ${nodes}
-| Documentation | *Bridge domain test suite.*
+| Documentation | *L2 bridge-domain test cases*
 | ...
-| ... | Test suite uses 2-node topology TG - DUT1 - TG with two links
-| ... | between nodes as well as 3-node topology TG - DUT1 - DUT2 - TG
-| ... | with one link between nodes. Test packets are sent in both directions
-| ... | and contain Ethernet header, IPv4 header and ICMP message. Ethernet
-| ... | header MAC addresses are matching MAC addresses of the TG node.
+| ... | *[Top] Network Topologies:* TG=DUT1 2-node topology with two links
+| ... | between nodes; TG-DUT1-DUT2-TG 3-node circular topology with
+| ... | single links between nodes; TG=DUT1=DUT2=TG 3-node circular
+| ... | topology with double parallel links and TG=DUT=VM 3-node topology
+| ... | with VM and double parallel links.
+| ... | *[Enc] Packet Encapsulations:* Eth-IPv4-ICMPv4 for L2 switching of
+| ... | IPv4; Eth-IPv6-ICMPv6 for L2 switching of IPv6 use. Both apply
+| ... | to all links.
+| ... | *[Cfg] DUT configuration:* DUT1 and DUT2 are configured with L2
+| ... | bridge-domain (L2BD) switching combined with static MACs; MAC
+| ... | learning enabled and Split Horizon Groups (SHG) depending on
+| ... | test case.
+| ... | *[Ver] TG verification:* Test ICMPv4 (or ICMPv6) Echo Request packets
+| ... | are sent in both directions by TG on links to DUT1 and DUT2; on
+| ... | receive TG verifies packets for correctness and their IPv4 (IPv6)
+| ... | src-addr, dst-addr and MAC addresses.
+| ... | *[Ref] Applicable standard specifications:*
 
 *** Variables ***
 | ${bd_id1}= | 1
@@ -38,15 +50,19 @@
 | ${sock2}= | /tmp/sock2
 
 *** Test Cases ***
-| VPP reports interfaces
-| | [Documentation] | Report VPP interfaces on the given node
+| TC01: DUT reports active interfaces
+| | [Documentation]
+| | ... | [Top] TG=DUT1; TG-DUT1-DUT2-TG. [Enc] None. [Cfg] Discovered \
+| | ... | active interfaces. [Ver] Report active interfaces on DUT. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO | 3_NODE_SINGLE_LINK_TOPO
 | | VPP reports interfaces on | ${nodes['DUT1']}
 
-| Vpp forwards packets via L2 bridge domain 2 ports
-| | [Documentation] | Create bridge domain (learning enabled) on one VPP node,
-| | ...             | add there two interfaces and check traffic
-| | ...             | bidirectionally.
+| TC02: DUT with L2BD (MAC learning) switch ICMPv4 between two TG links
+| | [Documentation]
+| | ... | [Top] TG=DUT1. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 configure \
+| | ... | two i/fs into L2BD with MAC learning. [Ver] Make TG verify
+| | ... | ICMPv4 Echo Req pkts are switched thru DUT1 in both directions
+| | ... | and are correct on receive. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO
 | | Given Path for 2-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
@@ -59,10 +75,12 @@
 | | Then Send and receive ICMPv4 bidirectionally | ${tg_node} | ${tg_to_dut_if1}
 | | ...                                     | ${tg_to_dut_if2}
 
-| Vpp forwards packets via L2 bridge domain in circular topology
-| | [Documentation] | Create bridge domains (learning enabled) on two VPP nodes,
-| | ...             | add two interfaces to each bridge domain and check traffic
-| | ...             | bidirectionally.
+| TC03: DUT1 and DUT2 with L2BD (MAC learning) switch between two TG links
+| | [Documentation]
+| | ... | [Top] TG-DUT1-DUT2-TG. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 and DUT2 \
+| | ... | configure two i/fs into L2BD with MAC learning. [Ver] Make TG
+| | ... | verify ICMPv4 Echo Req pkts are switched thru DUT1 and DUT2 in
+| | ... | both directions and are correct on receive. [Ref]
 | | [Tags] | 3_NODE_SINGLE_LINK_TOPO
 | | Given Path for 3-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['DUT2']} | ${nodes['TG']}
@@ -80,11 +98,12 @@
 | | Then Send and receive ICMPv4 bidirectionally | ${tg_node} | ${tg_to_dut1}
 | | ...                                          | ${tg_to_dut2}
 
-| Vpp forwards packets via L2 bridge domain in circular topology with static L2FIB entries
-| | [Documentation] | Create bridge domains (learning disabled) on two VPP
-| | ...             | nodes, add two interfaces to each bridge domain and set
-| | ...             | static L2FIB entry on each interface and check traffic
-| | ...             | bidirectionally.
+| TC04: DUT1 and DUT2 with L2BD (static MACs) switch between two TG links
+| | [Documentation]
+| | ... | [Top] TG-DUT1-DUT2-TG. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 and \
+| | ... | DUT2 configure two i/fs into L2BD with static MACs. [Ver] Make
+| | ... | TG verify ICMPv4 Echo Req pkts are switched thru DUT1 and DUT2
+| | ... | in both directions and are correct on receive. [Ref]
 | | [Tags] | 3_NODE_SINGLE_LINK_TOPO
 | | Given Path for 3-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['DUT2']} | ${nodes['TG']}
@@ -124,11 +143,14 @@
 | | Then Send and receive ICMPv4 bidirectionally | ${tg_node} | ${tg_to_dut1}
 | | ...                                          | ${tg_to_dut2}
 
-| Vpp forwards packets via L2 bridge domain with split-horizon groups set in circular topology
-| | [Documentation] | Create bridge domains (learning enabled) on two VPP nodes,
-| | ...             | add interfaces to each bridge domain where both interfaces
-| | ...             | toward TG are in the same split-horizon group and check
-| | ...             | traffic bidirectionally.
+| TC05: DUT1 and DUT2 with L2BD (MAC learn) and SHG switch between four TG links
+| | [Documentation]
+| | ... | [Top] TG=DUT1=DUT2=TG. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 and \
+| | ... | DUT2 configure four i/fs into L2BD with MAC learning and the
+| | ... | same SHG on i/fs towards TG. [Ver] Make TG verify ICMPv4 Echo
+| | ... | Req pkts are switched thru DUT1 and DUT2 in both directions and
+| | ... | are correct on receive; verify no pkts are switched thru SHG
+| | ... | isolated interfaces. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO
 | | Given Path for 3-node BD-SHG testing is set | ${nodes['TG']}
 | | ...                                         | ${nodes['DUT1']}
@@ -169,10 +191,14 @@
 | | | ...                            | ${tg_node} | ${tg_to_dut2_if1}
 | | | ...                            | ${tg_to_dut2_if2}
 
-| VPP forwards ICMPv4 packets through VM via two L2 bridge domains
-| | [Documentation] | Setup and run VM connected to VPP via Vhost-User
-| | ...             | interfaces and check ICMPv4 packet forwarding through VM
-| | ...             | via two L2 bridge domains with learning enabled.
+| TC06: DUT with two L2BDs (MAC learn) switches ICMPv4 between TG and VM links
+| | [Documentation]
+| | ... | [Top] TG=DUT=VM. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 configure \
+| | ... | two L2BDs with MAC learning, each with vhost-user i/f to local
+| | ... | VM and i/f to TG; configure VM to loop pkts back betwen its two
+| | ... | virtio i/fs. [Ver] Make TG verify ICMPv4 Echo Req pkts are
+| | ... | switched thru DUT1 and VM in both directions and are correct on
+| | ... | receive. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO | VPP_VM_ENV
 | | Given Path for 2-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
@@ -197,10 +223,14 @@
 | | [Teardown] | Run Keywords | Show Packet Trace on All DUTs | ${nodes}
 | | ...        | AND          | Stop and Clear QEMU | ${dut_node} | ${vm_node}
 
-| VPP forwards ICMPv6 packets through VM via two L2 bridge domains
-| | [Documentation] | Setup and run VM connected to VPP via Vhost-User
-| | ...             | interfaces and check ICMPv6 packet forwarding through VM
-| | ...             | via two L2 bridge domains with learning enabled.
+| TC07: DUT with two L2BDs (MAC learn) switches ICMPv6 between TG and VM links
+| | [Documentation]
+| | ... | [Top] TG=DUT=VM. [Enc] Eth-IPv6-ICMPv6. [Cfg] On DUT1 configure \
+| | ... | two L2BDs with MAC learning, each with vhost-user i/f to local
+| | ... | VM and i/f to TG; configure VM to loop pkts back betwen its two
+| | ... | virtio i/fs. [Ver] Make TG verify ICMPv6 Echo Req pkts are
+| | ... | switched thru DUT1 and VM in both directions and are correct on
+| | ... | receive. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO | VPP_VM_ENV
 | | Given Path for 2-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
@@ -225,11 +255,14 @@
 | | [Teardown] | Run Keywords | Show Packet Trace on All DUTs | ${nodes}
 | | ...        | AND          | Stop and Clear QEMU | ${dut_node} | ${vm_node}
 
-| VPP forwards ICMPv4 packets through VM via two L2 bridge domains with static L2FIB entries
-| | [Documentation] | Setup and run VM connected to VPP via Vhost-User
-| | ...             | interfaces and check ICMPv4 packet forwarding through VM
-| | ...             | via two L2 bridge domains with learning disabled
-| | ...             | (static L2BFIB entries).
+| TC08: DUT with two L2BDs (static MACs) switches ICMPv4 between TG and VM links
+| | [Documentation]
+| | ... | [Top] TG=DUT=VM. [Enc] Eth-IPv4-ICMPv4. [Cfg] On DUT1 configure \
+| | ... | two L2BDs with static MACs, each with vhost-user i/f to local VM
+| | ... | and i/f to TG; configure VM to loop pkts back betwen its two
+| | ... | virtio i/fs. [Ver] Make TG verify ICMPv4 Echo Req pkts are
+| | ... | switched thru DUT1 and VM in both directions and are correct on
+| | ... | receive. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO | VPP_VM_ENV
 | | Given Path for 2-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}
@@ -276,11 +309,14 @@
 | | [Teardown] | Run Keywords | Show Packet Trace on All DUTs | ${nodes}
 | | ...        | AND          | Stop and Clear QEMU | ${dut_node} | ${vm_node}
 
-| VPP forwards ICMPv6 packets through VM via two L2 bridge domains with static L2FIB entries
-| | [Documentation] | Setup and run VM connected to VPP via Vhost-User
-| | ...             | interfaces and check ICMPv6 packet forwarding through VM
-| | ...             | via two L2 bridge domains with learning disabled
-| | ...             | (static L2BFIB entries).
+| TC09: DUT with two L2BDs (static MACs) switches ICMPv6 between TG and VM links
+| | [Documentation]
+| | ... | [Top] TG=DUT=VM. [Enc] Eth-IPv6-ICMPv6. [Cfg] On DUT1 configure \
+| | ... | two L2BDs with static MACs, each with vhost-user i/f to local VM
+| | ... | and i/f to TG; configure VM to loop pkts back betwen its two
+| | ... | virtio i/fs. [Ver] Make TG verify ICMPv6 Echo Req pkts are
+| | ... | switched thru DUT1 and VM in both directions and are correct on
+| | ... | receive. [Ref]
 | | [Tags] | 3_NODE_DOUBLE_LINK_TOPO | VPP_VM_ENV
 | | Given Path for 2-node testing is set
 | | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['TG']}