2 Documentation netconf-restperfclient MDSAL performance test suite.
4 ... Copyright (c) 2016 Cisco Systems, Inc. and others. All rights reserved.
6 ... This program and the accompanying materials are made available under the
7 ... terms of the Eclipse Public License v1.0 which accompanies this distribution,
8 ... and is available at http://www.eclipse.org/legal/epl-v10.html
11 ... Perform given count of update operations on ODL MDSAL. In first half the
12 ... requests are directed directly to MDSAL via Restconf and in the second
13 ... half the MDSAL is mounted onto a netconf connector and the reqursts are
14 ... directed to that connector. In both cases the netconf-testtool-restperfclient
15 ... tool is used to generate and send the requests and the requests are sent
16 ... synchronously as the netconf connector mounted MDSAL does not support
17 ... asynchronous requests. The restperfclient is used to generate the "update"
18 ... requests, the "create" request is issued in a sepate test case.
19 Suite Setup Setup_Everything
20 Suite Teardown Teardown_Everything
21 Test Setup SetupUtils.Setup_Test_With_Logging_And_Fast_Failing
22 Test Teardown SetupUtils.Teardown_Test_Show_Bugs_And_Start_Fast_Failing_If_Test_Failed
23 Library RequestsLibrary
24 Library OperatingSystem
25 Library SSHLibrary timeout=10s
26 Resource ${CURDIR}/../../../libraries/NetconfKeywords.robot
27 Resource ${CURDIR}/../../../libraries/NexusKeywords.robot
28 Resource ${CURDIR}/../../../libraries/RestPerfClient.robot
29 Resource ${CURDIR}/../../../libraries/SetupUtils.robot
30 Resource ${CURDIR}/../../../libraries/TemplatedRequests.robot
31 Resource ${CURDIR}/../../../libraries/Utils.robot
32 Variables ${CURDIR}/../../../variables/Variables.py
35 ${DIRECTORY_WITH_TEMPLATE_FOLDERS} ${CURDIR}/../../../variables/netconf/RestPerfClient
36 ${REQUEST_COUNT} 65536
37 ${device_type} full-uri-device
38 ${test_device} odl-mdsal-northbound-via-netconf-connector
41 Create_Test_Data_For_Direct_Access
42 [Documentation] Send some sample test data into the device and check that the request went OK.
43 TemplatedRequests.Post_As_Xml_Templated ${DIRECTORY_WITH_TEMPLATE_FOLDERS}${/}cars {}
45 Run_RestPerfClient_Directly_On_MDSAL
46 [Documentation] Deploy and execute restperfclient, asking it to send the specified amount of requests to the MDSAL via Restconf.
47 ${url}= BuiltIn.Set_Variable /restconf/config/car:cars
48 RestPerfClient.Invoke_Restperfclient ${DIRECT_MDSAL_TIMEOUT} ${url} testcase=direct
50 Check_For_Failed_Direct_MDSAL_Requests
51 [Documentation] Make sure there are no failed requests in the restperfclient log.
52 ... This is a separate test case to distinguish between restperfclient
53 ... failure and failed requests. Failed requests are rejected because
54 ... we don't want to test performance of ODL rejecting our requests.
55 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
56 ${result}= RestPerfClient.Grep_Restperfclient_Log thread timed out
57 BuiltIn.Should_Be_Equal '${result}' ''
58 ${result}= RestPerfClient.Grep_Restperfclient_Log Request failed
59 BuiltIn.Should_Be_Equal '${result}' ''
60 ${result}= RestPerfClient.Grep_Restperfclient_Log Status code
61 BuiltIn.Should_Be_Equal '${result}' ''
63 Cleanup_And_Collect_For_Direct_Access
64 [Documentation] Cleanup the test data produced by the direct MDSAL access.
65 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
66 RestPerfClient.Collect_From_Restperfclient
67 TemplatedRequests.Delete_Templated ${DIRECTORY_WITH_TEMPLATE_FOLDERS}${/}cars-delete {}
69 Create_Test_Data_For_Connector_Access
70 [Documentation] Create the test data container again so it is ready for the netconf connector test.
71 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
72 TemplatedRequests.Post_As_Xml_Templated ${DIRECTORY_WITH_TEMPLATE_FOLDERS}${/}cars {}
74 Configure_ODL_As_A_Device_On_Netconf
75 [Documentation] Configure ODL MDSAL Northbound as a Netconf device on a Netconf connector.
76 NetconfKeywords.Configure_Device_In_Netconf ${test_device} device_type=${device_type} device_address=${ODL_SYSTEM_IP} device_port=${ODL_NETCONF_MDSAL_PORT} device_user=${ODL_NETCONF_USER} device_password=${ODL_NETCONF_PASSWORD}
77 NetconfKeywords.Wait_Device_Connected ${test_device}
79 Run_RestPerfClient_Through_Netconf_Connector
80 [Documentation] Ask RestPerfClient to send the requests to the MDSAL mapped via netconf topology device.
81 ${url}= BuiltIn.Set_Variable /restconf/config/network-topology:network-topology/topology/topology-netconf/node/${test_device}/yang-ext:mount/car:cars
82 RestPerfClient.Invoke_Restperfclient ${NETCONF_CONNECTOR_MDSAL_TIMEOUT} ${url} testcase=netconf-connector
84 Check_For_Failed_Netconf_Connector_Requests
85 [Documentation] Make sure there are no failed requests in the restperfclient log.
86 ... This is a separate test case to distinguish between restperfclient
87 ... failure and failed requests. Failed requests are rejected because
88 ... we don't want to test performance of ODL rejecting our requests.
89 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
91 ${result}= RestPerfClient.Grep_Restperfclient_Log thread timed out
92 BuiltIn.Should_Be_Equal '${result}' ''
94 ${result}= RestPerfClient.Grep_Restperfclient_Log Request failed
95 BuiltIn.Should_Be_Equal '${result}' ''
96 ${result}= RestPerfClient.Grep_Restperfclient_Log Status code
97 BuiltIn.Should_Be_Equal '${result}' ''
99 Deconfigure_ODL_From_Netconf
100 [Documentation] Deconfigure the ODL MDSAL Northbound attached to a Netconf connector.
101 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
102 NetconfKeywords.Remove_Device_From_Netconf ${test_device}
104 Cleanup_And_Collect_For_Connector_Access
105 [Documentation] Delete the test data produced by the Netconf connector MDSAL access.
106 [Setup] SetupUtils.Setup_Test_With_Logging_And_Without_Fast_Failing
107 RestPerfClient.Collect_From_Restperfclient
108 TemplatedRequests.Delete_Templated ${DIRECTORY_WITH_TEMPLATE_FOLDERS}${/}cars-delete {}
112 [Documentation] Setup everything needed for the test cases.
113 # Setup resources used by the suite.
114 SetupUtils.Setup_Utils_For_Setup_And_Teardown
115 NetconfKeywords.Setup_Netconf_Keywords
116 RestPerfClient.Setup_Restperfclient
117 ${device_type}= BuiltIn.Set_Variable_If ${USE_NETCONF_CONNECTOR}==${True} default ${device_type}
118 BuiltIn.Set_Suite_Variable ${device_type}
120 ${value}= BuiltIn.Evaluate ${REQUEST_COUNT}/50+10
121 Utils.Set_User_Configurable_Variable_Default DIRECT_MDSAL_TIMEOUT ${value} s
122 ${value}= BuiltIn.Evaluate ${REQUEST_COUNT}/10+10
123 Utils.Set_User_Configurable_Variable_Default NETCONF_CONNECTOR_MDSAL_TIMEOUT ${value} s
126 [Documentation] Teardown the test infrastructure, perform cleanup and release all resources.
127 RequestsLibrary.Delete_All_Sessions
128 RestPerfClient.Teardown_Restperfclient