1*** Settings *** 2Documentation Update the PNOR code on a target BMC. 3... Execution Method: 4... python -m robot -v OPENBMC_HOST:<hostname> 5... -v DELETE_OLD_PNOR_IMAGES:<"true" or "false"> 6... -v IMAGE_FILE_PATH:<path/*.tar> 7... -v ALTERNATE_IMAGE_FILE_PATH:<path/*.tar> 8... host_code_update.robot 9... 10... Code update method BMC 11... Update work flow sequence: 12... - Upload image via REST 13... - Verify that the file exists on the BMC 14... - Check that software "Activation" is set to "Ready" 15... - Set "Requested Activation" to "Active" 16... - Wait for code update to complete 17... - Verify the new version 18 19Library ../../lib/bmc_ssh_utils.py 20Library ../../lib/code_update_utils.py 21Variables ../../data/variables.py 22Resource ../../lib/boot_utils.robot 23Resource code_update_utils.robot 24Resource ../../lib/code_update_utils.robot 25Resource ../../lib/openbmc_ffdc.robot 26Resource ../../lib/state_manager.robot 27Resource ../../lib/dump_utils.robot 28 29Test Teardown Code Update Test Teardown 30 31Force Tags Host_Code_Update 32 33*** Variables *** 34 35${QUIET} ${1} 36${IMAGE_FILE_PATH} ${EMPTY} 37${DELETE_OLD_PNOR_IMAGES} false 38${DELETE_OLD_GUARD_FILE} false 39${ALTERNATE_IMAGE_FILE_PATH} ${EMPTY} 40 41*** Test Cases *** 42 43REST Host Code Update 44 [Documentation] Do a PNOR code update by uploading image on BMC via REST. 45 # 1. Delete error logs if there is any. 46 # 1. Do code update. 47 # 2. Do post update the following: 48 # - Collect FFDC if error log exist and delete error logs. 49 [Tags] REST_Host_Code_Update 50 [Setup] Code Update Setup 51 52 Upload And Activate Image ${IMAGE_FILE_PATH} 53 OBMC Reboot (off) 54 55 56Post Update Boot To OS 57 [Documentation] Boot the host OS 58 [Tags] Post_Update_Boot_To_OS 59 [Setup] Start SOL Console Logging 60 [Teardown] Run Keywords Stop SOL Console Logging 61 ... AND Code Update Test Teardown 62 63 Run Keyword If '${PREV_TEST_STATUS}' == 'FAIL' 64 ... Fail Code update failed. No need to boot to OS. 65 Delete Error Logs 66 REST Power On 67 Verify Running Host Image ${IMAGE_FILE_PATH} 68 69 70REST Host Code Update While OS Is Running 71 [Documentation] Do a PNOR code update while the host is running. 72 [Tags] REST_Host_Code_Update_While_OS_Is_Running 73 [Teardown] Run Keywords REST Power Off stack_mode=skip 74 ... AND Code Update Test Teardown 75 76 Run Keyword If '${PREV_TEST_STATUS}' == 'FAIL' 77 ... Fail Cannot boot the OS. 78 79 REST Power On stack_mode=skip 80 Upload And Activate Image ${ALTERNATE_IMAGE_FILE_PATH} 81 REST Power On stack_mode=normal 82 Verify Running Host Image ${ALTERNATE_IMAGE_FILE_PATH} 83 84Host Image Priority Attribute Test 85 [Documentation] Set "Priority" attribute. 86 [Tags] Host_Image_Priority_Attribute_Test 87 [Template] Temporarily Set PNOR Attribute 88 89 # Property Value 90 Priority ${0} 91 Priority ${1} 92 Priority ${127} 93 Priority ${255} 94 95 96Host Set Priority To Invalid Values 97 [Documentation] Attempt to set the priority of an image to an invalid 98 ... value and expect an error. 99 [Tags] Host_Set_Priority_To_Invalid_Values 100 [Template] Set Priority To Invalid Value And Expect Error 101 102 # Version Type Priority 103 ${VERSION_PURPOSE_HOST} ${-1} 104 ${VERSION_PURPOSE_HOST} ${256} 105 106 107Set RequestedActivation To None 108 [Documentation] Set the RequestedActivation of the image to None and 109 ... verify that it is in fact set to None. 110 [Tags] Set_RequestedActivation_To_None 111 112 ${software_objects}= Get Software Objects 113 Set Host Software Property @{software_objects}[0] RequestedActivation 114 ... ${REQUESTED_NONE} 115 ${software_properties}= Get Host Software Property @{software_objects}[0] 116 Should Be Equal As Strings &{software_properties}[RequestedActivation] 117 ... ${REQUESTED_NONE} 118 119 120Set RequestedActivation And Activation To Invalid Value 121 [Documentation] Set the RequestedActivation and Activation propreties of 122 ... the image to an invalid value and verify that it was not 123 ... changed. 124 [Template] Set Property To Invalid Value And Verify No Change 125 [Tags] Set_RequestedActivation_And_Activation_To_Invalid_Value 126 127 # Property Version Type 128 RequestedActivation ${VERSION_PURPOSE_HOST} 129 Activation ${VERSION_PURPOSE_HOST} 130 131 132Upload And Activate Multiple Host Images 133 [Documentation] Upload another PNOR image and verify that its state is 134 ... different from all others. 135 [Tags] Upload_And_Activate_Multiple_Host_Images 136 [Template] Activate Image And Verify No Duplicate Priorities 137 [Setup] Upload And Activate Multiple BMC Images Setup 138 139 # Image File Path Image Purpose 140 ${ALTERNATE_IMAGE_FILE_PATH} ${VERSION_PURPOSE_HOST} 141 142 143Set Same Priority For Multiple Host Images 144 [Documentation] Attempt to set the priority to be the same for two PNOR 145 ... images and verify that the priorities are not the same. 146 [Tags] Set_Same_Priority_For_Multiple_Host_Images 147 148 Run Keyword If '${PREV_TEST_STATUS}' == 'FAIL' 149 ... Fail Activation of alternate image failed. Cannot set priority. 150 Set Same Priority For Multiple Images ${VERSION_PURPOSE_HOST} 151 152 153Delete Host Image 154 [Documentation] Delete a PNOR image from the BMC and PNOR flash chip. 155 [Tags] Delete_Host_Image 156 [Setup] Initiate Host PowerOff 157 158 ${software_objects}= Get Software Objects 159 ... version_type=${VERSION_PURPOSE_HOST} 160 ${num_images}= Get Length ${software_objects} 161 Should Be True 0 < ${num_images} 162 ... msg=There are no PNOR images on the BMC to delete. 163 Delete Image And Verify @{software_objects}[0] ${VERSION_PURPOSE_HOST} 164 165 166*** Keywords *** 167 168Temporarily Set PNOR Attribute 169 [Documentation] Update the PNOR attribute value. 170 [Arguments] ${attribute_name} ${attribute_value} 171 172 # Description of argument(s): 173 # attribute_name Host software attribute name (e.g. "Priority"). 174 # attribute_value Value to be written. 175 176 ${image_ids}= Get Software Objects 177 ${init_host_properties}= Get Host Software Property ${image_ids[0]} 178 ${initial_priority}= Set Variable ${init_host_properties["Priority"]} 179 180 Set Host Software Property ${image_ids[0]} ${attribute_name} 181 ... ${attribute_value} 182 183 ${cur_host_properties}= Get Host Software Property ${image_ids[0]} 184 Should Be Equal As Integers ${cur_host_properties["Priority"]} 185 ... ${attribute_value} 186 187 # Revert to to initial value. 188 Set Host Software Property 189 ... ${image_ids[0]} ${attribute_name} ${initial_priority} 190 191 192Code Update Setup 193 [Documentation] Do code update test case setup. 194 # - Clean up all existing BMC dumps. 195 # - Clean up all currently install PNOR images. 196 197 Run Keyword And Ignore Error Smart Power Off 198 Delete All Dumps 199 Delete Error Logs 200 Run Keyword If 'true' == '${DELETE_OLD_PNOR_IMAGES}' 201 ... Delete All PNOR Images 202 Run Keyword If 'true' == '${DELETE_OLD_GUARD_FILE}' BMC Execute Command 203 ... rm -f /var/lib/phosphor-software-manager/pnor/prsv/GUARD 204 205 206Upload And Activate Multiple BMC Images Setup 207 [Documentation] Check that the ALTERNATE_FILE_PATH variable is set. 208 209 Should Not Be Empty ${ALTERNATE_IMAGE_FILE_PATH} 210 Delete All PNOR Images 211 Upload And Activate Image ${IMAGE_FILE_PATH} 212 213Get PNOR Extended Version 214 [Documentation] Return the PNOR extended version. 215 [Arguments] ${manifest_path} 216 217 # Description of argument(s): 218 # manifest_path Path of the MANIFEST file 219 # (e.g. "/tmp/images/abc123/MANIFEST"). 220 221 ${version}= BMC Execute Command 222 ... grep extended_version= ${manifest_path} 223 [return] ${version.split(",")} 224 225 226Code Update Test Teardown 227 [Documentation] Do code update test case teardown. 228 # 1. Collect FFDC if test case failed. 229 # 2. Collect FFDC if test PASS but error log exists. 230 231 FFDC On Test Case Fail 232 Run Keyword If '${TEST_STATUS}' == 'PASS' Check Error And Collect FFDC 233