BGP application peer functional suite documentation update.

[integration/test.git] / csit / suites / bgpcep / bgpuser / bgp_app_peer_basic.robot

diff --git a/csit/suites/bgpcep/bgpuser/bgp_app_peer_basic.robot b/csit/suites/bgpcep/bgpuser/bgp_app_peer_basic.robot
index ff13ba4dfc6de72f3d0be6fc222a4c9e6213c4b0..03fdcafe0127a36b8ab9d9403111217988899a36 100644 (file)
--- a/csit/suites/bgpcep/bgpuser/bgp_app_peer_basic.robot
+++ b/csit/suites/bgpcep/bgpuser/bgp_app_peer_basic.robot
@@ -8,12 +8,45 @@ Documentation     Basic tests for BGP application peer.
 ...               and is available at http://www.eclipse.org/legal/epl-v10.html
 ...
 ...               Test suite performs basic BGP functional test cases for
-...               BGP application peer.
+...               BGP application peer operations and checks for IP4 topology updates
+...               and updates towards BGP peer as follows:
+...
+...               Test case 1: Initial BGP peer connection with pre-filled topology (Bug 4714),
+...               POST and simple DELETE requests used. 
+...               BGP_Application_Peer_Post_3_Initial_Routes,
+...               Check_Example-IPv4-Topology_Is_Filled_With_3_Routes,
+...               Connect_BGP_Peer,
+...               BGP_Peer_Check_Incomming_Updates_For_3_Introduced_Prefixes,
+...               BGP_Application_Peer_Delete_3_Initial_Routes,
+...               Check_Example-IPv4-Topology_Is_Empty,
+...               Peer_Check_Incomming_Updates_For_3_Withdrawn_Prefixes,
+...               Stop_BGP_Peer.
+...
+...               Test case 2: PUT and DELETE all routes requests while BGP peer is connected.
+...               Reconnect_BGP_Peer,
+...               BGP_Application_Peer_Put_3_Routes,
+...               Check_Example-IPv4-Topology_Is_Filled_With_3_Routes,
+...               BGP_Peer_Check_Incomming_Updates_For_3_Introduced_Prefixes,
+...               BGP_Application_Peer_Delete_All_Routes,
+...               Check_Example-IPv4-Topology_Is_Empty,
+...               BGP_Peer_Check_Incomming_Updates_For_3_Withdrawn_Prefixes,
+...               Stop_BGP_Peer.
+...
+...               Test case 3: Repeated BGP peer re-connection with pre-filled topology.
+...               BGP_Application_Peer_Put_3_Routes,
+...               Check_Example-IPv4-Topology_Is_Filled_With_3_Routes,
+...               Reconnect_BGP_Peer_And_Check_Incomming_Updates_For_3_Introduced_Prefixes,
+...               BGP_Application_Peer_Delete_All_Routes,
+...               Check_Example-IPv4-Topology_Is_Empty,
+...               BGP_Peer_Check_Incomming_Updates_For_3_Withdrawn_Prefixes,
+...               Stop_BGP_Peer.
 ...
 ...               Brief description how to configure BGP application peer and
 ...               how to use restconf application peer interface:
 ...               https://wiki.opendaylight.org/view/BGP_LS_PCEP:User_Guide#BGP_Application_Peer
 ...               https://wiki.opendaylight.org/view/BGP_LS_PCEP:Programmer_Guide#BGP
+...               Covered bugs:
+...               Bug 4714 - No routes from loc-rib are advertised to newly connected peer
 Suite Setup       Setup_Everything
 Suite Teardown    Teardown_Everything
 Test Setup        SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
@@ -73,15 +106,6 @@ Check_For_Empty_Example-IPv4-Topology
     [Tags]    critical
     Wait_For_Topology_To_Change_To    ${empty_json}    000_Empty.json    timeout=120s
 
-TC1_Connect_BGP_Peer
-    [Documentation]    Start BGP peer tool
-    [Tags]    critical
-    Switch_To_BGP_Peer_Console
-    Start_Console_Tool    ${BGP_PEER_COMMAND}    ${BGP_PEER_OPTIONS}
-    Read_And_Fail_If_Prompt_Is_Seen
-    Check_File_For_Word_Count    bgp_peer.log    nlri_prefix_received:    0
-    Check_File_For_Word_Count    bgp_peer.log    withdrawn_prefix_received:    0
-
 TC1_BGP_Application_Peer_Post_3_Initial_Routes
     [Documentation]    Start BGP application peer tool and give it ${BGP_APP_PEER_TIMEOUT}
     [Tags]    critical
@@ -95,6 +119,13 @@ TC1_Check_Example-IPv4-Topology_Is_Filled_With_3_Routes
     [Tags]    critical
     Wait_For_Topology_To_Change_To    ${filled_json}    010_Filled.json
 
+TC1_Connect_BGP_Peer
+    [Documentation]    Start BGP peer tool
+    [Tags]    critical
+    Switch_To_BGP_Peer_Console
+    Start_Console_Tool    ${BGP_PEER_COMMAND}    ${BGP_PEER_OPTIONS}
+    Read_And_Fail_If_Prompt_Is_Seen
+
 TC1_BGP_Peer_Check_Incomming_Updates_For_3_Introduced_Prefixes
     [Documentation]    Check incomming updates for new routes
     [Tags]    critical
@@ -104,6 +135,7 @@ TC1_BGP_Peer_Check_Incomming_Updates_For_3_Introduced_Prefixes
     Check_File_For_Word_Count    bgp_peer.log    nlri_prefix_received: 8.0.1.16/28    1
     Check_File_For_Word_Count    bgp_peer.log    nlri_prefix_received: 8.0.1.32/28    1
     Check_File_For_Word_Count    bgp_peer.log    withdrawn_prefix_received:    0
+    [Teardown]    Report_Failure_Due_To_Bug    4714
 
 TC1_BGP_Application_Peer_Delete_3_Initial_Routes
     [Documentation]    Start BGP application peer tool and give him ${BGP_APP_PEER_TIMEOUT}
@@ -127,6 +159,7 @@ TC1_Peer_Check_Incomming_Updates_For_3_Withdrawn_Prefixes
     Check_File_For_Word_Count    bgp_peer.log    withdrawn_prefix_received: 8.0.1.16/28    1
     Check_File_For_Word_Count    bgp_peer.log    withdrawn_prefix_received: 8.0.1.32/28    1
     Check_File_For_Word_Count    bgp_peer.log    nlri_prefix_received:    3
+    [Teardown]    Report_Failure_Due_To_Bug    4714
 
 TC1_Stop_BGP_Peer
     [Documentation]    Stop BGP peer tool
@@ -135,7 +168,7 @@ TC1_Stop_BGP_Peer
     Stop_Console_Tool
     Store_File_To_Workspace    bgp_peer.log    bgp_peer_tc1.log
 
-TC2_Connect_BGP_Peer
+TC2_Reconnect_BGP_Peer
     [Documentation]    Start BGP peer tool
     [Tags]    critical
     Switch_To_BGP_Peer_Console