1*** Settings *** 2Documentation Update the BMC code on a target BMC. 3... Execution Method: 4... python -m robot -v OPENBMC_HOST:<hostname> 5... -v IMAGE_FILE_PATH:<path/*.tar> bmc_code_update.robot 6 7Library ../../lib/code_update_utils.py 8Library ../../lib/gen_robot_keyword.py 9Variables ../../data/variables.py 10Resource ../../lib/utils.robot 11Resource ../../lib/boot_utils.robot 12Resource code_update_utils.robot 13Resource ../../lib/code_update_utils.robot 14Resource ../../lib/openbmc_ffdc.robot 15Resource ../../lib/dump_utils.robot 16Resource ../../lib/ipmi_client.robot 17Resource ../../lib/certificate_utils.robot 18 19Suite Setup Suite Setup Execution 20 21Test Teardown Test Teardown Execution 22 23Force Tags BMC_Code_Update 24 25*** Variables *** 26 27${QUIET} ${1} 28${IMAGE_FILE_PATH} ${EMPTY} 29${ALTERNATE_IMAGE_FILE_PATH} ${EMPTY} 30${SKIP_UPDATE_IF_ACTIVE} false 31${dump_id} ${EMPTY} 32${running_persistence_test} ${FALSE} 33${test_errlog_text} AutoTestSimple 34 35*** Test Cases *** 36 37Test Basic BMC Performance Before BMC Code Update 38 [Documentation] Check performance of memory, CPU & file system of BMC. 39 [Tags] Test_Basic_BMC_Performance_Before_BMC_Code_Update 40 41 Open Connection And Log In 42 Check BMC Performance 43 44Prepare Persistent Data 45 [Documentation] Set data that should persist across the code update. 46 [Tags] Prepare_Persistent_Data 47 48 # Install the debug tarball. 49 BMC Execute Command rm -rf /tmp/tarball 50 Install Debug Tarball On BMC tarball_file_path=${DEBUG_TARBALL_PATH} 51 52 # Create a dummy error log and dump. 53 BMC Execute Command /tmp/tarball/bin/logging-test -c ${test_errlog_text} 54 ${dump_id}= Create User Initiated Dump 55 Check Dump Existence ${dump_id} 56 Set Suite Variable ${dump_id} 57 58 # Set persistent settings. 59 ${autoreboot_dict}= Create Dictionary data=${0} 60 Write Attribute ${CONTROL_HOST_URI}auto_reboot AutoReboot 61 ... data=${autoreboot_dict} 62 ${onetime_dict}= Create Dictionary data=${0} 63 Write Attribute ${CONTROL_HOST_URI}boot/one_time Enabled 64 ... data=${onetime_dict} 65 66 # Let the remaining test cases know we are doing a persistence test so we 67 # do not delete logs. 68 Set Suite Variable ${running_persistence_test} ${TRUE} 69 70 71REST BMC Code Update 72 [Documentation] Do a BMC code update by uploading image on BMC via REST. 73 [Tags] REST_BMC_Code_Update 74 [Teardown] REST BMC Code Update Teardown 75 76 Run Keyword And Ignore Error List Installed Images BMC 77 78 Upload And Activate Image ${IMAGE_FILE_PATH} 79 ... skip_if_active=${SKIP_UPDATE_IF_ACTIVE} 80 OBMC Reboot (off) 81 Verify Running BMC Image ${IMAGE_FILE_PATH} 82 83 84Verify Error Log Persistency 85 [Documentation] Check that the error log is still present after a 86 ... code update. 87 [Tags] Verify_Error_Log_Persistency 88 89 ${error_log_paths}= Read Properties ${BMC_LOGGING_URI}/list 90 Log To Console ${error_log_paths} 91 ${test_error_message}= Read Attribute @{error_log_paths}[-1] Message 92 Should Be Equal ${test_error_message} 93 ... example.xyz.openbmc_project.Example.Elog.${test_errlog_text} 94 Delete Error Log Entry @{error_log_paths}[-1] 95 96 97Verify BMC Dump Persistency 98 [Documentation] Check that the BMC dump present after a code update. 99 [Tags] Verify_BMC_Dump_Persistency 100 [Teardown] Set Suite Variable ${running_persistence_test} ${FALSE} 101 102 Check Dump Existence ${dump_id} 103 Delete BMC Dump ${dump_id} 104 105 106Verify Settings Persistency 107 [Documentation] Verify that the settings from 'Prepare Persistent Data' 108 ... are still set correctly after the code update. 109 [Tags] Verify_Settings_Persistency 110 111 ${autoreboot_enabled}= Read Attribute ${CONTROL_HOST_URI}auto_reboot 112 ... AutoReboot 113 Should Be Equal ${autoreboot_enabled} ${0} 114 ${onetime_enabled}= Read Attribute ${CONTROL_HOST_URI}boot/one_time 115 ... Enabled 116 Should Be Equal ${onetime_enabled} ${0} 117 118 # Set values back to their defaults 119 ${autoreboot_dict}= Create Dictionary data=${1} 120 Write Attribute ${CONTROL_HOST_URI}auto_reboot AutoReboot 121 ... data=${autoreboot_dict} 122 ${onetime_dict}= Create Dictionary data=${1} 123 Write Attribute ${CONTROL_HOST_URI}boot/one_time Enabled 124 ... data=${onetime_dict} 125 126 127Upload And Activate Multiple BMC Images 128 [Documentation] Upload another BMC image and verify that its state is 129 ... different from all others. 130 [Tags] Upload_And_Activate_Multiple_BMC_Images 131 [Template] Activate Image And Verify No Duplicate Priorities 132 [Setup] Upload And Activate Multiple BMC Images Setup 133 134 # Image File Path Image Purpose 135 ${ALTERNATE_IMAGE_FILE_PATH} ${VERSION_PURPOSE_BMC} 136 137 138BMC Set Priority To Invalid Values 139 [Documentation] Attempt to set the priority of an image to an invalid 140 ... value and expect an error. 141 [Tags] BMC_Set_Priority_To_Invalid_Values 142 [Template] Set Priority To Invalid Value And Expect Error 143 144 # Version Type Priority 145 ${VERSION_PURPOSE_BMC} ${-1} 146 ${VERSION_PURPOSE_BMC} ${256} 147 148 149Delete BMC Image 150 [Documentation] Delete a BMC image from the BMC flash chip. 151 [Tags] Delete_BMC_Image 152 153 ${software_object}= Get Non Running BMC Software Object 154 Delete Image And Verify ${software_object} ${VERSION_PURPOSE_BMC} 155 156 157BMC Image Priority Attribute Test 158 [Documentation] Set "Priority" attribute. 159 [Tags] BMC_Image_Priority_Attribute_Test 160 [Template] Temporarily Set BMC Attribute 161 162 # Property Value 163 Priority ${0} 164 Priority ${1} 165 Priority ${127} 166 Priority ${255} 167 168 169Delete All Non Running BMC Images 170 [Documentation] Delete all non running BMC images. 171 [Tags] Delete_All_Non_Running_BMC_Images 172 173 ${version_id}= Upload And Activate Image ${ALTERNATE_IMAGE_FILE_PATH} 174 ... skip_if_active=true 175 Delete All Non Running BMC Images 176 177 ${software_ids}= Get Software Objects Id 178 ... version_type=${VERSION_PURPOSE_BMC} 179 Should Not Contain ${software_ids} ${version_id} 180 181 182Verify IPMI Disable Policy Post BMC Code Update 183 [Documentation] Disable IPMI, update BMC and verify post-update. 184 [Tags] Verify_IPMI_Disable_Policy_Post_BMC_Code_Update 185 186 REST Power On 187 188 Run Inband IPMI Standard Command lan set 1 access off 189 Run Keyword and Expect Error *Unable to establish IPMI* 190 ... Run External IPMI Standard Command lan print 191 192 Upload And Activate Image ${IMAGE_FILE_PATH} 193 ... skip_if_active=${SKIP_UPDATE_IF_ACTIVE} 194 OBMC Reboot (off) 195 Verify Running BMC Image ${IMAGE_FILE_PATH} 196 197 Run Keyword and Expect Error *Unable to establish IPMI* 198 ... Run External IPMI Standard Command lan print 199 200 201Test Certificate Persistency After BMC Code Update 202 [Documentation] Test certificate persistency after BMC update. 203 [Tags] Test_Certificate_Persistency_After_BMC_Code_Update 204 205 ${cert_file_path}= Generate Certificate File Via Openssl 206 ... Valid Certificate Valid Privatekey 207 ${file_data}= OperatingSystem.Get Binary File ${cert_file_path} 208 ${cert_file_content}= OperatingSystem.Get File ${cert_file_path} 209 210 Install Certificate File On BMC ${CLIENT_CERTIFICATE_URI} 211 ... data=${file_data} 212 213 ${bmc_cert_content}= Get Certificate File Content From BMC Client 214 Should Contain ${cert_file_content} ${bmc_cert_content} 215 216 Upload And Activate Image ${IMAGE_FILE_PATH} 217 ... skip_if_active=${SKIP_UPDATE_IF_ACTIVE} 218 OBMC Reboot (off) 219 Verify Running BMC Image ${IMAGE_FILE_PATH} 220 221 ${bmc_cert_content}= Get Certificate File Content From BMC Client 222 Should Contain ${cert_file_content} ${bmc_cert_content} 223 224 225Test Basic BMC Performance After Code Update 226 [Documentation] Check performance of memory, CPU & file system of BMC. 227 [Tags] Test_Basic_BMC_Performance_After_Code_Update 228 229 Open Connection And Log In 230 Check BMC Performance 231 232 233*** Keywords *** 234 235Temporarily Set BMC Attribute 236 [Documentation] Update the BMC attribute value. 237 [Arguments] ${attribute_name} ${attribute_value} 238 239 # Description of argument(s): 240 # attribute_name BMC software attribute name (e.g. "Priority"). 241 # attribute_value Value to be written. 242 243 ${image_ids}= Get Software Objects ${VERSION_PURPOSE_BMC} 244 ${init_bmc_properties}= Get Host Software Property ${image_ids[0]} 245 ${initial_priority}= Set Variable ${init_bmc_properties["Priority"]} 246 247 Set Host Software Property ${image_ids[0]} ${attribute_name} 248 ... ${attribute_value} 249 250 ${cur_bmc_properties}= Get Host Software Property ${image_ids[0]} 251 Should Be Equal As Integers ${cur_bmc_properties["Priority"]} 252 ... ${attribute_value} 253 254 # Revert to to initial value. 255 Set Host Software Property 256 ... ${image_ids[0]} ${attribute_name} ${initial_priority} 257 258 259Upload And Activate Multiple BMC Images Setup 260 [Documentation] Check that the ALTERNATE_FILE_PATH variable is set. 261 262 Should Not Be Empty ${ALTERNATE_IMAGE_FILE_PATH} 263 264 265REST BMC Code Update Teardown 266 [Documentation] Do code update test teardown. 267 268 FFDC On Test Case Fail 269 Run Keyword If Test Failed Fatal Error msg=Code update failed. 270 271 272Suite Setup Execution 273 [Documentation] Do code update test case setup. 274 # - Clean up all existing BMC dumps. 275 276 Run Key Delete All Dumps ignore=1 277 Run Keyword And Ignore Error Smart Power Off 278 279Test Teardown Execution 280 [Documentation] Do code update test case teardown. 281 # 1. Collect FFDC if test case failed. 282 # 2. Collect FFDC if test PASS but error log exists. 283 284 # Don't delete our logs if we want to persist them for tests. 285 Return From Keyword If ${running_persistence_test} 286 287 FFDC On Test Case Fail 288 Run Keyword If '${TEST_STATUS}' == 'PASS' Check Error And Collect FFDC 289 Close All Connections 290