Library ${CURDIR}/UtilLibrary.py
Resource ${CURDIR}/SSHKeywords.robot
Resource ${CURDIR}/TemplatedRequests.robot
-Variables ${CURDIR}/../variables/Variables.py
+Resource ${CURDIR}/../variables/Variables.robot
*** Variables ***
# TODO: Introduce ${tree_size} and use instead of 1 in the next line.
Should Be Equal As Strings ${resp.status_code} 200
Should Contain X Times ${resp.content} ${element} ${expected_count}
+Log Content
+ [Arguments] ${resp_content}
+ ${resp_json} = BuiltIn.Run Keyword If '''${resp_content}''' != '${EMPTY}' RequestsLibrary.To Json ${resp_content} pretty_print=True
+ ... ELSE BuiltIn.Set Variable ${EMPTY}
+ BuiltIn.Log ${resp_json}
+ [Return] ${resp_json}
+
Check For Elements At URI
- [Arguments] ${uri} ${elements} ${session}=session
+ [Arguments] ${uri} ${elements} ${session}=session ${pretty_print_json}=False
[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 Request ${session} ${uri}
- Log ${resp.content}
+ BuiltIn.Run Keyword If "${pretty_print_json}" == "True" Log Content ${resp.content}
+ ... ELSE BuiltIn.Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
: FOR ${i} IN @{elements}
\ Should Contain ${resp.content} ${i}
Check For Elements Not At URI
- [Arguments] ${uri} ${elements} ${session}=session
+ [Arguments] ${uri} ${elements} ${session}=session ${pretty_print_json}=False
[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 Request ${session} ${uri}
- Log ${resp.content}
+ BuiltIn.Run Keyword If "${pretty_print_json}" == "True" Log Content ${resp.content}
+ ... ELSE BuiltIn.Log ${resp.content}
Should Be Equal As Strings ${resp.status_code} 200
: FOR ${i} IN @{elements}
\ Should Not Contain ${resp.content} ${i}
Run Command On Remote System
[Arguments] ${system} ${cmd} ${user}=${DEFAULT_USER} ${password}=${EMPTY} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=${DEFAULT_TIMEOUT}
+ ... ${return_stdout}=True ${return_stderr}=False
[Documentation] Reduces the common work of running a command on a remote system to a single higher level
- ... robot keyword, taking care to log in with a public key and. The command given is written
- ... and the output returned. No test conditions are checked.
+ ... robot keyword, taking care to log in with a public key and. The command given is written and the return value
+ ... depends on the passed argument values of return_stdout (default: True) and return_stderr (default: False).
+ ... At least one should be True, or the keyword will exit and FAIL. If both are True, the resulting return value
+ ... will be a two element list containing both. Otherwise the resulting return value is a string.
+ ... No test conditions are checked.
+ Run Keyword If "${return_stdout}"!="True" and "${return_stderr}"!="True" Fail At least one of {return_stdout} or {return_stderr} args should be set to True
${current_ssh_connection}= SSHLibrary.Get Connection
- BuiltIn.Log Attempting to execute command "${cmd}" on remote system "${system}" by user "${user}" with keyfile pass "${keyfile_pass}" and prompt "${prompt}"
- BuiltIn.Log ${password}
+ BuiltIn.Log Attempting to execute command "${cmd}" on remote system "${system}" by user "${user}" with keyfile pass "${keyfile_pass}" and prompt "${prompt}" and password "${password}"
${conn_id}= SSHLibrary.Open Connection ${system} prompt=${prompt} timeout=${prompt_timeout}
SSHKeywords.Flexible SSH Login ${user} ${password}
${stdout} ${stderr} SSHLibrary.Execute Command ${cmd} return_stderr=True
SSHLibrary.Close Connection
Log ${stderr}
+ Run Keyword If "${return_stdout}"!="True" Return From Keyword ${stderr}
+ Run Keyword If "${return_stderr}"!="True" Return From Keyword ${stdout}
[Teardown] SSHKeywords.Restore_Current_SSH_Connection_From_Index ${current_ssh_connection.index}
- [Return] ${stdout}
+ [Return] ${stdout} ${stderr}
Run Command On Remote System And Log
[Arguments] ${system} ${cmd} ${user}=${DEFAULT_USER} ${password}=${EMPTY} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=${DEFAULT_TIMEOUT}
Run Command On Controller
[Arguments] ${system}=${ODL_SYSTEM_IP} ${cmd}=echo ${user}=${ODL_SYSTEM_USER} ${password}=${ODL_SYSTEM_PASSWORD} ${prompt}=${ODL_SYSTEM_PROMPT}
[Documentation] Call Run Comand On Remote System, but with default values suitable for Controller machine.
- BuiltIn.Log ${password}
BuiltIn.Run Keyword And Return Run Command On Remote System ${system} ${cmd} ${user} ${password} prompt=${prompt}
+Run Command On Existing Connection
+ [Arguments] ${conn_id}=${EMPTY} ${cmd}=echo ${return_stdout}=True ${return_stderr}=False
+ [Documentation] Switch to and run command on an already existing SSH connection and switch back
+ Run Keyword If "${return_stdout}"!="True" and "${return_stderr}"!="True" Fail At least one of {return_stdout} or {return_stderr} args should be set to True
+ ${current_ssh_connection}= SSHLibrary.Get Connection
+ BuiltIn.Log Attempting to execute command "${cmd}" on existing connection "${conn_id}
+ SSHLibrary.Switch Connection ${conn_id}
+ ${stdout} ${stderr} SSHLibrary.Execute Command ${cmd} return_stderr=True
+ Log ${stderr}
+ Run Keyword If "${return_stdout}"!="True" Return From Keyword ${stderr}
+ Run Keyword If "${return_stderr}"!="True" Return From Keyword ${stdout}
+ [Teardown] SSHKeywords.Restore_Current_SSH_Connection_From_Index ${current_ssh_connection.index}
+ [Return] ${stdout} ${stderr}
+
Verify File Exists On Remote System
[Arguments] ${system} ${file} ${user}=${TOOLS_SYSTEM_USER} ${password}=${TOOLS_SYSTEM_PASSWORD} ${prompt}=${DEFAULT_LINUX_PROMPT} ${prompt_timeout}=5s
[Documentation] Will create connection with public key and will PASS if the given ${file} exists,
Json Parse From File
[Arguments] ${json_file}
[Documentation] Parse given file content into json (dictionary)
- ${json_plain_string} Get file ${json_file}
+ ${json_plain_string} OperatingSystem.Get file ${json_file}
${json_data} Json Parse From String ${json_plain_string}
[Return] ${json_data}
+
+Modify Iptables On Remote System
+ [Arguments] ${remote_system_ip} ${iptables_rule} ${user}=${ODL_SYSTEM_USER} ${password}=${ODL_SYSTEM_PASSWORD} ${prompt}=${ODL_SYSTEM_PROMPT}
+ [Documentation] Wrapper keyword to run iptables with any given ${iptables_rule} string on the remote system given
+ ... by ${remote_system_ip}. The iptables listing will be output before and after the command is run
+ ${list_iptables_command} = BuiltIn.Set Variable sudo /sbin/iptables -L -n
+ ${output} = Utils.Run Command On Remote System ${remote_system_ip} ${list_iptables_command} ${user} ${password} prompt=${prompt}
+ BuiltIn.Log ${output}
+ Utils.Run Command On Remote System ${remote_system_ip} sudo /sbin/iptables ${iptables_rule} ${user} ${password} prompt=${prompt}
+ ${output} = Utils.Run Command On Remote System ${remote_system_ip} ${list_iptables_command} ${user} ${password} prompt=${prompt}
+ BuiltIn.Log ${output}
+
+Get_Sysstat_Statistics
+ [Arguments] ${ip_address}=${ODL_SYSTEM_IP}
+ [Documentation] Store current connection index, open new connection to ip_address. Run command to get sysstat results from script,
+ ... which is running on all children nodes. Returns cpu, network, memory usage statistics from the node for each 10 minutes
+ ... that node was running. Used for debug purposes. Returns whole output of sysstat.
+ ${current_connection}= SSHLibrary.Get_Connection
+ SSHKeywords.Open_Connection_To_ODL_System ${ip_address}
+ SSHLibrary.Write sar -A -f /var/log/sa/sa*
+ ${output} SSHLibrary.Read_Until_Prompt
+ BuiltIn.Log ${output}
+ SSHLibrary.Close_Connection
+ [Teardown] SSHKeywords.Restore_Current_SSH_Connection_From_Index ${current_connection.index}
+ [Return] ${output}
+
+Check Diagstatus
+ [Arguments] ${ip_address}=${ODL_SYSTEM_IP} ${check_status}=True ${expected_status}=${200}
+ [Documentation] GET http://${ip_address}:${RESTCONFPORT}/diagstatus and return the response. ${check_status}
+ ... and ${expected_status_code} can be used to ignore the status code, or validate any status code value.
+ ... By default, this keyword will pass if the status code returned is 200, and fail otherwise.
+ RequestsLibrary.Create Session diagstatus_session http://${ip_address}:${RESTCONFPORT}
+ ${resp} RequestsLibrary.Get Request diagstatus_session /diagstatus
+ Run Keyword If "${check_status}" == "True" BuiltIn.Should Be Equal As Strings ${resp.status_code} ${expected_status}
+ [Return] ${resp}