| *** Settings *** |
| Documentation BMC and PNOR update utilities keywords. |
| |
| Library code_update_utils.py |
| Library OperatingSystem |
| Library String |
| Library utilities.py |
| Variables ../data/variables.py |
| Resource boot_utils.robot |
| Resource rest_client.robot |
| Resource openbmc_ffdc.robot |
| Resource oem/ibm/serial_console_client.robot |
| |
| *** Keywords *** |
| |
| Get Software Objects |
| [Documentation] Get the host software objects and return as a list. |
| [Arguments] ${version_type}=${VERSION_PURPOSE_HOST} |
| |
| # Description of argument(s): |
| # version_type Either BMC or host version purpose. |
| # By default host version purpose string. |
| # (e.g. "xyz.openbmc_project.Software.Version.VersionPurpose.BMC" |
| # "xyz.openbmc_project.Software.Version.VersionPurpose.Host"). |
| |
| # Example: |
| # "data": [ |
| # "/xyz/openbmc_project/software/f3b29aa8", |
| # "/xyz/openbmc_project/software/e49bc78e", |
| # ], |
| # Iterate the list and return the host object name path list. |
| |
| ${host_list}= Create List |
| ${sw_list}= Read Properties ${SOFTWARE_VERSION_URI} |
| |
| :FOR ${index} IN @{sw_list} |
| \ ${attr_purpose}= Read Software Attribute ${index} Purpose |
| \ Continue For Loop If '${attr_purpose}' != '${version_type}' |
| \ Append To List ${host_list} ${index} |
| |
| [Return] ${host_list} |
| |
| |
| Read Software Attribute |
| [Documentation] Return software attribute data. |
| [Arguments] ${software_object} ${attribute_name} |
| |
| # Description of argument(s): |
| # software_object Software object path. |
| # (e.g. "/xyz/openbmc_project/software/f3b29aa8"). |
| # attribute_name Software object attribute name. |
| |
| ${resp}= OpenBMC Get Request ${software_object}/attr/${attribute_name} |
| ... quiet=${1} |
| Return From Keyword If ${resp.status_code} != ${HTTP_OK} |
| ${content}= To JSON ${resp.content} |
| [Return] ${content["data"]} |
| |
| |
| Get Software Objects Id |
| [Documentation] Get the software objects id and return as a list. |
| [Arguments] ${version_type}=${VERSION_PURPOSE_HOST} |
| |
| # Description of argument(s): |
| # version_type Either BMC or host version purpose. |
| # By default host version purpose string. |
| # (e.g. "xyz.openbmc_project.Software.Version.VersionPurpose.BMC" |
| # "xyz.openbmc_project.Software.Version.VersionPurpose.Host"). |
| |
| ${sw_id_list}= Create List |
| ${sw_list}= Get Software Objects ${version_type} |
| |
| :FOR ${index} IN @{sw_list} |
| \ Append To List ${sw_id_list} ${index.rsplit('/', 1)[1]} |
| |
| [Return] ${sw_id_list} |
| |
| |
| Get Host Software Property |
| [Documentation] Return a dictionary of host software properties. |
| [Arguments] ${host_object} |
| |
| # Description of argument(s): |
| # host_object Host software object path. |
| # (e.g. "/xyz/openbmc_project/software/f3b29aa8"). |
| |
| ${sw_attributes}= Read Properties ${host_object} |
| [return] ${sw_attributes} |
| |
| Get Host Software Objects Details |
| [Documentation] Return software object details as a list of dictionaries. |
| [Arguments] ${quiet}=${QUIET} |
| |
| ${software}= Create List |
| |
| ${pnor_details}= Get Software Objects ${VERSION_PURPOSE_HOST} |
| :FOR ${pnor} IN @{pnor_details} |
| \ ${resp}= OpenBMC Get Request ${pnor} quiet=${1} |
| \ ${json}= To JSON ${resp.content} |
| \ Append To List ${software} ${json["data"]} |
| |
| [Return] ${software} |
| |
| Set Host Software Property |
| [Documentation] Set the host software properties of a given object. |
| [Arguments] ${host_object} ${sw_attribute} ${data} |
| |
| # Description of argument(s): |
| # host_object Host software object name. |
| # sw_attribute Host software attribute name. |
| # (e.g. "Activation", "Priority", "RequestedActivation" etc). |
| # data Value to be written. |
| |
| ${args}= Create Dictionary data=${data} |
| Write Attribute ${host_object} ${sw_attribute} data=${args} |
| |
| |
| Set Property To Invalid Value And Verify No Change |
| [Documentation] Attempt to set a property and check that the value didn't |
| ... change. |
| [Arguments] ${property} ${version_type} |
| |
| # Description of argument(s): |
| # property The property to attempt to set. |
| # version_type Either BMC or host version purpose. |
| # By default host version purpose string. |
| # (e.g. "xyz.openbmc_project.Software.Version.VersionPurpose.BMC" |
| # "xyz.openbmc_project.Software.Version.VersionPurpose.Host"). |
| |
| ${software_objects}= Get Software Objects version_type=${version_type} |
| ${prev_properties}= Get Host Software Property @{software_objects}[0] |
| Run Keyword And Expect Error 500 != 200 |
| ... Set Host Software Property @{software_objects}[0] ${property} foo |
| ${cur_properties}= Get Host Software Property @{software_objects}[0] |
| Should Be Equal As Strings &{prev_properties}[${property}] |
| ... &{cur_properties}[${property}] |
| |
| |
| Set Priority To Invalid Value And Expect Error |
| [Documentation] Set the priority of an image to an invalid value and |
| ... check that an error was returned. |
| [Arguments] ${version_type} ${priority} |
| |
| # Description of argument(s): |
| # version_type Either BMC or host version purpose. |
| # (e.g. "xyz.openbmc_project.Software.Version.VersionPurpose.BMC" |
| # "xyz.openbmc_project.Software.Version.VersionPurpose.Host"). |
| # priority The priority value to set. Should be an integer outside of |
| # the range of 0 through 255. |
| |
| ${images}= Get Software Objects version_type=${version_type} |
| ${num_images}= Get Length ${images} |
| Should Be True 0 < ${num_images} |
| |
| Run Keyword And Expect Error 403 != 200 |
| ... Set Host Software Property @{images}[0] Priority ${priority} |
| |
| |
| Upload And Activate Image |
| [Documentation] Upload an image to the BMC and activate it with REST. |
| [Arguments] ${image_file_path} ${wait}=${1} ${skip_if_active}=false |
| |
| # Description of argument(s): |
| # image_file_path The path to the image tarball to upload and activate. |
| # wait Indicates that this keyword should wait for host or |
| # BMC activation is completed. |
| # skip_if_active If set to true, will skip the code update if this |
| # image is already on the BMC. |
| |
| OperatingSystem.File Should Exist ${image_file_path} |
| ${image_version}= Get Version Tar ${image_file_path} |
| |
| ${image_data}= OperatingSystem.Get Binary File ${image_file_path} |
| Upload Image To BMC /upload/image data=${image_data} |
| ${ret} ${version_id}= Verify Image Upload ${image_version} |
| Should Be True ${ret} |
| |
| # Verify the image is 'READY' to be activated or if it's already active, |
| # set priority to 0 and reboot the BMC. |
| ${software_state}= Read Properties ${SOFTWARE_VERSION_URI}${version_id} |
| ${activation}= Set Variable &{software_state}[Activation] |
| Run Keyword If |
| ... '${skip_if_active}' == 'true' and '${activation}' == '${ACTIVE}' |
| ... Switch To Active Image And Pass ${SOFTWARE_VERSION_URI}${version_id} |
| Should Be Equal As Strings &{software_state}[Activation] ${READY} |
| |
| # Request the image to be activated. |
| ${args}= Create Dictionary data=${REQUESTED_ACTIVE} |
| Write Attribute ${SOFTWARE_VERSION_URI}${version_id} |
| ... RequestedActivation data=${args} |
| ${software_state}= Read Properties ${SOFTWARE_VERSION_URI}${version_id} |
| Should Be Equal As Strings &{software_state}[RequestedActivation] |
| ... ${REQUESTED_ACTIVE} |
| |
| # Does caller want to wait for activation to complete? |
| Return From Keyword If '${wait}' == '${0}' ${version_id} |
| |
| # Verify code update was successful and Activation state is Active. |
| Wait For Activation State Change ${version_id} ${ACTIVATING} |
| ${software_state}= Read Properties ${SOFTWARE_VERSION_URI}${version_id} |
| Should Be Equal As Strings &{software_state}[Activation] ${ACTIVE} |
| |
| [Return] ${version_id} |
| |
| |
| Attempt To Reboot BMC During Image Activation |
| [Documentation] Attempt to reboot the BMC while an image is activating and |
| ... check that the BMC ignores the reboot command and finishes |
| ... activation. |
| [Arguments] ${image_file_path} |
| |
| # Description of argument(s): |
| # image_file_path Path to the image to update to. |
| |
| # Attempt to reboot during activation. |
| ${version_id}= Upload And Activate Image ${image_file_path} |
| ... wait=${0} |
| BMC Execute Command /sbin/reboot |
| |
| # Wait for activation to finish. |
| Wait For Activation State Change ${version_id} ${ACTIVATING} |
| ${software_state}= Read Properties ${SOFTWARE_VERSION_URI}${version_id} |
| Should Be Equal As Strings &{software_state}[Activation] ${ACTIVE} |
| |
| # Verify the image priority is 0. |
| ${priority}= Read Software Attribute ${SOFTWARE_VERSION_URI}${version_id} |
| ... Priority |
| Should Be Equal ${priority} ${0} |
| |
| |
| Switch To Active Image And Pass |
| [Documentation] Make the given active image the image running on the BMC |
| ... and pass the test. |
| [Arguments] ${software_object} |
| |
| # Description of argument(s): |
| # software_object Software object path. |
| # (e.g. "/xyz/openbmc_project/software/f3b29aa8"). |
| |
| Set Host Software Property ${software_object} Priority ${0} |
| OBMC Reboot (off) |
| Pass Execution ${software_object} was already on the BMC. |
| |
| |
| Activate Image And Verify No Duplicate Priorities |
| [Documentation] Upload an image, and then check that no images have the |
| ... same priority. |
| [Arguments] ${image_file_path} ${image_purpose} |
| |
| # Description of argument(s): |
| # image_file_path The path to the image to upload. |
| # image_purpose The purpose in the image's MANIFEST file. |
| |
| Upload And Activate Image ${image_file_path} |
| Verify No Duplicate Image Priorities ${image_purpose} |
| |
| |
| Set Same Priority For Multiple Images |
| [Documentation] Find two images, set the priorities to be the same, and |
| ... verify that the priorities are not the same. |
| [Arguments] ${version_purpose} |
| |
| # Description of argument(s): |
| # version_purpose Either BMC or host version purpose. |
| # (e.g. "xyz.openbmc_project.Software.Version.VersionPurpose.BMC" |
| # "xyz.openbmc_project.Software.Version.VersionPurpose.Host"). |
| |
| # Make sure we have more than two images. |
| ${software_objects}= Get Software Objects version_type=${version_purpose} |
| ${num_images}= Get Length ${software_objects} |
| Should Be True 1 < ${num_images} |
| ... msg=Only found one image on the BMC with purpose ${version_purpose}. |
| |
| # Set the priority of the second image to the priority of the first. |
| ${properties}= Get Host Software Property @{software_objects}[0] |
| Set Host Software Property @{software_objects}[1] Priority |
| ... &{properties}[Priority] |
| Verify No Duplicate Image Priorities ${version_purpose} |
| |
| # Set the priority of the first image back to what it was before |
| Set Host Software Property @{software_objects}[0] Priority |
| ... &{properties}[Priority] |
| |
| |
| Delete Software Object |
| [Documentation] Deletes an image from the BMC. |
| [Arguments] ${software_object} |
| |
| # Description of argument(s): |
| # software_object The URI to the software image to delete. |
| |
| ${arglist}= Create List |
| ${args}= Create Dictionary data=${arglist} |
| ${resp}= OpenBMC Post Request ${software_object}/action/delete |
| ... data=${args} |
| Should Be Equal As Strings ${resp.status_code} ${HTTP_OK} |
| |
| |
| Delete Image And Verify |
| [Documentation] Delete an image from the BMC and verify that it was |
| ... removed from software and the /tmp/images directory. |
| [Arguments] ${software_object} ${version_type} |
| |
| # Description of argument(s): |
| # software_object The URI of the software object to delete. |
| # version_type The type of the software object, e.g. |
| # xyz.openbmc_project.Software.Version.VersionPurpose.Host |
| # or xyz.openbmc_project.Software.Version.VersionPurpose.BMC. |
| |
| Log To Console Deleteing ${software_object} |
| |
| # Delete the image. |
| Delete Software Object ${software_object} |
| # TODO: If/when we don't have to delete twice anymore, take this out |
| Run Keyword And Ignore Error Delete Software Object ${software_object} |
| |
| # Verify that it's gone from software. |
| ${software_objects}= Get Software Objects version_type=${version_type} |
| Should Not Contain ${software_objects} ${software_object} |
| |
| # Check that there is no file in the /tmp/images directory. |
| ${image_id}= Fetch From Right ${software_object} / |
| BMC Execute Command |
| ... [ ! -d "/tmp/images/${image_id}" ] |
| |
| |
| Delete All Non Running BMC Images |
| [Documentation] Delete all BMC images that are not running on the BMC. |
| |
| @{datalist}= Create List |
| ${data}= Create Dictionary data=@{datalist} |
| Call Method ${SOFTWARE_VERSION_URI} DeleteAll data=${data} |
| |
| |
| Check Error And Collect FFDC |
| [Documentation] Collect FFDC if error log exists. |
| |
| ${status}= Run Keyword And Return Status Error Logs Should Not Exist |
| Run Keyword If '${status}' == 'False' FFDC |
| Delete Error Logs |
| |
| |
| Verify Running BMC Image |
| [Documentation] Verify that the version on the BMC is the same as the |
| ... version in the given image. |
| [Arguments] ${image_file_path} |
| |
| # Description of argument(s): |
| # image_file_path Path to the BMC image tarball. |
| |
| ${tar_version}= Get Version Tar ${image_file_path} |
| ${bmc_version}= Get BMC Version |
| ${bmc_version}= Remove String ${bmc_version} " |
| Should Be Equal ${tar_version} ${bmc_version} |
| |
| |
| Verify Running Host Image |
| [Documentation] Verify that the version of the PNOR image that is on the |
| ... BMC is the same as the one in the given image. |
| [Arguments] ${image_file_path} |
| |
| # Description of argument(s): |
| # image_file_path Path to the PNOR image tarball. |
| |
| ${tar_version}= Get Version Tar ${image_file_path} |
| ${pnor_version}= Get PNOR Version |
| Should Be Equal ${tar_version} ${pnor_version} |
| |
| Reset Network Interface During Code Update |
| [Documentation] Disable and re-enable the network while doing code update. |
| [Arguments] ${image_file_path} ${reboot} |
| |
| # Resetting the network will be done via the serial console. |
| # |
| # Description of argument(s): |
| # image_file_path Path to the image file to update to. |
| # reboot If set to true, will reboot the BMC after the code |
| # update is finished. |
| |
| ${version_id}= Upload And Activate Image ${image_file_path} wait=${0} |
| Reset Network Interface |
| |
| # Verify code update was successful and 'Activation' state is 'Active'. |
| Wait For Activation State Change ${version_id} ${ACTIVATING} |
| ${software_state}= Read Properties ${SOFTWARE_VERSION_URI}${version_id} |
| Should Be Equal As Strings &{software_state}[Activation] ${ACTIVE} |
| |
| Run Keyword If '${reboot}' OBMC Reboot (off) stack_mode=normal |
| |
| |
| Reset Network Interface |
| [Documentation] Turn the ethernet network interface off and then on again |
| ... through the serial console. |
| |
| Import Resource ${CURDIR}/oem/ibm/serial_console_client.robot |
| Set Library Search Order SSHLibrary Telnet |
| Execute Command On Serial Console ifconfig eth0 down |
| Sleep 30s |
| Execute Command On Serial Console ifconfig eth0 up |
| |
| |
| Get Least Value Priority Image |
| [Documentation] Find the least value in "Priority" attribute and return. |
| [Arguments] ${version_type} |
| |
| # Description of argument(s): |
| # version_type Either BMC or host version purpose. |
| |
| ${priority_value_list}= Create List |
| ${sw_list}= Get Software Objects version_type=${version_type} |
| |
| :FOR ${index} IN @{sw_list} |
| \ ${priority_value}= |
| ... Read Software Attribute ${index} Priority |
| \ Append To List ${priority_value_list} ${priority_value} |
| |
| ${min_value}= Min List Value ${priority_value_list} |
| |
| [Return] ${min_value} |