Library SSHLibrary
Library String
Library DateTime
+Library Process
Library ./UtilLibrary.py
Resource KarafKeywords.robot
-Variables ../variables/Variables.py
+Variables ../variables/Variables.py
*** Variables ***
# TODO: Introduce ${tree_size} and use instead of 1 in the next line.
${start} sudo mn --controller=remote,ip=${CONTROLLER} --topo tree,1 --switch ovsk,protocols=OpenFlow13
-${controller_index} -1
*** Keywords ***
Start Suite
+ [Arguments] ${system}=${MININET} ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${timeout}=30s
[Documentation] Basic setup/cleanup work that can be done safely before any system
... is run.
- [Arguments] ${system}=${MININET} ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${timeout}=30s
Log Start the test on the base edition
Clean Mininet System
${mininet_conn_id}= Open Connection ${system} prompt=${DEFAULT_LINUX_PROMPT} timeout=${timeout}
Read Until mininet>
Start Mininet
- [Arguments] ${system}=${MININET} ${cmd}=${start} ${custom}=${OVSDB_CONFIG_DIR}/ovsdb.py ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=30s
+ [Arguments] ${system}=${MININET} ${cmd}=${start} ${custom}= ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT}
+ ... ${prompt_timeout}=30s
[Documentation] Basic setup to start mininet with custom topology
Log Start the test on the base edition
Clean Mininet System
Read Until mininet>
[Return] ${mininet_conn_id}
-Connect To Controller Karaf
- [Documentation] Connect to the controller's karaf console.
- ${esc}= BuiltIn.Evaluate chr(int(27))
- ${prompt}= Builtin.Set Variable @${esc}[0m${esc}[34mroot${esc}[0m>
- ${connection}= SSHLibrary.Open_Connection ${CONTROLLER} port=${KARAF_SHELL_PORT} prompt=${prompt}
- Set Suite Variable ${controller_index} ${connection}
- SSHLibrary.Login ${KARAF_USER} ${KARAF_PASSWORD}
-
-Log Message To Controller Karaf
- [Arguments] ${message}
- [Documentation] Send a message into the controller's karaf log file.
- # Background info: If there was no previous SSH connection, the "Get
- # Connection" returns an information structure whose "index" field
- # resolves to "None", and the "Switch Connection" below does not
- # complain.
- ${current}= Get_Connection
- ${connection}= Set Variable ${current.index}
- BuiltIn.Run Keyword If ${controller_index} <> -1 Switch Connection ${controller_index}
- BuiltIn.Run Keyword If ${controller_index} == -1 Connect to Controller Karaf
- SSHLibrary.Write log:log "ROBOT MESSAGE: ${message}"
- SSHLibrary.Read_Until_Prompt
- Switch Connection ${connection}
-
Stop Mininet
[Arguments] ${mininet_conn_id} ${prompt}=${DEFAULT_LINUX_PROMPT}
[Documentation] Basic setup to stop/clean mininet
Read Until ${prompt}
Close Connection
+Report_Failure_Due_To_Bug
+ [Arguments] ${number}
+ [Documentation] Report that a test failed due to a known Bugzilla bug whose
+ ... number is provided as an argument.
+ ... This must be used in the [Teardown] setting of the affected test
+ ... or as the first line of the test if FastFail module is not being
+ ... used. It reports the URL of the bug on console and also puts it
+ ... into the Robot log file.
+ ${msg}= BuiltIn.Set_Variable This test fails due to https://bugs.opendaylight.org/show_bug.cgi?id=${number}
+ ${newline}= BuiltIn.Evaluate chr(10)
+ Run Keyword If "${TEST STATUS}"=="FAIL" BuiltIn.Set Test Message ${msg}${newline}${newline}${TEST_MESSAGE}
+ Run Keyword If "${TEST STATUS}"=="FAIL" BuiltIn.Log ${msg}
+
Ensure All Nodes Are In Response
[Arguments] ${URI} ${node_list}
[Documentation] A GET is made to the supplied ${URI} and every item in the ${node_list}
... specific but any list of strings can be given in ${node_list}. Refactoring of this
... to make it more generic should be done. (see keyword "Check For Elements At URI")
: FOR ${node} IN @{node_list}
- \ ${resp} RequestsLibrary.Get session ${URI}
+ \ ${resp} RequestsLibrary.Get Request session ${URI}
\ Should Be Equal As Strings ${resp.status_code} 200
\ Should Contain ${resp.content} ${node}
[Arguments] ${node}
[Documentation] A GET on the /node/${node} API is made and specific flow stat
... strings are checked for existence.
- ${resp} RequestsLibrary.Get session ${OPERATIONAL_NODES_API}/node/${node}
+ ${resp} RequestsLibrary.Get Request session ${OPERATIONAL_NODES_API}/node/${node}
Should Be Equal As Strings ${resp.status_code} 200
Should Contain ${resp.content} flow-capable-node-connector-statistics
Should Contain ${resp.content} flow-table-statistics
[Documentation] A GET on the /port API is made and the specified port ${count} is
... verified. A more generic Keyword "Check For Specific Number Of Elements At URI"
... also does this work and further consolidation should be done.
- ${resp} RequestsLibrary.Get session ${REST_CONTEXT}/${CONTAINER}/port
+ ${resp} RequestsLibrary.Get Request session ${REST_CONTEXT}/${CONTAINER}/port
Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
Should Contain X Times ${resp.content} ${node} ${count}
[Arguments] ${uri} ${element} ${expected_count}
[Documentation] A GET is made to the specified ${URI} and the specific count of a
... given element is done (as supplied by ${element} and ${expected_count})
- ${resp} RequestsLibrary.Get session ${uri}
+ ${resp} RequestsLibrary.Get Request session ${uri}
Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
Should Contain X Times ${resp.content} ${element} ${expected_count}
[Arguments] ${uri} ${elements}
[Documentation] A GET is made at the supplied ${URI} and every item in the list of
... ${elements} is verified to exist in the response
- ${resp} RequestsLibrary.Get session ${uri}
+ ${resp} RequestsLibrary.Get Request session ${uri}
Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
: FOR ${i} IN @{elements}
[Arguments] ${uri} ${elements}
[Documentation] A GET is made at the supplied ${URI} and every item in the list of
... ${elements} is verified to NOT exist in the response
- ${resp} RequestsLibrary.Get session ${uri}
+ ${resp} RequestsLibrary.Get Request session ${uri}
Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
: FOR ${i} IN @{elements}
... the expected PID
# doing the extra -v grep in this command to exclude the grep process itself from the output
${cmd}= Set Variable ps -elf | grep -v grep | grep ${regex_string_to_match_on} | awk '{print $4}'
- ${output}= Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt} prompt_timeout=${prompt_timeout}
+ ${output}= Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt}
+ ... prompt_timeout=${prompt_timeout}
# ${output} contains the system prompt and all we want is the value of the number
${pid}= Fetch From Left ${output} \r
- [Return] ${pid}
# TODO: Get Process * keywords have perhaps non-standard default credentials.
# ... Should there be * On Mininet and * On Controller specializations?
+ [Return] ${pid}
Get Process Thread Count On Remote System
[Arguments] ${system} ${pid} ${user}=${MININET_USER} ${password}=${EMPTY} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=30s
[Documentation] Executes the ps command to retrieve the lightweight process (aka thread) count.
${cmd}= Set Variable ps --no-headers -o nlwp ${pid}
- ${output}= Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt} prompt_timeout=${prompt_timeout}
+ ${output}= Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt}
+ ... prompt_timeout=${prompt_timeout}
# ${output} contains the system prompt and all we want is the value of the number
${thread_count}= Fetch From Left ${output} \r
[Return] ${thread_count}
${pwd_length} = BuiltIn.Get Length ${password}
# ${pwd_length} is guaranteed to be an integer, so we are safe to evaluate it as Python expression.
BuiltIn.Run Keyword And Return If ${pwd_length} > 0 SSHLibrary.Login ${user} ${password} delay=${delay}
- BuiltIn.Run Keyword And Return SSHLibrary.Login With Public Key ${user} ${USER_HOME}/.ssh/${SSH_KEY} ${KEYFILE_PASS} delay=${delay}
+ BuiltIn.Run Keyword And Return SSHLibrary.Login With Public Key ${user} ${USER_HOME}/.ssh/${SSH_KEY} ${KEYFILE_PASS} delay=${delay}
Flexible Mininet Login
[Arguments] ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${delay}=0.5s
Log ${output}
[Return] ${output}
+Write_Bare_Ctrl_C
+ [Documentation] Construct ctrl+c character and SSH-write it (without endline) to the current SSH connection.
+ ... Do not read anything yet.
+ ${ctrl_c}= BuiltIn.Evaluate chr(int(3))
+ SSHLibrary.Write_Bare ${ctrl_c}
+
Run Command On Mininet
[Arguments] ${system}=${MININET} ${cmd}=echo ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=30s
[Documentation] Call Run Comand On Remote System, but with default values suitable for Mininet machine.
- BuiltIn.Run Keyword And Return Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt} prompt_timeout=${prompt_timeout}
+ BuiltIn.Run Keyword And Return Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt}
+ ... prompt_timeout=${prompt_timeout}
Run Command On Controller
[Arguments] ${system}=${CONTROLLER} ${cmd}=echo ${user}=${CONTROLLER_USER} ${password}=${CONTROLLER_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=30s
[Documentation] Call Run Comand On Remote System, but with default values suitable for Controller machine.
- BuiltIn.Run Keyword And Return Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt} prompt_timeout=${prompt_timeout}
+ BuiltIn.Run Keyword And Return Run Command On Remote System ${system} ${cmd} user=${user} password=${password} prompt=${prompt}
+ ... prompt_timeout=${prompt_timeout}
Verify File Exists On Remote System
[Arguments] ${system} ${file} ${user}=${MININET_USER} ${password}=${MININET_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=5s
${output}= Catenate ${str1} ${str2}
[Return] ${output}
+Post Elements To URI
+ [Arguments] ${rest_uri} ${data}
+ [Documentation] Perform a POST rest operation, using the URL and data provided
+ ${resp} = RequestsLibrary.Post Request session ${rest_uri} data=${data} headers=${headers}
+ Should Be Equal As Strings ${resp.status_code} 200
+
Remove All Elements At URI
[Arguments] ${uri}
- ${resp} RequestsLibrary.Delete session ${uri}
+ ${resp} RequestsLibrary.Delete Request session ${uri}
Should Be Equal As Strings ${resp.status_code} 200
Add Elements To URI From File
[Arguments] ${dest_uri} ${data_file}
${body} OperatingSystem.Get File ${data_file}
- ${resp} RequestsLibrary.Put session ${dest_uri} data=${body} headers=${headers}
+ ${resp} RequestsLibrary.Put Request session ${dest_uri} data=${body} headers=${headers}
Should Be Equal As Strings ${resp.status_code} 200
Post Elements To URI From File
[Arguments] ${dest_uri} ${data_file}
${body} OperatingSystem.Get File ${data_file}
- ${resp} RequestsLibrary.Post session ${dest_uri} data=${body} headers=${headers}
+ ${resp} RequestsLibrary.Post Request session ${dest_uri} data=${body} headers=${headers}
Should Be Equal As Strings ${resp.status_code} 200
+
+Run Process With Logging And Status Check
+ [Arguments] @{proc_args}
+ [Documentation] Execute an OS command, log STDOUT and STDERR output and check exit code to be 0
+ ${result}= Run Process @{proc_args}
+ Log ${result.stdout}
+ Log ${result.stderr}
+ Should Be Equal As Integers ${result.rc} 0
+ [Return] ${result}
+
+Get Data From URI
+ [Arguments] ${session} ${uri} ${headers}=${NONE}
+ [Documentation] Issue a GET request and return the data obtained or on error log the error and fail.
+ ... Issues a GET request for ${uri} in ${session} using headers from
+ ... ${headers}. If the request returns a HTTP error, fails. Otherwise
+ ... returns the data obtained by the request.
+ ${response}= RequestsLibrary.Get Request ${session} ${uri} ${headers}
+ Builtin.Return_From_Keyword_If ${response.status_code} == 200 ${response.text}
+ Builtin.Log ${response.text}
+ Builtin.Fail The request failed with code ${response.status_code}