blob: fc6a488a948165226af515002f01760e8aeeb37d [file] [log] [blame]
Chris Austenb29d2e82016-06-07 12:25:35 -05001*** Settings ***
Steven Sombar0acb3412018-01-24 09:38:42 -06002
3Documentation Utilities for Robot keywords.
4
Chris Austenb29d2e82016-06-07 12:25:35 -05005Resource ../lib/resource.txt
6Resource ../lib/rest_client.robot
George Keishing5e870cd2016-08-24 10:05:47 -05007Resource ../lib/connection_client.robot
Michael Walsh391ba9b2017-08-24 11:36:24 -05008Library String
George Keishing30c12ff2016-09-02 10:25:29 -05009Library DateTime
10Library Process
Chris Austenb29d2e82016-06-07 12:25:35 -050011Library OperatingSystem
Michael Walsha6723f22016-11-22 11:12:01 -060012Library gen_print.py
13Library gen_robot_print.py
Michael Walsh5f3f4142017-05-22 17:09:47 -050014Library gen_cmd.py
Sunil Macd110a2017-05-23 04:14:32 -050015Library gen_robot_keyword.py
Michael Walshe53e47a2017-06-30 17:03:24 -050016Library bmc_ssh_utils.py
Michael Walshfdc5ced2017-08-17 13:15:15 -050017Library utils.py
Charles Paul Hofer35816152017-10-02 11:55:11 -050018Library var_funcs.py
Sridevi Ramesh0d88ab32017-09-21 11:07:28 -050019Library SCPLibrary WITH NAME scp
Chris Austenb29d2e82016-06-07 12:25:35 -050020
21*** Variables ***
Steven Sombar0acb3412018-01-24 09:38:42 -060022
23${pflash_cmd} /usr/sbin/pflash -r /dev/stdout -P VERSION
24${SYSTEM_SHUTDOWN_TIME} ${5}
25
Michael Walsha6723f22016-11-22 11:12:01 -060026${dbuscmdBase}
George Keishing85ca05e2016-11-30 09:47:18 -060027... dbus-send --system --print-reply --dest=${OPENBMC_BASE_DBUS}.settings.Host
Michael Walsha6723f22016-11-22 11:12:01 -060028${dbuscmdGet}
George Keishing9485af92017-01-04 10:21:43 -060029... ${SETTINGS_URI}host0 org.freedesktop.DBus.Properties.Get
Steven Sombar0acb3412018-01-24 09:38:42 -060030${dbuscmdString}= string:"xyz.openbmc_project.settings.Host" string:
Michael Walsha6723f22016-11-22 11:12:01 -060031
32# Assign default value to QUIET for programs which may not define it.
33${QUIET} ${0}
Steven Sombar0acb3412018-01-24 09:38:42 -060034
Sivas SRRea85d1f2016-11-13 22:44:28 -060035${bmc_mem_free_cmd}= free | tr -s ' ' | sed '/^Mem/!d' | cut -d" " -f4
36${bmc_mem_total_cmd}= free | tr -s ' ' | sed '/^Mem/!d' | cut -d" " -f2
37${bmc_cpu_usage_cmd}= top -n 1 | grep CPU: | cut -c 7-9
Sridevi Ramesh1699d372016-12-06 00:20:22 -060038${HOST_SETTING} ${SETTINGS_URI}host0
Steven Sombar0acb3412018-01-24 09:38:42 -060039
Sivas SRR352bc162017-02-13 22:12:29 -060040# /run/initramfs/ro associate filesystem should be 100% full always
Sivas SRR5ff4d692017-11-23 02:53:52 -060041${bmc_file_system_usage_cmd}= df -h | cut -c 52-54 | grep 100 | wc -l
42${total_pnor_ro_file_system_cmd}= df -h | grep /media/pnor-ro | wc -l
43${total_bmc_ro_file_system_cmd}= df -h | grep /media/rofs | wc -l
Chris Austenb29d2e82016-06-07 12:25:35 -050044
George Keishingcce9df22017-01-24 06:19:33 -060045${BOOT_TIME} ${0}
46${BOOT_COUNT} ${0}
Sweta Potthuri025e0122017-02-21 00:42:48 -060047${count} ${0}
Sivas SRR8254db62017-02-07 09:39:46 -060048${devicetree_base} /sys/firmware/devicetree/base/model
George Keishingcce9df22017-01-24 06:19:33 -060049
George Keishingb7c9b542017-05-23 08:19:58 -050050# Initialize default debug value to 0.
51${DEBUG} ${0}
52
Steven Sombar0acb3412018-01-24 09:38:42 -060053${probe_cpu_tool_path} ${EXECDIR}/tools/ras/probe_cpus.sh
54${scom_addrs_tool_path} ${EXECDIR}/tools/ras/scom_addr_p9.sh
55${target_file_path} /root/
56
57${default_tarball} ${EXECDIR}/obmc-phosphor-debug-tarball-witherspoon.tar.xz
58
Michael Walshfdc5ced2017-08-17 13:15:15 -050059# These variables are used to straddle between new and old methods of setting
60# values.
Steven Sombar0acb3412018-01-24 09:38:42 -060061${boot_prog_method} ${EMPTY}
Michael Walshfdc5ced2017-08-17 13:15:15 -050062${power_policy_setup} ${0}
63${bmc_power_policy_method} ${EMPTY}
64@{valid_power_policy_vars} RESTORE_LAST_STATE ALWAYS_POWER_ON
65... ALWAYS_POWER_OFF
66
Sridevi Ramesh0d88ab32017-09-21 11:07:28 -050067
Chris Austenb29d2e82016-06-07 12:25:35 -050068*** Keywords ***
Sridevi Ramesh1699d372016-12-06 00:20:22 -060069
Sivas SRRc0957412017-10-06 13:02:08 -050070Check BMC Performance
71 [Documentation] Check BMC basic CPU Mem File system performance.
72
73 Check BMC CPU Performance
74 Check BMC Mem Performance
75 Check BMC File System Performance
76
Steven Sombar0acb3412018-01-24 09:38:42 -060077
Sivas SRRd97aa9c2017-05-22 11:19:25 -050078Verify PNOR Update
79 [Documentation] Verify that the PNOR is not corrupted.
80 # Example:
81 # FFS: Flash header not found. Code: 100
82 # Error 100 opening ffs !
83
George Keishinga37682e2018-06-15 13:12:13 -050084 ${pnor_info}= BMC Execute Command ${pflash_cmd}
Sivas SRRd97aa9c2017-05-22 11:19:25 -050085 Should Not Contain Any ${pnor_info} Flash header not found Error
86
Steven Sombar0acb3412018-01-24 09:38:42 -060087
Sivas SRR8254db62017-02-07 09:39:46 -060088Get BMC System Model
Steven Sombar0acb3412018-01-24 09:38:42 -060089 [Documentation] Get the BMC model from the device tree and return it.
Sivas SRR8254db62017-02-07 09:39:46 -060090
Michael Walshe53e47a2017-06-30 17:03:24 -050091 ${bmc_model} ${stderr} ${rc}= BMC Execute Command
George Keishing90ab1772017-02-24 05:40:55 -060092 ... cat ${devicetree_base} | cut -d " " -f 1 return_stderr=True
Michael Walsh71182ab2017-10-20 14:44:25 -050093 ... test_mode=0
Sivas SRR8254db62017-02-07 09:39:46 -060094 Should Be Empty ${stderr}
Steven Sombar0acb3412018-01-24 09:38:42 -060095 Should Not Be Empty ${bmc_model} msg=BMC model is empty.
Sivas SRR8254db62017-02-07 09:39:46 -060096 [Return] ${bmc_model}
97
Steven Sombar0acb3412018-01-24 09:38:42 -060098
Sivas SRR8254db62017-02-07 09:39:46 -060099Verify BMC System Model
100 [Documentation] Verify the BMC model with ${OPENBMC_MODEL}.
101 [Arguments] ${bmc_model}
102
Steven Sombar0acb3412018-01-24 09:38:42 -0600103 # Description of argument(s):
104 # bmc_model System model (e.g. "witherspoon").
105
Sivas SRR8254db62017-02-07 09:39:46 -0600106 ${tmp_bmc_model}= Fetch From Right ${OPENBMC_MODEL} /
107 ${tmp_bmc_model}= Fetch From Left ${tmp_bmc_model} .
108 ${ret}= Run Keyword And Return Status Should Contain ${bmc_model}
109 ... ${tmp_bmc_model} ignore_case=True
110 [Return] ${ret}
111
Steven Sombar0acb3412018-01-24 09:38:42 -0600112
Chris Austenb29d2e82016-06-07 12:25:35 -0500113Wait For Host To Ping
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500114 [Documentation] Wait for the given host to ping.
root442f0ef2016-08-04 20:23:05 +0000115 [Arguments] ${host} ${timeout}=${OPENBMC_REBOOT_TIMEOUT}min
116 ... ${interval}=5 sec
117
Steven Sombar0acb3412018-01-24 09:38:42 -0600118 # Description of argument(s):
119 # host The host name or IP of the host to ping.
120 # timeout The amount of time after which ping attempts cease.
121 # This should be expressed in Robot Framework's time format
122 # (e.g. "10 seconds").
root442f0ef2016-08-04 20:23:05 +0000123 # interval The amount of time in between attempts to ping.
Steven Sombar0acb3412018-01-24 09:38:42 -0600124 # This should be expressed in Robot Framework's time format
125 # (e.g. "5 seconds").
root442f0ef2016-08-04 20:23:05 +0000126
127 Wait Until Keyword Succeeds ${timeout} ${interval} Ping Host ${host}
Chris Austenb29d2e82016-06-07 12:25:35 -0500128
Steven Sombar0acb3412018-01-24 09:38:42 -0600129
Chris Austenb29d2e82016-06-07 12:25:35 -0500130Ping Host
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500131 [Documentation] Ping the given host.
Chris Austenb29d2e82016-06-07 12:25:35 -0500132 [Arguments] ${host}
Steven Sombar0acb3412018-01-24 09:38:42 -0600133
134 # Description of argument(s):
135 # host The host name or IP of the host to ping.
136
George Keishing8a84f952016-08-25 04:54:53 -0500137 Should Not Be Empty ${host} msg=No host provided
Michael Walsha6723f22016-11-22 11:12:01 -0600138 ${RC} ${output}= Run and return RC and Output ping -c 4 ${host}
Chris Austenb29d2e82016-06-07 12:25:35 -0500139 Log RC: ${RC}\nOutput:\n${output}
140 Should be equal ${RC} ${0}
141
Steven Sombar0acb3412018-01-24 09:38:42 -0600142
Chris Austenb29d2e82016-06-07 12:25:35 -0500143Get Boot Progress
Michael Walshc972d4d2017-08-16 15:38:03 -0500144 [Documentation] Get the boot progress and return it.
Michael Walsha6723f22016-11-22 11:12:01 -0600145 [Arguments] ${quiet}=${QUIET}
146
Michael Walshc972d4d2017-08-16 15:38:03 -0500147 # Description of argument(s):
148 # quiet Indicates whether this keyword should run without any output to
149 # the console.
150
151 Set Boot Progress Method
152 ${state}= Run Keyword If '${boot_prog_method}' == 'New'
153 ... New Get Boot Progress quiet=${quiet}
154 ... ELSE
155 ... Old Get Boot Progress quiet=${quiet}
156
157 [Return] ${state}
158
Steven Sombar0acb3412018-01-24 09:38:42 -0600159
Michael Walshc972d4d2017-08-16 15:38:03 -0500160Set Boot Progress Method
161 [Documentation] Set the boot_prog_method to either 'Old' or 'New'.
162
163 # The boot progress data has moved from an 'org' location to an 'xyz'
164 # location. This keyword will determine whether the new method of getting
165 # the boot progress is valid and will set the global boot_prog_method
166 # variable accordingly. If boot_prog_method is already set (either by a
167 # prior call to this function or via a -v parm), this keyword will simply
168 # return.
169
Michael Walsh98d8c9e2017-10-04 12:24:29 -0500170 # Note: There are interim builds that contain boot_progress in both the
171 # old and the new location values. It is nearly impossible for this
172 # keyword to determine whether the old boot_progress or the new one is
173 # active. When using such builds where the old boot_progress is active,
174 # the only recourse users will have is that they may specify
175 # -v boot_prog_method:Old to force old behavior on such builds.
Michael Walshc972d4d2017-08-16 15:38:03 -0500176
177 Run Keyword If '${boot_prog_method}' != '${EMPTY}' Return From Keyword
178
179 ${new_status} ${new_value}= Run Keyword And Ignore Error
180 ... New Get Boot Progress
181 # If the new style read fails, the method must necessarily be "Old".
182 Run Keyword If '${new_status}' == 'PASS'
183 ... Run Keywords
184 ... Set Global Variable ${boot_prog_method} New AND
185 ... Rqpvars boot_prog_method AND
186 ... Return From Keyword
187
188 # Default method is "Old".
189 Set Global Variable ${boot_prog_method} Old
190 Rqpvars boot_prog_method
191
Steven Sombar0acb3412018-01-24 09:38:42 -0600192
Michael Walshc972d4d2017-08-16 15:38:03 -0500193Old Get Boot Progress
194 [Documentation] Get the boot progress the old way (via org location).
195 [Arguments] ${quiet}=${QUIET}
196
197 # Description of argument(s):
198 # quiet Indicates whether this keyword should run without any output to
199 # the console.
200
George Keishing85ca05e2016-11-30 09:47:18 -0600201 ${state}= Read Attribute ${OPENBMC_BASE_URI}sensors/host/BootProgress
Michael Walsha6723f22016-11-22 11:12:01 -0600202 ... value quiet=${quiet}
Michael Walshc972d4d2017-08-16 15:38:03 -0500203
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600204 [Return] ${state}
Chris Austenb29d2e82016-06-07 12:25:35 -0500205
Steven Sombar0acb3412018-01-24 09:38:42 -0600206
Michael Walshc972d4d2017-08-16 15:38:03 -0500207New Get Boot Progress
208 [Documentation] Get the boot progress the new way (via xyz location).
209 [Arguments] ${quiet}=${QUIET}
210
211 # Description of argument(s):
212 # quiet Indicates whether this keyword should run without any output to
213 # the console.
214
215 ${state}= Read Attribute ${HOST_STATE_URI} BootProgress quiet=${quiet}
216
217 [Return] ${state.rsplit('.', 1)[1]}
218
Steven Sombar0acb3412018-01-24 09:38:42 -0600219
Chris Austenb29d2e82016-06-07 12:25:35 -0500220Is Power On
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500221 [Documentation] Verify that the BMC chassis state is on.
root442f0ef2016-08-04 20:23:05 +0000222 ${state}= Get Power State
223 Should be equal ${state} ${1}
Chris Austenb29d2e82016-06-07 12:25:35 -0500224
Steven Sombar0acb3412018-01-24 09:38:42 -0600225
Chris Austenb29d2e82016-06-07 12:25:35 -0500226Is Power Off
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500227 [Documentation] Verify that the BMC chassis state is off.
root442f0ef2016-08-04 20:23:05 +0000228 ${state}= Get Power State
229 Should be equal ${state} ${0}
Chris Austenb29d2e82016-06-07 12:25:35 -0500230
Steven Sombar0acb3412018-01-24 09:38:42 -0600231
root442f0ef2016-08-04 20:23:05 +0000232Initiate Power On
233 [Documentation] Initiates the power on and waits until the Is Power On
234 ... keyword returns that the power state has switched to on.
Michael Walsha6723f22016-11-22 11:12:01 -0600235 [Arguments] ${wait}=${1}
236
Steven Sombar0acb3412018-01-24 09:38:42 -0600237 # Description of argument(s):
238 # wait Indicates whether to wait for a powered on state after issuing
239 # the power on command.
240
Chris Austenb29d2e82016-06-07 12:25:35 -0500241 @{arglist}= Create List
242 ${args}= Create Dictionary data=@{arglist}
George Keishing85ca05e2016-11-30 09:47:18 -0600243 ${resp}= Call Method ${OPENBMC_BASE_URI}control/chassis0/ powerOn
Michael Walsha6723f22016-11-22 11:12:01 -0600244 ... data=${args}
Chris Austenb29d2e82016-06-07 12:25:35 -0500245 should be equal as strings ${resp.status_code} ${HTTP_OK}
Chris Austenb29d2e82016-06-07 12:25:35 -0500246
Michael Walsha6723f22016-11-22 11:12:01 -0600247 # Does caller want to wait for power on status?
248 Run Keyword If '${wait}' == '${0}' Return From Keyword
249 Wait Until Keyword Succeeds 3 min 10 sec Is Power On
Rahul Maheshwarif684ba72016-10-25 07:24:41 -0500250
Steven Sombar0acb3412018-01-24 09:38:42 -0600251
root442f0ef2016-08-04 20:23:05 +0000252Initiate Power Off
253 [Documentation] Initiates the power off and waits until the Is Power Off
254 ... keyword returns that the power state has switched to off.
Steven Sombar0acb3412018-01-24 09:38:42 -0600255
Chris Austenb29d2e82016-06-07 12:25:35 -0500256 @{arglist}= Create List
257 ${args}= Create Dictionary data=@{arglist}
George Keishing85ca05e2016-11-30 09:47:18 -0600258 ${resp}= Call Method ${OPENBMC_BASE_URI}control/chassis0/ powerOff
Michael Walsha6723f22016-11-22 11:12:01 -0600259 ... data=${args}
Chris Austenb29d2e82016-06-07 12:25:35 -0500260 should be equal as strings ${resp.status_code} ${HTTP_OK}
Michael Walsha6723f22016-11-22 11:12:01 -0600261 Wait Until Keyword Succeeds 1 min 10 sec Is Power Off
Chris Austenb29d2e82016-06-07 12:25:35 -0500262
Steven Sombar0acb3412018-01-24 09:38:42 -0600263
Michael Walsh81843772017-03-02 14:44:44 -0600264Initiate OS Host Power Off
265 [Documentation] Initiate an OS reboot.
266 [Arguments] ${os_host}=${OS_HOST} ${os_username}=${OS_USERNAME}
Michael Walshdfc75372018-01-11 11:47:25 -0600267 ... ${os_password}=${OS_PASSWORD} ${hard}=${0}
Michael Walsh81843772017-03-02 14:44:44 -0600268
Michael Walshdfc75372018-01-11 11:47:25 -0600269 # Description of argument(s):
Michael Walsh81843772017-03-02 14:44:44 -0600270 # os_host The DNS name or IP of the OS.
271 # os_username The username to be used to sign in to the OS.
272 # os_password The password to be used to sign in to the OS.
Michael Walshdfc75372018-01-11 11:47:25 -0600273 # hard Indicates whether to do a hard vs. soft power off.
274
275 ${time_string}= Run Keyword If ${hard} Set Variable ${SPACE}now
276 ... ELSE Set Variable ${EMPTY}
Michael Walsh81843772017-03-02 14:44:44 -0600277
Michael Walsh4549cd12017-09-07 18:02:36 -0500278 ${cmd_buf}= Run Keyword If '${os_username}' == 'root'
Michael Walshdfc75372018-01-11 11:47:25 -0600279 ... Set Variable shutdown${time_string}
Michael Walsh4549cd12017-09-07 18:02:36 -0500280 ... ELSE
Michael Walshdfc75372018-01-11 11:47:25 -0600281 ... Set Variable echo ${os_password} | sudo -S shutdown${time_string}
Michael Walsh4549cd12017-09-07 18:02:36 -0500282
283 ${output} ${stderr} ${rc}= OS Execute Command
284 ... ${cmd_buf} fork=${1}
Michael Walsh81843772017-03-02 14:44:44 -0600285
Steven Sombar0acb3412018-01-24 09:38:42 -0600286
Michael Walsh81843772017-03-02 14:44:44 -0600287Initiate OS Host Reboot
288 [Documentation] Initiate an OS reboot.
289 [Arguments] ${os_host}=${OS_HOST} ${os_username}=${OS_USERNAME}
290 ... ${os_password}=${OS_PASSWORD}
291
Michael Walshf1a59fb2017-09-01 17:07:13 -0500292 # Description of argument(s):
293 # os_host The host name or IP address of the OS.
Michael Walsh81843772017-03-02 14:44:44 -0600294 # os_username The username to be used to sign in to the OS.
295 # os_password The password to be used to sign in to the OS.
296
Michael Walshf1a59fb2017-09-01 17:07:13 -0500297 ${cmd_buf}= Run Keyword If '${os_username}' == 'root'
298 ... Set Variable reboot
299 ... ELSE
300 ... Set Variable echo ${os_password} | sudo -S reboot
301
302 ${output} ${stderr} ${rc}= OS Execute Command
303 ... ${cmd_buf} fork=${1}
Michael Walsh81843772017-03-02 14:44:44 -0600304
Steven Sombar0acb3412018-01-24 09:38:42 -0600305
Michael Walsh81843772017-03-02 14:44:44 -0600306Initiate Auto Reboot
307 [Documentation] Initiate an auto reboot.
Michael Walsh4ffd1a12018-03-14 10:35:44 -0500308 [Arguments] ${milliseconds}=5000
309
310 # Description of argument(s):
311 # milliseconds The number of milliseconds for the watchdog timer.
Michael Walsh81843772017-03-02 14:44:44 -0600312
313 # Set the auto reboot policy.
Sweta Potthuri62a23572017-07-28 04:05:13 -0500314 Set Auto Reboot ${1}
Michael Walsh4ffd1a12018-03-14 10:35:44 -0500315 # Set the watchdog timer.
316 Trigger Host Watchdog Error ${milliseconds}
Michael Walsh81843772017-03-02 14:44:44 -0600317
Steven Sombar0acb3412018-01-24 09:38:42 -0600318
Chris Austenb29d2e82016-06-07 12:25:35 -0500319Trigger Warm Reset
Steven Sombar0acb3412018-01-24 09:38:42 -0600320 [Documentation] Initiate a warm reset.
321
Chris Austenb29d2e82016-06-07 12:25:35 -0500322 log to console "Triggering warm reset"
Michael Walsha6723f22016-11-22 11:12:01 -0600323 ${data}= create dictionary data=@{EMPTY}
George Keishing85ca05e2016-11-30 09:47:18 -0600324 ${resp}= openbmc post request
325 ... ${OPENBMC_BASE_URI}control/bmc0/action/warmReset data=${data}
Chris Austenb29d2e82016-06-07 12:25:35 -0500326 Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
George Keishingb3700812016-08-31 03:03:30 -0500327 ${session_active}= Check If warmReset is Initiated
328 Run Keyword If '${session_active}' == '${True}'
329 ... Fail msg=warm reset didn't occur
330
Chris Austenb29d2e82016-06-07 12:25:35 -0500331 Sleep ${SYSTEM_SHUTDOWN_TIME}min
Rahul Maheshwari5f253c42017-01-30 05:19:51 -0600332 Check If BMC Is Up
Michael Walsh49ab0f42016-07-20 11:44:33 -0500333
Steven Sombar0acb3412018-01-24 09:38:42 -0600334
Michael Walsh49ab0f42016-07-20 11:44:33 -0500335Check OS
root442f0ef2016-08-04 20:23:05 +0000336 [Documentation] Attempts to ping the host OS and then checks that the host
337 ... OS is up by running an SSH command.
Michael Walsh49ab0f42016-07-20 11:44:33 -0500338
339 [Arguments] ${os_host}=${OS_HOST} ${os_username}=${OS_USERNAME}
Michael Walsha6723f22016-11-22 11:12:01 -0600340 ... ${os_password}=${OS_PASSWORD} ${quiet}=${QUIET}
341 ... ${print_string}=${EMPTY}
Michael Walshac275512017-03-07 11:39:28 -0600342 [Teardown] SSHLibrary.Close Connection
Michael Walsh49ab0f42016-07-20 11:44:33 -0500343
Steven Sombar0acb3412018-01-24 09:38:42 -0600344 # Description of argument(s):
Michael Walsh49ab0f42016-07-20 11:44:33 -0500345 # os_host The DNS name/IP of the OS host associated with our BMC.
346 # os_username The username to be used to sign on to the OS host.
347 # os_password The password to be used to sign on to the OS host.
Michael Walsha6723f22016-11-22 11:12:01 -0600348 # quiet Indicates whether this keyword should write to console.
349 # print_string A string to be printed before checking the OS.
350
351 rprint ${print_string}
Michael Walsh49ab0f42016-07-20 11:44:33 -0500352
root442f0ef2016-08-04 20:23:05 +0000353 # Attempt to ping the OS. Store the return code to check later.
354 ${ping_rc}= Run Keyword and Return Status Ping Host ${os_host}
355
Michael Walshac275512017-03-07 11:39:28 -0600356 SSHLibrary.Open connection ${os_host}
Michael Walsh49ab0f42016-07-20 11:44:33 -0500357
Michael Walsha6723f22016-11-22 11:12:01 -0600358 ${status} ${msg}= Run Keyword And Ignore Error Login ${os_username}
359 ... ${os_password}
360 ${err_msg1}= Sprint Error ${msg}
361 ${err_msg}= Catenate SEPARATOR= \n ${err_msg1}
362 Run Keyword If '${status}' == 'FAIL' Fail msg=${err_msg}
Michael Walsh49ab0f42016-07-20 11:44:33 -0500363 ${output} ${stderr} ${rc}= Execute Command uptime return_stderr=True
364 ... return_rc=True
365
Michael Walsha6723f22016-11-22 11:12:01 -0600366 ${temp_msg}= Catenate Could not execute a command on the operating
367 ... system.\n
368 ${err_msg1}= Sprint Error ${temp_msg}
369 ${err_msg}= Catenate SEPARATOR= \n ${err_msg1}
370
371 # If the return code returned by "Execute Command" is non-zero, this
372 # keyword will fail.
373 Should Be Equal ${rc} ${0} msg=${err_msg}
Michael Walsh49ab0f42016-07-20 11:44:33 -0500374 # We will likewise fail if there is any stderr data.
375 Should Be Empty ${stderr}
376
Michael Walsha6723f22016-11-22 11:12:01 -0600377 ${temp_msg}= Set Variable Could not ping the operating system.\n
378 ${err_msg1}= Sprint Error ${temp_msg}
379 ${err_msg}= Catenate SEPARATOR= \n ${err_msg1}
380 # We will likewise fail if the OS did not ping, as we could SSH but not
381 # ping
382 Should Be Equal As Strings ${ping_rc} ${TRUE} msg=${err_msg}
root442f0ef2016-08-04 20:23:05 +0000383
Steven Sombar0acb3412018-01-24 09:38:42 -0600384
Michael Walsh49ab0f42016-07-20 11:44:33 -0500385Wait for OS
386 [Documentation] Waits for the host OS to come up via calls to "Check OS".
387 [Arguments] ${os_host}=${OS_HOST} ${os_username}=${OS_USERNAME}
388 ... ${os_password}=${OS_PASSWORD} ${timeout}=${OS_WAIT_TIMEOUT}
Michael Walsha6723f22016-11-22 11:12:01 -0600389 ... ${quiet}=${0}
390 [Teardown] rprintn
Michael Walsh49ab0f42016-07-20 11:44:33 -0500391
Steven Sombar0acb3412018-01-24 09:38:42 -0600392 # Description of argument(s):
Michael Walsh49ab0f42016-07-20 11:44:33 -0500393 # os_host The DNS name or IP of the OS host associated with our
394 # BMC.
395 # os_username The username to be used to sign on to the OS host.
396 # os_password The password to be used to sign on to the OS host.
397 # timeout The timeout in seconds indicating how long you're
398 # willing to wait for the OS to respond.
Michael Walsha6723f22016-11-22 11:12:01 -0600399 # quiet Indicates whether this keyword should write to console.
Michael Walsh49ab0f42016-07-20 11:44:33 -0500400
401 # The interval to be used between calls to "Check OS".
402 ${interval}= Set Variable 5
403
Michael Walsha6723f22016-11-22 11:12:01 -0600404 ${message}= Catenate Checking every ${interval} seconds for up to
405 ... ${timeout} seconds for the operating system to communicate.
406 rqprint_timen ${message}
407
Michael Walsh49ab0f42016-07-20 11:44:33 -0500408 Wait Until Keyword Succeeds ${timeout} sec ${interval} Check OS
409 ... ${os_host} ${os_username} ${os_password}
Michael Walsha6723f22016-11-22 11:12:01 -0600410 ... print_string=\#
411
412 rqprintn
413
414 rqprint_timen The operating system is now communicating.
root442f0ef2016-08-04 20:23:05 +0000415
root442f0ef2016-08-04 20:23:05 +0000416
417Get Power State
418 [Documentation] Returns the power state as an integer. Either 0 or 1.
Michael Walsha6723f22016-11-22 11:12:01 -0600419 [Arguments] ${quiet}=${QUIET}
420
Steven Sombar0acb3412018-01-24 09:38:42 -0600421 # Description of argument(s):
422 # quiet Indicates whether this keyword should run without any output to
423 # the console.
424
root442f0ef2016-08-04 20:23:05 +0000425 @{arglist}= Create List
426 ${args}= Create Dictionary data=@{arglist}
Michael Walsha6723f22016-11-22 11:12:01 -0600427
George Keishing85ca05e2016-11-30 09:47:18 -0600428 ${resp}= Call Method ${OPENBMC_BASE_URI}control/chassis0/ getPowerState
Michael Walsha6723f22016-11-22 11:12:01 -0600429 ... data=${args} quiet=${quiet}
root442f0ef2016-08-04 20:23:05 +0000430 Should be equal as strings ${resp.status_code} ${HTTP_OK}
431 ${content}= to json ${resp.content}
Steven Sombar0acb3412018-01-24 09:38:42 -0600432
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600433 [Return] ${content["data"]}
Jay Azurine4c52eb2016-08-16 20:51:10 -0500434
George Keishinga8d68e22017-12-18 09:30:30 -0600435
436Clear BMC Gard Record
437 [Documentation] Clear gard records from the system.
438
439 @{arglist}= Create List
440 ${args}= Create Dictionary data=@{arglist}
George Keishing85ca05e2016-11-30 09:47:18 -0600441 ${resp}= Call Method
George Keishinga8d68e22017-12-18 09:30:30 -0600442 ... ${OPENPOWER_CONTROL}gard Reset data=${args}
443 Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
444
Jay Azurine4c52eb2016-08-16 20:51:10 -0500445
446Copy PNOR to BMC
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500447 [Documentation] Copy the PNOR image to the BMC.
Jay Azurine4c52eb2016-08-16 20:51:10 -0500448 Import Library SCPLibrary WITH NAME scp
449 Open Connection for SCP
450 Log Copying ${PNOR_IMAGE_PATH} to /tmp
451 scp.Put File ${PNOR_IMAGE_PATH} /tmp
452
Steven Sombar0acb3412018-01-24 09:38:42 -0600453
Jay Azurine4c52eb2016-08-16 20:51:10 -0500454Flash PNOR
455 [Documentation] Calls flash bios update method to flash PNOR image
Gunnar Mills38032802016-12-12 13:43:40 -0600456 [Arguments] ${pnor_image}
Steven Sombar0acb3412018-01-24 09:38:42 -0600457
458 # Description of argument(s):
459 # pnor_image The filename and path of the PNOR image
460 # (e.g. "/home/image/zaius.pnor").
461
Jay Azurine4c52eb2016-08-16 20:51:10 -0500462 @{arglist}= Create List ${pnor_image}
463 ${args}= Create Dictionary data=@{arglist}
George Keishinge24fdbc2017-10-31 13:41:35 -0500464 ${resp}= Call Method /org/openbmc/control/flash/bios/ update
Michael Walsha6723f22016-11-22 11:12:01 -0600465 ... data=${args}
Jay Azurine4c52eb2016-08-16 20:51:10 -0500466 should be equal as strings ${resp.status_code} ${HTTP_OK}
467 Wait Until Keyword Succeeds 2 min 10 sec Is PNOR Flashing
468
Steven Sombar0acb3412018-01-24 09:38:42 -0600469
Jay Azurine4c52eb2016-08-16 20:51:10 -0500470Get Flash BIOS Status
471 [Documentation] Returns the status of the flash BIOS API as a string. For
472 ... example 'Flashing', 'Flash Done', etc
George Keishinge24fdbc2017-10-31 13:41:35 -0500473 ${data}= Read Properties /org/openbmc/control/flash/bios
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600474 [Return] ${data['status']}
Jay Azurine4c52eb2016-08-16 20:51:10 -0500475
Steven Sombar0acb3412018-01-24 09:38:42 -0600476
Jay Azurine4c52eb2016-08-16 20:51:10 -0500477Is PNOR Flashing
478 [Documentation] Get BIOS 'Flashing' status. This indicates that PNOR
479 ... flashing has started.
480 ${status}= Get Flash BIOS Status
Rahul Maheshwari449dfb72017-05-08 02:06:48 -0500481 Should Contain ${status} Flashing
Jay Azurine4c52eb2016-08-16 20:51:10 -0500482
Steven Sombar0acb3412018-01-24 09:38:42 -0600483
Jay Azurine4c52eb2016-08-16 20:51:10 -0500484Is PNOR Flash Done
485 [Documentation] Get BIOS 'Flash Done' status. This indicates that the
486 ... PNOR flashing has completed.
Leah McNutt9ba32272016-11-17 15:48:39 +0000487 ${status}= Get Flash BIOS Status
Jay Azurine4c52eb2016-08-16 20:51:10 -0500488 should be equal as strings ${status} Flash Done
489
George Keishing5e870cd2016-08-24 10:05:47 -0500490
Rahul Maheshwari2c725042017-01-29 22:55:28 -0600491Is OS Starting
492 [Documentation] Check if boot progress is OS starting.
493 ${boot_progress}= Get Boot Progress
Michael Walsh01975fa2017-08-20 20:51:36 -0500494 Should Be Equal ${boot_progress} OSStart
Rahul Maheshwari2c725042017-01-29 22:55:28 -0600495
Steven Sombar0acb3412018-01-24 09:38:42 -0600496
George Keishing0af24412017-03-10 13:33:23 -0600497Is OS Off
498 [Documentation] Check if boot progress is "Off".
499 ${boot_progress}= Get Boot Progress
500 Should Be Equal ${boot_progress} Off
501
Steven Sombar0acb3412018-01-24 09:38:42 -0600502
Rahul Maheshwariffd30de2017-06-27 05:57:45 -0500503Get Boot Progress To OS Starting State
504 [Documentation] Get the system to a boot progress state of 'FW Progress,
505 ... Starting OS'.
506
507 ${boot_progress}= Get Boot Progress
Michael Walsh01975fa2017-08-20 20:51:36 -0500508 Run Keyword If '${boot_progress}' == 'OSStart'
Rahul Maheshwariffd30de2017-06-27 05:57:45 -0500509 ... Log Host is already in OS starting state
510 ... ELSE
511 ... Run Keywords Initiate Host PowerOff AND Initiate Host Boot
512 ... AND Wait Until Keyword Succeeds 10 min 10 sec Is OS Starting
513
Steven Sombar0acb3412018-01-24 09:38:42 -0600514
George Keishing5e870cd2016-08-24 10:05:47 -0500515Verify Ping and REST Authentication
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -0500516 [Documentation] Verify ping and rest authentication.
Michael Walsha6723f22016-11-22 11:12:01 -0600517 ${l_ping}= Run Keyword And Return Status
George Keishing5e870cd2016-08-24 10:05:47 -0500518 ... Ping Host ${OPENBMC_HOST}
George Keishingc4d3dc02016-09-19 03:45:55 -0500519 Run Keyword If '${l_ping}' == '${False}'
520 ... Fail msg=Ping Failed
George Keishing5e870cd2016-08-24 10:05:47 -0500521
Michael Walsha6723f22016-11-22 11:12:01 -0600522 ${l_rest}= Run Keyword And Return Status
George Keishing5e870cd2016-08-24 10:05:47 -0500523 ... Initialize OpenBMC
George Keishingc4d3dc02016-09-19 03:45:55 -0500524 Run Keyword If '${l_rest}' == '${False}'
525 ... Fail msg=REST Authentication Failed
George Keishing5e870cd2016-08-24 10:05:47 -0500526
527 # Just to make sure the SSH is working for SCP
528 Open Connection And Log In
529 ${system} ${stderr}= Execute Command hostname return_stderr=True
530 Should Be Empty ${stderr}
531
Steven Sombar0acb3412018-01-24 09:38:42 -0600532
George Keishingc4d3dc02016-09-19 03:45:55 -0500533Check If BMC is Up
534 [Documentation] Wait for Host to be online. Checks every X seconds
535 ... interval for Y minutes and fails if timed out.
536 ... Default MAX timedout is 10 min, interval 10 seconds.
Gunnar Mills38032802016-12-12 13:43:40 -0600537 [Arguments] ${max_timeout}=${OPENBMC_REBOOT_TIMEOUT} min
George Keishingc4d3dc02016-09-19 03:45:55 -0500538 ... ${interval}=10 sec
539
Steven Sombar0acb3412018-01-24 09:38:42 -0600540 # Description of argument(s):
541 # max_timeout Maximum time to wait.
542 # This should be expressed in Robot Framework's time format
543 # (e.g. "10 minutes").
544 # interfal Interval to wait between status checks.
545 # This should be expressed in Robot Framework's time format
546 # (e.g. "5 seconds").
547
George Keishingc4d3dc02016-09-19 03:45:55 -0500548 Wait Until Keyword Succeeds
549 ... ${max_timeout} ${interval} Verify Ping and REST Authentication
550
George Keishingb3700812016-08-31 03:03:30 -0500551
552Check If warmReset is Initiated
553 [Documentation] Ping would be still alive, so try SSH to connect
554 ... if fails the ports are down indicating reboot
555 ... is in progress
George Keishing3c05d352016-12-13 06:54:50 -0600556
557 # Warm reset adds 3 seconds delay before forcing reboot
558 # To minimize race conditions, we wait for 7 seconds
559 Sleep 7s
George Keishingb3700812016-08-31 03:03:30 -0500560 ${alive}= Run Keyword and Return Status
561 ... Open Connection And Log In
562 Return From Keyword If '${alive}' == '${False}' ${False}
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600563 [Return] ${True}
George Keishingb3700812016-08-31 03:03:30 -0500564
Steven Sombar0acb3412018-01-24 09:38:42 -0600565
George Keishing06ae4aa2016-08-30 01:41:28 -0500566Flush REST Sessions
567 [Documentation] Removes all the active session objects
568 Delete All Sessions
George Keishingb3700812016-08-31 03:03:30 -0500569
Steven Sombar0acb3412018-01-24 09:38:42 -0600570
Sivas SRRe1143ae2016-08-26 22:31:02 -0500571Initialize DBUS cmd
572 [Documentation] Initialize dbus string with property string to extract
Gunnar Mills38032802016-12-12 13:43:40 -0600573 [Arguments] ${boot_property}
Steven Sombar0acb3412018-01-24 09:38:42 -0600574
575 # Description of argument(s):
576 # boot_property Property string.
577
Michael Walsha6723f22016-11-22 11:12:01 -0600578 ${cmd}= Catenate ${dbuscmdBase} ${dbuscmdGet} ${dbuscmdString}
579 ${cmd}= Catenate ${cmd}${boot_property}
Sivas SRRe1143ae2016-08-26 22:31:02 -0500580 Set Global Variable ${dbuscmd} ${cmd}
581
Steven Sombar0acb3412018-01-24 09:38:42 -0600582
David Shawba2d2c22017-01-23 16:56:38 -0600583Create OS Console File Path
584 [Documentation] Create OS console file path name and return it.
585 [Arguments] ${log_file_path}=${EMPTY}
George Keishing30c12ff2016-09-02 10:25:29 -0500586
Gunnar Mills28e403b2017-10-25 16:16:38 -0500587 # Description of arguments:
David Shawba2d2c22017-01-23 16:56:38 -0600588 # file_path The caller's candidate value. If this value is ${EMPTY}, this
589 # keyword will compose a file path name. Otherwise, this
590 # keyword will use the caller's file_path value. In either
591 # case, the value will be returned.
Gunnar Mills9c760342016-12-08 10:12:06 -0600592
Charles Paul Hofer92a4f452018-06-14 14:48:32 -0500593 ${status}= Run Keyword And Return Status Variable Should Exist ${TEST_NAME}
594
595 ${default_file_path}= Set Variable If ${status} == ${TRUE}
596 ... /tmp/${OPENBMC_HOST}_${TEST_NAME.replace(' ', '')}_os_console.txt
597 ... /tmp/${OPENBMC_HOST}_os_console.txt
598
David Shawba2d2c22017-01-23 16:56:38 -0600599 ${log_file_path}= Set Variable If '${log_file_path}' == '${EMPTY}'
600 ... ${default_file_path} ${log_file_path}
Michael Walsh01bd3682017-01-10 11:21:05 -0600601
David Shawba2d2c22017-01-23 16:56:38 -0600602 [Return] ${log_file_path}
Gunnar Mills9c760342016-12-08 10:12:06 -0600603
Steven Sombar0acb3412018-01-24 09:38:42 -0600604
David Shawba2d2c22017-01-23 16:56:38 -0600605Create OS Console Command String
606 [Documentation] Return a command string to start OS console logging.
Gunnar Mills9c760342016-12-08 10:12:06 -0600607
David Shawba2d2c22017-01-23 16:56:38 -0600608 # First make sure that the ssh_pw program is available.
Steven Sombar0acb3412018-01-24 09:38:42 -0600609 ${cmd}= Catenate which ssh_pw 2>/dev/null || find
610 ... ${EXECDIR} -name 'ssh_pw'
611
612 Rdpissuing ${cmd}
613 ${rc} ${output}= Run And Return Rc And Output ${cmd}
David Shawba2d2c22017-01-23 16:56:38 -0600614 Rdpvars rc output
Gunnar Mills9c760342016-12-08 10:12:06 -0600615
Michael Walsh98d8c9e2017-10-04 12:24:29 -0500616 Should Be Equal As Integers 0 ${rc} msg=Could not find ssh_pw.
617
618 ${ssh_pw_file_path}= Set Variable ${output}
George Keishingb45d9522017-06-29 04:20:59 -0500619
Steven Sombar0acb3412018-01-24 09:38:42 -0600620 ${cmd}= Catenate ${ssh_pw_file_path} ${OPENBMC_PASSWORD} -p 2200
George Keishing1f9ec7f2017-06-06 08:59:19 -0500621 ... -o "StrictHostKeyChecking no" ${OPENBMC_USERNAME}@${OPENBMC_HOST}
George Keishing30c12ff2016-09-02 10:25:29 -0500622
Steven Sombar0acb3412018-01-24 09:38:42 -0600623 [Return] ${cmd}
624
George Keishing30c12ff2016-09-02 10:25:29 -0500625
Michael Walshcadf1342017-08-28 13:49:25 -0500626Get SOL Console Pid
Michael Walsh70419172017-12-06 14:20:52 -0600627 [Documentation] Get the pid of the active SOL console job.
628 [Arguments] ${expect_running}=${0}
629
630 # Description of argument(s):
631 # expect_running If set and if no SOL console job is found, print debug
632 # info and fail.
Michael Walshcadf1342017-08-28 13:49:25 -0500633
634 # Find the pid of the active system console logging session (if any).
635 ${search_string}= Create OS Console Command String
636 # At least in some cases, ps output does not show double quotes so we must
637 # replace them in our search string with the regexes to indicate that they
638 # are optional.
639 ${search_string}= Replace String ${search_string} " ["]?
Michael Walsh70419172017-12-06 14:20:52 -0600640 ${ps_cmd}= Catenate ps axwwo user,pid,cmd
641 ${cmd_buf}= Catenate echo $(${ps_cmd} | egrep '${search_string}' |
642 ... egrep -v grep | cut -c10-14)
Michael Walshcadf1342017-08-28 13:49:25 -0500643 Rdpissuing ${cmd_buf}
644 ${rc} ${os_con_pid}= Run And Return Rc And Output ${cmd_buf}
645 Rdpvars os_con_pid
646 # If rc is not zero it just means that there is no OS Console process
647 # running.
648
Michael Walsh70419172017-12-06 14:20:52 -0600649 Return From Keyword If '${os_con_pid}' != '${EMPTY}' ${os_con_pid}
650 Return From Keyword If '${expect_running}' == '${0}' ${os_con_pid}
651
652 Cmd Fnc cat ${log_file_path} ; echo ; ${ps_cmd} quiet=${0}
653 ... print_output=${1} show_err=${1}
654
655 Should Not Be Empty ${os_con_pid}
Michael Walshcadf1342017-08-28 13:49:25 -0500656
657
George Keishing30c12ff2016-09-02 10:25:29 -0500658Stop SOL Console Logging
David Shawba2d2c22017-01-23 16:56:38 -0600659 [Documentation] Stop system console logging and return log output.
George Keishing72992e42017-06-16 06:42:36 -0500660 [Arguments] ${log_file_path}=${EMPTY}
661 ... ${targ_file_path}=${EXECDIR}${/}logs${/}
Michael Walsh5f3f4142017-05-22 17:09:47 -0500662 ... ${return_data}=${1}
David Shawba2d2c22017-01-23 16:56:38 -0600663
664 # If there are muliple system console processes, they will all be stopped.
665 # If there is no existing log file this keyword will return an error
666 # message to that effect (and write that message to targ_file_path, if
667 # specified).
668 # NOTE: This keyword will not fail if there is no running system console
669 # process.
Michael Walsh01bd3682017-01-10 11:21:05 -0600670
671 # Description of arguments:
David Shawba2d2c22017-01-23 16:56:38 -0600672 # log_file_path The file path that was used to call "Start SOL
673 # Console Logging". See that keyword (above) for details.
674 # targ_file_path If specified, the file path to which the source
675 # file path (i.e. "log_file_path") should be copied.
Michael Walsh5f3f4142017-05-22 17:09:47 -0500676 # return_data If this is set to ${1}, this keyword will return the SOL
677 # data to the caller as a unicode string.
George Keishing30c12ff2016-09-02 10:25:29 -0500678
David Shawba2d2c22017-01-23 16:56:38 -0600679 ${log_file_path}= Create OS Console File Path ${log_file_path}
Michael Walshcadf1342017-08-28 13:49:25 -0500680
681 ${os_con_pid}= Get SOL Console Pid
George Keishing30c12ff2016-09-02 10:25:29 -0500682
David Shawba2d2c22017-01-23 16:56:38 -0600683 ${cmd_buf}= Catenate kill -9 ${os_con_pid}
684 Run Keyword If '${os_con_pid}' != '${EMPTY}' Rdpissuing ${cmd_buf}
685 ${rc} ${output}= Run Keyword If '${os_con_pid}' != '${EMPTY}'
686 ... Run And Return Rc And Output ${cmd_buf}
687 Run Keyword If '${os_con_pid}' != '${EMPTY}' Rdpvars rc output
George Keishing30c12ff2016-09-02 10:25:29 -0500688
Michael Walsh01bd3682017-01-10 11:21:05 -0600689 Run Keyword If '${targ_file_path}' != '${EMPTY}'
David Shawba2d2c22017-01-23 16:56:38 -0600690 ... Run Keyword And Ignore Error
691 ... Copy File ${log_file_path} ${targ_file_path}
George Keishing30c12ff2016-09-02 10:25:29 -0500692
Michael Walsh5f3f4142017-05-22 17:09:47 -0500693 ${output}= Set Variable ${EMPTY}
694 ${loc_quiet}= Evaluate ${debug}^1
695 ${rc} ${output}= Run Keyword If '${return_data}' == '${1}'
Michael Walsh98d8c9e2017-10-04 12:24:29 -0500696 ... Cmd Fnc cat ${log_file_path} 2>/dev/null quiet=${loc_quiet}
697 ... print_output=${0} show_err=${0}
Michael Walsh5f3f4142017-05-22 17:09:47 -0500698
David Shawba2d2c22017-01-23 16:56:38 -0600699 [Return] ${output}
700
Steven Sombar0acb3412018-01-24 09:38:42 -0600701
David Shawba2d2c22017-01-23 16:56:38 -0600702Start SOL Console Logging
703 [Documentation] Start system console log to file.
Michael Walsh5f3f4142017-05-22 17:09:47 -0500704 [Arguments] ${log_file_path}=${EMPTY} ${return_data}=${1}
David Shawba2d2c22017-01-23 16:56:38 -0600705
706 # This keyword will first call "Stop SOL Console Logging". Only then will
707 # it start SOL console logging. The data returned by "Stop SOL Console
708 # Logging" will in turn be returned by this keyword.
709
710 # Description of arguments:
Michael Walsh5f3f4142017-05-22 17:09:47 -0500711 # log_file_path The file path to which system console log data should be
712 # written. Note that this path is taken to be a location
713 # on the machine where this program is running rather than
714 # on the Open BMC system.
715 # return_data If this is set to ${1}, this keyword will return any SOL
716 # data to the caller as a unicode string.
David Shawba2d2c22017-01-23 16:56:38 -0600717
718 ${log_file_path}= Create OS Console File Path ${log_file_path}
719
720 ${log_output}= Stop SOL Console Logging ${log_file_path}
Michael Walsh5f3f4142017-05-22 17:09:47 -0500721 ... return_data=${return_data}
David Shawba2d2c22017-01-23 16:56:38 -0600722
723 # Validate by making sure we can create the file. Problems creating the
724 # file would not be noticed by the subsequent ssh command because we fork
725 # the command.
726 Create File ${log_file_path}
727 ${sub_cmd_buf}= Create OS Console Command String
728 # Routing stderr to stdout so that any startup error text will go to the
729 # output file.
George Keishing8c3c1df2017-09-13 13:50:20 -0500730 # TODO: Doesn't work with tox so reverting temporarily.
Michael Walsh460042e2017-09-05 16:55:49 -0500731 # nohup detaches the process completely from our pty.
George Keishing8c3c1df2017-09-13 13:50:20 -0500732 #${cmd_buf}= Catenate nohup ${sub_cmd_buf} &> ${log_file_path} &
733 ${cmd_buf}= Catenate ${sub_cmd_buf} > ${log_file_path} 2>&1 &
David Shawba2d2c22017-01-23 16:56:38 -0600734 Rdpissuing ${cmd_buf}
735 ${rc} ${output}= Run And Return Rc And Output ${cmd_buf}
736 # Because we are forking this command, we essentially will never get a
737 # non-zero return code or any output.
738 Should Be Equal ${rc} ${0}
739
Michael Walsh70419172017-12-06 14:20:52 -0600740 Wait Until Keyword Succeeds 10 seconds 0 seconds
741 ... Get SOL Console Pid ${1}
Michael Walshcadf1342017-08-28 13:49:25 -0500742
David Shawba2d2c22017-01-23 16:56:38 -0600743 [Return] ${log_output}
George Keishing30c12ff2016-09-02 10:25:29 -0500744
Michael Walsh70419172017-12-06 14:20:52 -0600745
George Keishing30c12ff2016-09-02 10:25:29 -0500746Get Time Stamp
747 [Documentation] Get the current time stamp data
748 ${cur_time}= Get Current Date result_format=%Y%m%d%H%M%S%f
Sridevi Rameshb96a0c32016-10-19 05:09:52 -0500749 [Return] ${cur_time}
George Keishing30c12ff2016-09-02 10:25:29 -0500750
George Keishing1b150202016-09-29 08:51:58 -0500751
Rahul Maheshwarif684ba72016-10-25 07:24:41 -0500752Start Journal Log
753 [Documentation] Start capturing journal log to a file in /tmp using
754 ... journalctl command. By default journal log is collected
755 ... at /tmp/journal_log else user input location.
756 ... The File is appended with datetime.
757 [Arguments] ${file_path}=/tmp/journal_log
758
Steven Sombar0acb3412018-01-24 09:38:42 -0600759 # Description of arguments:
760 # file_path The file path of the journal file.
Rahul Maheshwarif684ba72016-10-25 07:24:41 -0500761
762 ${cur_time}= Get Time Stamp
763 Set Global Variable ${LOG_TIME} ${cur_time}
764 Start Command
765 ... journalctl -f > ${file_path}-${LOG_TIME}
766 Log Journal Log Started: ${file_path}-${LOG_TIME}
767
David Shawba2d2c22017-01-23 16:56:38 -0600768
Rahul Maheshwarif684ba72016-10-25 07:24:41 -0500769Stop Journal Log
770 [Documentation] Stop journalctl process if its running.
771 ... By default return log from /tmp/journal_log else
772 ... user input location.
773 [Arguments] ${file_path}=/tmp/journal_log
774
Steven Sombar0acb3412018-01-24 09:38:42 -0600775 # Description of arguments:
776 # file_path The file path of the journal file.
777
Rahul Maheshwarif684ba72016-10-25 07:24:41 -0500778 Open Connection And Log In
779
780 ${rc}=
781 ... Execute Command
782 ... ps ax | grep journalctl | grep -v grep
783 ... return_stdout=False return_rc=True
784
785 Return From Keyword If '${rc}' == '${1}'
786 ... No journal log process running
787
788 ${output} ${stderr}=
789 ... Execute Command killall journalctl
790 ... return_stderr=True
791 Should Be Empty ${stderr}
792
793 ${journal_log} ${stderr}=
794 ... Execute Command
795 ... cat ${file_path}-${LOG_TIME}
796 ... return_stderr=True
797 Should Be Empty ${stderr}
798
799 Log ${journal_log}
800
801 Execute Command rm ${file_path}-${LOG_TIME}
802
803 [Return] ${journal_log}
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500804
Steven Sombar0acb3412018-01-24 09:38:42 -0600805
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500806Mac Address To Hex String
807 [Documentation] Converts MAC address into hex format.
808 ... Example
809 ... Given the following MAC: 00:01:6C:80:02:78
810 ... This keyword will return: 0x00 0x01 0x6C 0x80 0x02 0x78
811 ... Description of arguments:
Michael Walsh01bd3682017-01-10 11:21:05 -0600812 ... i_macaddress MAC address in the following format
813 ... 00:01:6C:80:02:78
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500814 [Arguments] ${i_macaddress}
815
Steven Sombar0acb3412018-01-24 09:38:42 -0600816 # Description of arguments:
817 # i_macaddress The MAC address.
818
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500819 ${mac_hex}= Catenate 0x${i_macaddress.replace(':', ' 0x')}
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600820 [Return] ${mac_hex}
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500821
Steven Sombar0acb3412018-01-24 09:38:42 -0600822
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500823IP Address To Hex String
824 [Documentation] Converts IP address into hex format.
825 ... Example:
826 ... Given the following IP: 10.3.164.100
827 ... This keyword will return: 0xa 0x3 0xa4 0xa0
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500828 [Arguments] ${i_ipaddress}
829
Steven Sombar0acb3412018-01-24 09:38:42 -0600830 # Description of arguments:
831 # i_macaddress The IP address in the format 10.10.10.10.
832
Rahul Maheshwari757d80c2016-10-17 01:09:55 -0500833 @{ip}= Split String ${i_ipaddress} .
834 ${index}= Set Variable ${0}
835
836 :FOR ${item} IN @{ip}
837 \ ${hex}= Convert To Hex ${item} prefix=0x lowercase=yes
838 \ Set List Value ${ip} ${index} ${hex}
839 \ ${index}= Set Variable ${index + 1}
840 ${ip_hex}= Catenate @{ip}
Steven Sombar0acb3412018-01-24 09:38:42 -0600841
Gunnar Millsc9ea9362016-12-13 16:21:13 -0600842 [Return] ${ip_hex}
Sivas SRRea85d1f2016-11-13 22:44:28 -0600843
Steven Sombar0acb3412018-01-24 09:38:42 -0600844
Sivas SRRea85d1f2016-11-13 22:44:28 -0600845BMC CPU Performance Check
846 [Documentation] Minimal 10% of proc should be free in this instance
847
Sivas SRRa13eb202017-11-03 10:01:56 -0500848 ${bmc_cpu_usage_output} ${stderr} ${rc}= BMC Execute Command
849 ... ${bmc_cpu_usage_cmd}
Sivas SRR5ff4d692017-11-23 02:53:52 -0600850 ${bmc_cpu_usage_output} ${stderr} ${rc}= BMC Execute Command
851 ... ${bmc_cpu_usage_cmd}
Sivas SRRea85d1f2016-11-13 22:44:28 -0600852 ${bmc_cpu_percentage}= Fetch From Left ${bmc_cpu_usage_output} %
853 Should be true ${bmc_cpu_percentage} < 90
854
Steven Sombar0acb3412018-01-24 09:38:42 -0600855
Sivas SRRea85d1f2016-11-13 22:44:28 -0600856BMC Mem Performance Check
857 [Documentation] Minimal 10% of memory should be free in this instance
858
Sivas SRRa13eb202017-11-03 10:01:56 -0500859 ${bmc_mem_free_output} ${stderr} ${rc}= BMC Execute Command
860 ... ${bmc_mem_free_cmd}
Sivas SRRea85d1f2016-11-13 22:44:28 -0600861
Sivas SRRa13eb202017-11-03 10:01:56 -0500862 ${bmc_mem_total_output} ${stderr} ${rc}= BMC Execute Command
863 ... ${bmc_mem_total_cmd}
Sivas SRR5ff4d692017-11-23 02:53:52 -0600864 ${bmc_mem_free_output} ${stderr} ${rc}= BMC Execute Command
865 ... ${bmc_mem_free_cmd}
Sivas SRRea85d1f2016-11-13 22:44:28 -0600866
Sivas SRR5ff4d692017-11-23 02:53:52 -0600867 ${bmc_mem_total_output} ${stderr} ${rc}= BMC Execute Command
868 ... ${bmc_mem_total_cmd}
869
870 ${bmc_mem_percentage}= Evaluate ${bmc_mem_free_output}*100
Sivas SRRea85d1f2016-11-13 22:44:28 -0600871 ${bmc_mem_percentage}= Evaluate
872 ... ${bmc_mem_percentage}/${bmc_mem_total_output}
873 Should be true ${bmc_mem_percentage} > 10
874
Steven Sombar0acb3412018-01-24 09:38:42 -0600875
Sivas SRRaca55712016-12-21 04:32:35 -0600876BMC File System Usage Check
Sivas SRRc0957412017-10-06 13:02:08 -0500877 [Documentation] Check the file system space. 4 file system should be
878 ... 100% full which is expected
Steven Sombar0acb3412018-01-24 09:38:42 -0600879 # Filesystem Size Used Available Use% Mounted on
880 # /dev/root 14.4M 14.4M 0 100% /
881 # /dev/ubiblock0_0 14.4M 14.4M 0 100% /media/rofs-c9249b0e
882 # /dev/ubiblock8_0 19.6M 19.6M 0 100% /media/pnor-ro-8764baa3
883 # /dev/ubiblock4_0 14.4M 14.4M 0 100% /media/rofs-407816c
884 # /dev/ubiblock8_4 21.1M 21.1M 0 100% /media/pnor-ro-cecc64c4
Sivas SRR5ff4d692017-11-23 02:53:52 -0600885 ${bmc_fs_usage_output} ${stderr} ${rc}= BMC Execute Command
886 ... ${bmc_file_system_usage_cmd}
887 ${bmc_pnor_fs_usage_output} ${stderr} ${rc}= BMC Execute Command
888 ... ${total_pnor_ro_file_system_cmd}
889 ${bmc_bmc_fs_usage_output} ${stderr} ${rc}= BMC Execute Command
890 ... ${total_bmc_ro_file_system_cmd}
891 ${total_bmc_pnor_image}= Evaluate
892 ... ${bmc_pnor_fs_usage_output}+${bmc_bmc_fs_usage_output}
893 # Considering /dev/root also in total 100% used file system
894 ${total_full_fs}= Evaluate ${total_bmc_pnor_image}+1
895 Should Be True ${bmc_fs_usage_output}==${total_full_fs}
Sivas SRRaca55712016-12-21 04:32:35 -0600896
Steven Sombar0acb3412018-01-24 09:38:42 -0600897
Sivas SRRea85d1f2016-11-13 22:44:28 -0600898Check BMC CPU Performance
899 [Documentation] Minimal 10% of proc should be free in 3 sample
900 :FOR ${var} IN Range 1 4
901 \ BMC CPU Performance check
902
Steven Sombar0acb3412018-01-24 09:38:42 -0600903
Sivas SRRea85d1f2016-11-13 22:44:28 -0600904Check BMC Mem Performance
905 [Documentation] Minimal 10% of memory should be free
906
907 :FOR ${var} IN Range 1 4
908 \ BMC Mem Performance check
909
Steven Sombar0acb3412018-01-24 09:38:42 -0600910
Sivas SRRaca55712016-12-21 04:32:35 -0600911Check BMC File System Performance
912 [Documentation] Check for file system usage for 4 times
913
914 :FOR ${var} IN Range 1 4
915 \ BMC File System Usage check
916
Steven Sombar0acb3412018-01-24 09:38:42 -0600917
Rahul Maheshwari63c105b2017-05-12 05:13:52 -0500918Get URL List
919 [Documentation] Return list of URLs under given URL.
920 [Arguments] ${openbmc_url}
Steven Sombar0acb3412018-01-24 09:38:42 -0600921
Rahul Maheshwari63c105b2017-05-12 05:13:52 -0500922 # Description of argument(s):
Michael Walsh5f3f4142017-05-22 17:09:47 -0500923 # openbmc_url URL for list operation (e.g.
924 # /xyz/openbmc_project/inventory).
Rahul Maheshwari63c105b2017-05-12 05:13:52 -0500925
George Keishing335f5362017-06-30 15:11:20 -0500926 ${url_list}= Read Properties ${openbmc_url}/list quiet=${1}
George Keishing184a89a2017-06-27 07:12:16 -0500927 Sort List ${url_list}
Steven Sombar0acb3412018-01-24 09:38:42 -0600928
Rahul Maheshwari63c105b2017-05-12 05:13:52 -0500929 [Return] ${url_list}
930
Steven Sombar0acb3412018-01-24 09:38:42 -0600931
Rahul Maheshwari9a8d3b12016-12-05 04:06:16 -0600932Get Endpoint Paths
933 [Documentation] Returns all url paths ending with given endpoint
934 ... Example:
935 ... Given the following endpoint: cpu
Michael Walsh01bd3682017-01-10 11:21:05 -0600936 ... This keyword will return: list of all urls ending with
937 ... cpu -
Rahul Maheshwari9a8d3b12016-12-05 04:06:16 -0600938 ... /org/openbmc/inventory/system/chassis/motherboard/cpu0,
939 ... /org/openbmc/inventory/system/chassis/motherboard/cpu1
Rahul Maheshwari9a8d3b12016-12-05 04:06:16 -0600940 [Arguments] ${path} ${endpoint}
941
Steven Sombar0acb3412018-01-24 09:38:42 -0600942 # Description of arguments:
943 # path URL path for enumeration.
944 # endpoint Endpoint string (url path ending).
945
George Keishingc7b161b2017-12-01 09:58:12 -0600946 ${resp}= Read Properties ${path}/enumerate timeout=30
947 Log Dictionary ${resp}
Rahul Maheshwari9a8d3b12016-12-05 04:06:16 -0600948
George Keishingc7b161b2017-12-01 09:58:12 -0600949 ${list}= Get Dictionary Keys ${resp}
950 # For a given string, look for prefix and suffix for matching expression.
951 # Start of string followed by zero or more of any character followed by
952 # any digit or lower case character.
953 ${resp}= Get Matches ${list} regexp=^.*[0-9a-z_].${endpoint}[0-9a-z]*$
Steven Sombar0acb3412018-01-24 09:38:42 -0600954
George Keishingc7b161b2017-12-01 09:58:12 -0600955 [Return] ${resp}
Sridevi Rameshb96a0c32016-10-19 05:09:52 -0500956
Steven Sombar0acb3412018-01-24 09:38:42 -0600957
Sridevi Rameshb96a0c32016-10-19 05:09:52 -0500958Check Zombie Process
959 [Documentation] Check if any defunct process exist or not on BMC
Michael Walsh01bd3682017-01-10 11:21:05 -0600960 ${count} ${stderr} ${rc}= Execute Command ps -o stat | grep Z | wc -l
Sridevi Rameshb96a0c32016-10-19 05:09:52 -0500961 ... return_stderr=True return_rc=True
962 Should Be True ${count}==0
963 Should Be Empty ${stderr}
George Keishing5327d012016-12-08 08:43:29 -0600964
Steven Sombar0acb3412018-01-24 09:38:42 -0600965
George Keishing5327d012016-12-08 08:43:29 -0600966Prune Journal Log
967 [Documentation] Prune archived journal logs.
968 [Arguments] ${vacuum_size}=1M
969
970 # This keyword can be used to prevent the journal
971 # log from filling up the /run filesystem.
972 # This command will retain only the latest logs
973 # of the user specified size.
974
Steven Sombar0acb3412018-01-24 09:38:42 -0600975 # Description of argument(s):
976 # vacuum_size Size of journal.
977
George Keishing5327d012016-12-08 08:43:29 -0600978 Open Connection And Log In
979 ${output} ${stderr} ${rc}=
980 ... Execute Command
981 ... journalctl --vacuum-size=${vacuum_size}
982 ... return_stderr=True return_rc=True
983
984 Should Be Equal ${rc} ${0} msg=${stderr}
Sridevi Ramesh1699d372016-12-06 00:20:22 -0600985
Steven Sombar0acb3412018-01-24 09:38:42 -0600986
Sridevi Ramesh1699d372016-12-06 00:20:22 -0600987Set BMC Power Policy
988 [Documentation] Set the given BMC power policy.
Michael Walshfdc5ced2017-08-17 13:15:15 -0500989 [Arguments] ${policy}
990
991 # Note that this function will translate the old style "RESTORE_LAST_STATE"
992 # policy to the new style "xyz.openbmc_project.Control.Power.RestorePolicy.
993 # Policy.Restore" for you.
Sridevi Ramesh1699d372016-12-06 00:20:22 -0600994
George Keishing1c3a9662017-08-11 10:16:36 -0500995 # Description of argument(s):
Michael Walshfdc5ced2017-08-17 13:15:15 -0500996 # policy Power restore policy (e.g "RESTORE_LAST_STATE",
997 # ${RESTORE_LAST_STATE}).
998
999 # Set the bmc_power_policy_method to either 'Old' or 'New'.
1000 Set Power Policy Method
1001 # This translation helps bridge between old and new method for calling.
1002 ${policy}= Translate Power Policy Value ${policy}
1003 # Run the appropriate keyword.
1004 Run Key ${bmc_power_policy_method} Set Power Policy \ ${policy}
1005 ${currentPolicy}= Get System Power Policy
1006 Should Be Equal ${currentPolicy} ${policy}
1007
Steven Sombar0acb3412018-01-24 09:38:42 -06001008
Michael Walshfdc5ced2017-08-17 13:15:15 -05001009New Set Power Policy
1010 [Documentation] Set the given BMC power policy (new method).
1011 [Arguments] ${policy}
1012
1013 # Description of argument(s):
George Keishingefc3ff22017-12-12 11:49:25 -06001014 # policy Power restore policy (e.g. ${ALWAYS_POWER_OFF}).
George Keishing1c3a9662017-08-11 10:16:36 -05001015
1016 ${valueDict}= Create Dictionary data=${policy}
1017 Write Attribute
Michael Walshfdc5ced2017-08-17 13:15:15 -05001018 ... ${POWER_RESTORE_URI} PowerRestorePolicy data=${valueDict}
1019
Steven Sombar0acb3412018-01-24 09:38:42 -06001020
Michael Walshfdc5ced2017-08-17 13:15:15 -05001021Old Set Power Policy
1022 [Documentation] Set the given BMC power policy (old method).
1023 [Arguments] ${policy}
1024
1025 # Description of argument(s):
George Keishingefc3ff22017-12-12 11:49:25 -06001026 # policy Power restore policy (e.g. "ALWAYS_POWER_OFF").
Michael Walshfdc5ced2017-08-17 13:15:15 -05001027
1028 ${valueDict}= create dictionary data=${policy}
1029 Write Attribute ${HOST_SETTING} power_policy data=${valueDict}
George Keishingcce9df22017-01-24 06:19:33 -06001030
Steven Sombar0acb3412018-01-24 09:38:42 -06001031
George Keishing4d6f3d62017-02-06 09:50:41 -06001032Get System Power Policy
Steven Sombar0acb3412018-01-24 09:38:42 -06001033 [Documentation] Returns the BMC power policy.
Michael Walshfdc5ced2017-08-17 13:15:15 -05001034
1035 # Set the bmc_power_policy_method to either 'Old' or 'New'.
1036 Set Power Policy Method
1037 ${cmd_buf}= Create List ${bmc_power_policy_method} Get Power Policy
1038 # Run the appropriate keyword.
1039 ${currentPolicy}= Run Keyword @{cmd_buf}
Steven Sombar0acb3412018-01-24 09:38:42 -06001040
Michael Walshfdc5ced2017-08-17 13:15:15 -05001041 [Return] ${currentPolicy}
1042
Steven Sombar0acb3412018-01-24 09:38:42 -06001043
Michael Walshfdc5ced2017-08-17 13:15:15 -05001044New Get Power Policy
Steven Sombar0acb3412018-01-24 09:38:42 -06001045 [Documentation] Returns the BMC power policy (new method).
George Keishing1c3a9662017-08-11 10:16:36 -05001046 ${currentPolicy}= Read Attribute ${POWER_RESTORE_URI} PowerRestorePolicy
Steven Sombar0acb3412018-01-24 09:38:42 -06001047
George Keishing4d6f3d62017-02-06 09:50:41 -06001048 [Return] ${currentPolicy}
George Keishingcce9df22017-01-24 06:19:33 -06001049
Steven Sombar0acb3412018-01-24 09:38:42 -06001050
Michael Walshfdc5ced2017-08-17 13:15:15 -05001051Old Get Power Policy
Steven Sombar0acb3412018-01-24 09:38:42 -06001052 [Documentation] Returns the BMC power policy (old method).
Michael Walshfdc5ced2017-08-17 13:15:15 -05001053 ${currentPolicy}= Read Attribute ${HOST_SETTING} power_policy
Steven Sombar0acb3412018-01-24 09:38:42 -06001054
Michael Walshfdc5ced2017-08-17 13:15:15 -05001055 [Return] ${currentPolicy}
1056
Steven Sombar0acb3412018-01-24 09:38:42 -06001057
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001058Get Auto Reboot
1059 [Documentation] Returns auto reboot setting.
Sweta Potthuri62a23572017-07-28 04:05:13 -05001060 ${setting}= Read Attribute ${CONTROL_HOST_URI}/auto_reboot AutoReboot
Steven Sombar0acb3412018-01-24 09:38:42 -06001061
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001062 [Return] ${setting}
1063
Steven Sombar0acb3412018-01-24 09:38:42 -06001064
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001065Set Auto Reboot
1066 [Documentation] Set the given auto reboot setting.
1067 [Arguments] ${setting}
Steven Sombar0acb3412018-01-24 09:38:42 -06001068
1069 # Description of argument(s):
1070 # setting The reboot setting, 1 for enabling and 0 for disabling.
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001071
1072 ${valueDict}= Set Variable ${setting}
1073 ${data}= Create Dictionary data=${valueDict}
Sweta Potthuri62a23572017-07-28 04:05:13 -05001074 Write Attribute ${CONTROL_HOST_URI}/auto_reboot AutoReboot data=${data}
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001075 ${current_setting}= Get Auto Reboot
Sweta Potthuri62a23572017-07-28 04:05:13 -05001076 Should Be Equal As Integers ${current_setting} ${setting}
Rahul Maheshwari1cbf0042017-02-13 05:17:37 -06001077
1078
George Keishingcce9df22017-01-24 06:19:33 -06001079Set BMC Reset Reference Time
1080 [Documentation] Set current boot time as a reference and increment
George Keishing80dd5af2017-02-08 07:01:25 -06001081 ... boot count.
George Keishingcce9df22017-01-24 06:19:33 -06001082
1083 ${cur_btime}= Get BMC Boot Time
George Keishing80dd5af2017-02-08 07:01:25 -06001084 Run Keyword If ${BOOT_TIME} == ${0} and ${BOOT_COUNT} == ${0}
George Keishingcce9df22017-01-24 06:19:33 -06001085 ... Set Global Variable ${BOOT_TIME} ${cur_btime}
George Keishing80dd5af2017-02-08 07:01:25 -06001086 ... ELSE IF ${cur_btime} > ${BOOT_TIME}
1087 ... Run Keywords Set Global Variable ${BOOT_TIME} ${cur_btime}
George Keishingcce9df22017-01-24 06:19:33 -06001088 ... AND
1089 ... Set Global Variable ${BOOT_COUNT} ${BOOT_COUNT + 1}
1090
Steven Sombar0acb3412018-01-24 09:38:42 -06001091
George Keishingcce9df22017-01-24 06:19:33 -06001092Get BMC Boot Time
Steven Sombar0acb3412018-01-24 09:38:42 -06001093 [Documentation] Returns boot time from /proc/stat.
George Keishingcce9df22017-01-24 06:19:33 -06001094
1095 Open Connection And Log In
1096 ${output} ${stderr}=
1097 ... Execute Command egrep '^btime ' /proc/stat | cut -f 2 -d ' '
1098 ... return_stderr=True
1099 Should Be Empty ${stderr}
1100 ${btime}= Convert To Integer ${output}
1101 [Return] ${btime}
George Keishingede30002017-02-02 09:33:07 -06001102
Steven Sombar0acb3412018-01-24 09:38:42 -06001103
George Keishing7a520222017-02-27 09:44:30 -06001104Enable Core Dump On BMC
1105 [Documentation] Enable core dump collection.
Joy Onyerikwu9b668972018-05-22 19:10:43 -05001106 ${core_pattern} ${stderr} ${rc}= BMC Execute Command
George Keishing7a520222017-02-27 09:44:30 -06001107 ... echo '/tmp/core_%e.%p' | tee /proc/sys/kernel/core_pattern
1108 Should Be Equal As Strings ${core_pattern} /tmp/core_%e.%p
Rahul Maheshwarie95622c2017-02-24 10:04:29 -06001109
Steven Sombar0acb3412018-01-24 09:38:42 -06001110
Sivas SRR01262bd2017-03-19 10:00:23 -05001111Get Number Of BMC Core Dump Files
Steven Sombar0acb3412018-01-24 09:38:42 -06001112 [Documentation] Returns number of core dump files on BMC.
Sivas SRR01262bd2017-03-19 10:00:23 -05001113 Open Connection And Log In
1114 ${num_of_core_dump}= Execute Command
1115 ... ls /tmp/core* 2>/dev/null | wc -l
1116 [Return] ${num_of_core_dump}
1117
Steven Sombar0acb3412018-01-24 09:38:42 -06001118
Sivas SRR01262bd2017-03-19 10:00:23 -05001119Set Core Dump File Size Unlimited
1120 [Documentation] Set core dump file size to unlimited.
Joy Onyerikwu9b668972018-05-22 19:10:43 -05001121 BMC Execute Command ulimit -c unlimited
Sivas SRR01262bd2017-03-19 10:00:23 -05001122
Steven Sombar0acb3412018-01-24 09:38:42 -06001123
Sivas SRR01262bd2017-03-19 10:00:23 -05001124Check For Core Dumps
1125 [Documentation] Check for any core dumps exist.
1126 ${output}= Get Number Of BMC Core Dump Files
1127 Run Keyword If ${output} > 0
1128 ... Log **Warning** BMC core dump files exist level=WARN
1129
Steven Sombar0acb3412018-01-24 09:38:42 -06001130
Rahul Maheshwarie95622c2017-02-24 10:04:29 -06001131Trigger Host Watchdog Error
George Keishing37cfa6b2017-06-15 10:25:55 -05001132 [Documentation] Inject host watchdog timeout error via REST.
Rahul Maheshwarie95622c2017-02-24 10:04:29 -06001133 [Arguments] ${milliseconds}=1000 ${sleep_time}=5s
Steven Sombar0acb3412018-01-24 09:38:42 -06001134
Michael Walshb5839d02017-04-12 16:11:20 -05001135 # Description of argument(s):
1136 # milliseconds The time watchdog timer value in milliseconds (e.g. 1000 =
1137 # 1 second).
Rahul Maheshwarie95622c2017-02-24 10:04:29 -06001138 # sleep_time Time delay for host watchdog error to get injected.
1139 # Default is 5 seconds.
1140
Michael Walsh4ffd1a12018-03-14 10:35:44 -05001141 ${data}= Create Dictionary
1142 ... data=xyz.openbmc_project.State.Watchdog.Action.PowerCycle
1143 ${status} ${result}= Run Keyword And Ignore Error
1144 ... Read Attribute ${HOST_WATCHDOG_URI} ExpireAction
1145 Run Keyword If '${status}' == 'PASS'
1146 ... Write Attribute ${HOST_WATCHDOG_URI} ExpireAction data=${data}
George Keishing37cfa6b2017-06-15 10:25:55 -05001147
1148 ${data}= Create Dictionary data=${milliseconds}
Michael Walsh4ffd1a12018-03-14 10:35:44 -05001149 Write Attribute ${HOST_WATCHDOG_URI} Interval data=${data}
1150
1151 ${data}= Create Dictionary data=${True}
1152 Write Attribute ${HOST_WATCHDOG_URI} Enabled data=${data}
George Keishing37cfa6b2017-06-15 10:25:55 -05001153
Rahul Maheshwarie95622c2017-02-24 10:04:29 -06001154 Sleep ${sleep_time}
Prashanth Kattiae7c2282017-03-15 07:43:46 -05001155
Steven Sombar0acb3412018-01-24 09:38:42 -06001156
Prashanth Kattiae7c2282017-03-15 07:43:46 -05001157Login To OS Host
Steven Sombar0acb3412018-01-24 09:38:42 -06001158 [Documentation] Login to OS Host and return the Login response code.
Prashanth Kattiae7c2282017-03-15 07:43:46 -05001159 [Arguments] ${os_host}=${OS_HOST} ${os_username}=${OS_USERNAME}
1160 ... ${os_password}=${OS_PASSWORD}
Steven Sombar0acb3412018-01-24 09:38:42 -06001161
Gunnar Mills28e403b2017-10-25 16:16:38 -05001162 # Description of arguments:
Prashanth Kattiae7c2282017-03-15 07:43:46 -05001163 # ${os_host} IP address of the OS Host.
1164 # ${os_username} OS Host Login user name.
1165 # ${os_password} OS Host Login passwrd.
1166
1167 ${os_state}= Run Keyword And Return Status Ping Host ${os_host}
1168 Run Keyword If '${os_state}' == 'False'
1169 ... Run Keywords Initiate Host Reboot AND
1170 ... Is Host Running AND
1171 ... Wait for OS ${os_host} ${os_username} ${os_password}
1172
George Keishing3f223b82017-06-28 03:50:35 -05001173 SSHLibrary.Open Connection ${os_host}
Sridevi Rameshea36b412017-03-09 04:08:02 -06001174 ${resp}= Login ${os_username} ${os_password}
1175 [Return] ${resp}
Prashanth Katti884ee062017-03-16 05:05:03 -05001176
Steven Sombar0acb3412018-01-24 09:38:42 -06001177
Prashanth Katti884ee062017-03-16 05:05:03 -05001178Configure Initial Settings
1179 [Documentation] Restore old IP and route.
1180 ... This keyword requires initial settings viz IP address,
1181 ... Network Mask, default gatway and serial console IP and port
1182 ... information which should be provided in command line.
1183
Michael Walshb5839d02017-04-12 16:11:20 -05001184 [Arguments] ${host}=${OPENBMC_HOST} ${mask}=${NET_MASK}
1185 ... ${gw_ip}=${GW_IP}
Prashanth Katti884ee062017-03-16 05:05:03 -05001186
Steven Sombar0acb3412018-01-24 09:38:42 -06001187 # Description of arguments:
1188 # host IP address of the OS Host.
1189 # mask Network mask.
1190 # gu_ip Gateway IP address or hostname.
1191
Michael Walshb5839d02017-04-12 16:11:20 -05001192 # Open telnet connection and ignore the error, in case telnet session is
1193 # already opened by the program calling this keyword.
Prashanth Katti884ee062017-03-16 05:05:03 -05001194 Run Keyword And Ignore Error Open Telnet Connection to BMC Serial Console
1195 Telnet.write ifconfig eth0 ${host} netmask ${mask}
1196 Telnet.write route add default gw ${gw_ip}
George Keishingd05b1082017-03-24 05:27:32 -05001197
Steven Sombar0acb3412018-01-24 09:38:42 -06001198
George Keishingd05b1082017-03-24 05:27:32 -05001199Install Debug Tarball On BMC
George Keishing55441822017-05-18 14:17:59 -05001200 [Documentation] Copy the debug tar file to BMC and install.
Steven Sombar0acb3412018-01-24 09:38:42 -06001201 [Arguments] ${tarball_file_path}=${default_tarball}
1202 ... ${targ_tarball_dir_path}=/tmp/tarball/
George Keishingd05b1082017-03-24 05:27:32 -05001203
George Keishing55441822017-05-18 14:17:59 -05001204 # Description of arguments:
1205 # tarball_file_path Path of the debug tarball file.
1206 # The tar file is downloaded from the build page
1207 # https://openpower.xyz/job/openbmc-build/
1208 # obmc-phosphor-debug-tarball-witherspoon.tar.xz
1209 #
1210 # targ_tarball_dir_path The directory path where the tarball is to be
1211 # installed.
1212
1213 OperatingSystem.File Should Exist ${tarball_file_path}
1214 ... msg=${tarball_file_path} doesn't exist.
1215
1216 # Upload the file to BMC.
George Keishingd05b1082017-03-24 05:27:32 -05001217 Import Library SCPLibrary WITH NAME scp
1218 Open Connection for SCP
George Keishing55441822017-05-18 14:17:59 -05001219 scp.Put File ${tarball_file_path} /tmp/debug-tarball.tar.xz
1220
1221 # Create tarball directory and install.
George Keishing95c371a2017-09-14 15:42:33 -05001222 BMC Execute Command mkdir -p ${targ_tarball_dir_path}
1223 BMC Execute Command
George Keishing55441822017-05-18 14:17:59 -05001224 ... tar -xf /tmp/debug-tarball.tar.xz -C ${targ_tarball_dir_path}
1225
George Keishing95c371a2017-09-14 15:42:33 -05001226 # Remove the tarball file from BMC.
1227 BMC Execute Command rm -f /tmp/debug-tarball.tar.xz
George Keishingd05b1082017-03-24 05:27:32 -05001228
George Keishing55441822017-05-18 14:17:59 -05001229
Sweta Potthuri025e0122017-02-21 00:42:48 -06001230Get BMC Boot Count
Steven Sombar0acb3412018-01-24 09:38:42 -06001231 [Documentation] Returns BMC boot count based on boot time.
Sweta Potthuri025e0122017-02-21 00:42:48 -06001232 ${cur_btime}= Get BMC Boot Time
1233
1234 # Set global variable BOOT_TIME to current boot time if current boot time
1235 # is changed. Also increase value of global variable BOOT_COUNT by 1.
1236 Run Keyword If ${cur_btime} > ${BOOT_TIME}
1237 ... Run Keywords Set Global Variable ${BOOT_TIME} ${cur_btime}
1238 ... AND
1239 ... Set Global Variable ${BOOT_COUNT} ${BOOT_COUNT + 1}
Steven Sombar0acb3412018-01-24 09:38:42 -06001240
Sweta Potthuri025e0122017-02-21 00:42:48 -06001241 [Return] ${BOOT_COUNT}
1242
Steven Sombar0acb3412018-01-24 09:38:42 -06001243
Sweta Potthuri025e0122017-02-21 00:42:48 -06001244Set BMC Boot Count
1245 [Documentation] Set BMC boot count to given value.
1246 [Arguments] ${count}
1247
1248 # Description of arguments:
1249 # count boot count value.
1250 ${cur_btime}= Get BMC Boot Time
1251
1252 # Set global variable BOOT_COUNT to given value.
1253 Set Global Variable ${BOOT_COUNT} ${count}
1254
1255 # Set BOOT_TIME variable to current boot time.
1256 Set Global Variable ${BOOT_COUNT} ${count}
Michael Walsh689fbbe2017-04-04 17:58:03 -05001257
Steven Sombar0acb3412018-01-24 09:38:42 -06001258
Sweta Potthurie5a9fc72017-05-03 07:02:46 -05001259Get System LED State
1260 [Documentation] Return the state of given system LED.
1261 [Arguments] ${led_name}
1262
1263 # Description of argument(s):
1264 # led_name System LED name (e.g. heartbeat, identify, beep).
1265
1266 ${state}= Read Attribute ${LED_PHYSICAL_URI}${led_name} State
1267 [Return] ${state.rsplit('.', 1)[1]}
1268
George Keishing3987a1e2017-09-20 09:13:02 -05001269
Steven Sombar5f3af442018-02-14 08:30:15 -06001270Set System LED State
1271 [Documentation] Set given system LED via REST.
1272 [Arguments] ${led_name} ${led_state}
1273 # Description of argument(s):
1274 # led_name System LED name (e.g. heartbeat, identify, beep).
1275 # led_state LED state to be set (e.g. On, Off).
1276
1277 ${args}= Create Dictionary
1278 ... data=xyz.openbmc_project.Led.Physical.Action.${led_state}
1279 Write Attribute ${LED_PHYSICAL_URI}${led_name} State data=${args}
1280
1281 Verify LED State ${led_name} ${led_state}
1282
1283
1284Verify LED State
1285 [Documentation] Checks if LED is in given state.
1286 [Arguments] ${led_name} ${led_state}
1287 # Description of argument(s):
1288 # led_name System LED name (e.g. heartbeat, identify, beep).
1289 # led_state LED state to be verified (e.g. On, Off).
1290
1291 ${state}= Get System LED State ${led_name}
1292 Should Be Equal ${state} ${led_state}
1293
1294
Steven Sombarb89d5802018-02-15 14:48:49 -06001295Get LED State XYZ
1296 [Documentation] Returns state of given LED.
1297 [Arguments] ${led_name}
1298
1299 # Description of argument(s):
1300 # led_name Name of LED.
1301
1302 ${state}= Read Attribute ${LED_GROUPS_URI}${led_name} Asserted
1303 # Returns the state of the LED, either On or Off.
1304 [Return] ${state}
1305
1306
George Keishingd2d90af2017-06-27 08:17:34 -05001307Delete Error Logs
Michael Walsh689fbbe2017-04-04 17:58:03 -05001308 [Documentation] Delete error logs.
1309
George Keishingd2d90af2017-06-27 08:17:34 -05001310 # Check if error logs entries exist, if not return.
George Keishing335f5362017-06-30 15:11:20 -05001311 ${resp}= OpenBMC Get Request ${BMC_LOGGING_ENTRY}${/}list quiet=${1}
George Keishingd2d90af2017-06-27 08:17:34 -05001312 Return From Keyword If ${resp.status_code} == ${HTTP_NOT_FOUND}
1313
1314 # Get the list of error logs entries and delete them all.
George Keishing335f5362017-06-30 15:11:20 -05001315 ${elog_entries}= Get URL List ${BMC_LOGGING_ENTRY}
George Keishingd2d90af2017-06-27 08:17:34 -05001316 :FOR ${entry} IN @{elog_entries}
1317 \ Delete Error Log Entry ${entry}
George Keishingdb34c2f2017-04-18 13:20:25 -05001318
George Keishing3987a1e2017-09-20 09:13:02 -05001319
George Keishingd2d90af2017-06-27 08:17:34 -05001320Delete Error Log Entry
George Keishingdb34c2f2017-04-18 13:20:25 -05001321 [Documentation] Delete error log entry.
1322 [Arguments] ${entry_path}
1323
1324 # Description of argument(s):
1325 # entry_path Delete an error log entry.
1326 # Ex. /xyz/openbmc_project/logging/entry/1
1327
George Keishing6a8ed0f2017-07-11 22:54:42 -05001328 # Skip delete if entry URI is a callout.
1329 # Example: /xyz/openbmc_project/logging/entry/1/callout
1330 Return From Keyword If '${entry_path.rsplit('/', 1)[1]}' == 'callout'
1331
George Keishingdb34c2f2017-04-18 13:20:25 -05001332 ${data}= Create Dictionary data=@{EMPTY}
1333 ${resp}= Openbmc Delete Request ${entry_path} data=${data}
1334 Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
Rahul Maheshwari43be6932017-05-01 02:37:06 -05001335
1336
George Keishingcc71c3c2017-09-20 09:38:03 -05001337Delete All Error Logs
George Keishing3987a1e2017-09-20 09:13:02 -05001338 [Documentation] Delete all error log entries using "DeleteAll" interface.
1339
1340 ${data}= Create Dictionary data=@{EMPTY}
1341 ${resp}= Openbmc Post Request ${BMC_LOGGING_URI}action/DeleteAll
1342 ... data=${data}
1343 Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
1344
1345
Rahul Maheshwari13256d92017-06-15 10:05:40 -05001346Get BMC Version
1347 [Documentation] Returns BMC version from /etc/os-release.
1348 ... e.g. "v1.99.6-141-ge662190"
1349
Rahul Maheshwari13256d92017-06-15 10:05:40 -05001350 ${cmd}= Set Variable grep ^VERSION_ID= /etc/os-release | cut -f 2 -d '='
Joy Onyerikwu9b668972018-05-22 19:10:43 -05001351 ${output} ${stderr} ${rc}= BMC Execute Command ${cmd}
Rahul Maheshwari13256d92017-06-15 10:05:40 -05001352 [Return] ${output}
1353
George Keishingad5817a2017-06-28 10:19:03 -05001354
Charles Paul Hofere43fb2f2017-09-26 15:36:18 -05001355Get PNOR Version
Steven Sombar0acb3412018-01-24 09:38:42 -06001356 [Documentation] Returns the PNOR version from the BMC.
Charles Paul Hofere43fb2f2017-09-26 15:36:18 -05001357
1358 ${pnor_attrs}= Get PNOR Attributes
1359 [Return] ${pnor_attrs['version']}
1360
1361
1362Get PNOR Attributes
1363 [Documentation] Return PNOR software attributes as a dictionary.
1364
Michael Walsh98d8c9e2017-10-04 12:24:29 -05001365 # This keyword parses /var/lib/phosphor-software-manager/pnor/ro/pnor.toc
1366 # into key/value pairs.
Charles Paul Hofere43fb2f2017-09-26 15:36:18 -05001367
1368 ${outbuf} ${stderr} ${rc}= BMC Execute Command
1369 ... cat /var/lib/phosphor-software-manager/pnor/ro/pnor.toc
1370 ${pnor_attrs}= Key Value Outbuf To Dict ${outbuf} delim==
1371
1372 [Return] ${pnor_attrs}
1373
1374
George Keishingad5817a2017-06-28 10:19:03 -05001375Get Elog URL List
1376 [Documentation] Return error log entry list of URLs.
1377
1378 ${url_list}= Read Properties /xyz/openbmc_project/logging/entry/
1379 Sort List ${url_list}
1380 [Return] ${url_list}
1381
1382
Steven Sombaraaf72c42017-09-05 12:02:00 -05001383Read Turbo Setting Via REST
1384 [Documentation] Return turbo setting via REST.
Steven Sombarea79a492018-04-18 11:14:57 -05001385 # Returns 1 if TurboAllowed, 0 if not.
Steven Sombaraaf72c42017-09-05 12:02:00 -05001386
Steven Sombarea79a492018-04-18 11:14:57 -05001387 ${turbo_setting}= Read Attribute
1388 ... ${CONTROL_HOST_URI}turbo_allowed TurboAllowed
1389 [Return] ${turbo_setting}
1390
Steven Sombaraaf72c42017-09-05 12:02:00 -05001391
Steven Sombaraaf72c42017-09-05 12:02:00 -05001392Set Turbo Setting Via REST
1393 [Documentation] Set turbo setting via REST.
Steven Sombar80bc8592018-04-24 11:44:53 -05001394 [Arguments] ${setting} ${verify}=${False}
Steven Sombar0acb3412018-01-24 09:38:42 -06001395
Steven Sombaraaf72c42017-09-05 12:02:00 -05001396 # Description of argument(s):
Steven Sombar80bc8592018-04-24 11:44:53 -05001397 # setting State to set TurboAllowed, 1=allowed, 0=not allowed.
1398 # verify If True, read the TurboAllowed setting to confirm.
Steven Sombaraaf72c42017-09-05 12:02:00 -05001399
Steven Sombarea79a492018-04-18 11:14:57 -05001400 ${data}= Create Dictionary data=${${setting}}
Steven Sombar80bc8592018-04-24 11:44:53 -05001401 Write Attribute ${CONTROL_HOST_URI}turbo_allowed TurboAllowed
1402 ... verify=${verify} data=${data}
George Keishingef74a8c2017-10-20 10:23:52 -05001403
Steven Sombar0acb3412018-01-24 09:38:42 -06001404
George Keishingef74a8c2017-10-20 10:23:52 -05001405Set Control Boot Mode
1406 [Documentation] Set given boot mode on the boot object path attribute.
1407 [Arguments] ${boot_path} ${boot_mode}
1408
1409 # Description of argument(s):
1410 # boot_path Boot object path.
1411 # Example:
1412 # /xyz/openbmc_project/control/host0/boot
1413 # /xyz/openbmc_project/control/host0/boot/one_time
1414 # boot_mode Boot mode which need to be set.
1415 # Example:
1416 # "xyz.openbmc_project.Control.Boot.Mode.Modes.Regular"
1417
1418 ${valueDict}= Create Dictionary data=${boot_mode}
1419 Write Attribute ${boot_path} BootMode data=${valueDict}
Sridevi Ramesh0d88ab32017-09-21 11:07:28 -05001420
Steven Sombar0acb3412018-01-24 09:38:42 -06001421
Sridevi Ramesh0d88ab32017-09-21 11:07:28 -05001422Copy Address Translation Utils To HOST OS
1423 [Documentation] Copy address translation utils to host OS.
1424
1425 OperatingSystem.File Should Exist ${probe_cpu_tool_path}
1426 ... msg=${probe_cpu_tool_path} doesn't exist.
1427 OperatingSystem.File Should Exist ${probe_cpu_tool_path}
1428 ... msg=${probe_cpu_tool_path} doesn't exist.
1429
1430 scp.Open connection ${OS_HOST} username=${OS_USERNAME}
1431 ... password=${OS_PASSWORD}
1432 scp.Put File ${probe_cpu_tool_path} ${target_file_path}
1433 scp.Put File ${scom_addrs_tool_path} ${target_file_path}
George Keishing034902d2017-11-10 13:15:38 -06001434
1435
1436Verify BMC RTC And UTC Time Drift
1437 [Documentation] Verify that the RTC and UTC time difference is less than
1438 ... the given time_drift_max.
1439 [Arguments] ${time_diff_max}=${10}
1440
1441 # Description of argument(s):
1442 # time_diff_max The max allowable RTC and UTC time difference in seconds.
1443
1444 # Example:
1445 # time_dict:
1446 # [local_time]: Fri 2017-11-03 152756 UTC
1447 # [local_time_seconds]: 1509740876
1448 # [universal_time]: Fri 2017-11-03 152756 UTC
1449 # [universal_time_seconds]: 1509740876
1450 # [rtc_time]: Fri 2016-05-20 163403
1451 # [rtc_time_seconds]: 1463780043
1452 # [time_zone]: n/a (UTC, +0000)
1453 # [network_time_on]: yes
1454 # [ntp_synchronized]: no
1455 # [rtc_in_local_tz]: no
1456
Steven Sombar0acb3412018-01-24 09:38:42 -06001457 ${time}= Get BMC Date Time
George Keishing034902d2017-11-10 13:15:38 -06001458 ${time_diff}= Evaluate
Steven Sombar0acb3412018-01-24 09:38:42 -06001459 ... ${time['universal_time_seconds']} - ${time['rtc_time_seconds']}
George Keishing034902d2017-11-10 13:15:38 -06001460 Should Be True ${time_diff} < ${time_diff_max}
Sweta Potthuri7d3af3c2018-01-29 03:07:07 -06001461
Sweta Potthurif39022d2018-02-06 03:40:07 -06001462
Sweta Potthuri7d3af3c2018-01-29 03:07:07 -06001463Watchdog Object Should Exist
1464 [Documentation] Check that watchdog object exists.
1465
1466 ${resp}= OpenBMC Get Request ${WATCHDOG_URI}host0
1467 Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
1468 ... msg=Expected watchdog object does not exist.
Sweta Potthurif39022d2018-02-06 03:40:07 -06001469
1470
1471Validate IP On BMC
1472 [Documentation] Validate IP address is present in set of IP addresses.
1473 [Arguments] ${ip_address} ${ip_data}
1474
1475 # Description of argument(s):
1476 # ip_address IP address to check (e.g. xx.xx.xx.xx).
1477 # ip_data Set of the IP addresses present.
1478
1479 Should Contain Match ${ip_data} ${ip_address}/*
1480 ... msg=${ip_address} not found in the list provided.
George Keishingb9f407b2018-02-20 00:07:46 -06001481
1482
1483Remove Journald Logs
1484 [Documentation] Remove all journald logs and restart service.
1485
1486 ${cmd}= Catenate systemctl stop systemd-journald.service &&
1487 ... rm -rf /var/log/journal && systemctl start systemd-journald.service
1488
1489 BMC Execute Command ${cmd}
1490
George Keishing78ce8dc2018-03-30 11:49:06 -05001491
1492Verify Identify LED State
1493 [Documentation] Verify the identify LED state
1494 ... matches caller's expectations.
1495 [Arguments] ${expected_state}
1496
1497 # Description of argument(s):
1498 # expected_state The LED state expected by the caller ("Blink" or "Off").
1499
1500 ${resp}= Read Attribute ${LED_PHYSICAL_URI}/front_id State
1501 Should Be Equal ${resp}
1502 ... xyz.openbmc_project.Led.Physical.Action.${expected_state}
1503 ... msg=Unexpected LED state.
1504
1505 ${resp}= Read Attribute ${LED_PHYSICAL_URI}/rear_id State
1506 Should Be Equal ${resp}
1507 ... xyz.openbmc_project.Led.Physical.Action.${expected_state}
1508 ... msg=Unexpected LED state.
1509
Sweta Potthuri39255032018-03-28 10:12:14 -05001510
1511Verify The Attribute
Joy Onyerikwuf4a807b2018-06-20 08:43:54 -05001512 [Documentation] Verify the given attribute.
Sweta Potthuri39255032018-03-28 10:12:14 -05001513 [Arguments] ${uri} ${attribute_name} ${attribute_value}
1514
1515 # Description of argument(s):
1516 # uri URI path
1517 # (e.g. "/xyz/openbmc_project/control/host0/TPMEnable").
1518 # attribute_name Name of attribute to be verified (e.g. "TPMEnable").
1519 # attribute_value The expected value of attribute (e.g. "1", "0", etc.)
1520
1521 ${output}= Read Attribute ${uri} ${attribute_name}
1522 Should Be Equal ${attribute_value} ${output}
1523 ... msg=Attribute "${attribute_name} does not have the expected value.
George Keishingcf0d7772018-05-04 08:22:50 -05001524
1525
1526Get BMC Flash Chip Boot Side
1527 [Documentation] Return the BMC flash chip boot side.
1528
1529 # Example:
George Keishinge3d3abc2018-06-25 09:08:19 -05001530 # 0 - indicates chip select is current side.
1531 # 32 - indicates chip select is alternate side.
George Keishingcf0d7772018-05-04 08:22:50 -05001532
1533 ${boot_side} ${stderr} ${rc}= BMC Execute Command
George Keishinge3d3abc2018-06-25 09:08:19 -05001534 ... cat /sys/class/watchdog/watchdog1/bootstatus
George Keishingcf0d7772018-05-04 08:22:50 -05001535
1536 [Return] ${boot_side}
1537