| #!/usr/bin/env python |
| |
| r""" |
| This module contains functions having to do with machine state: get_state, |
| check_state, wait_state, etc. |
| |
| The 'State' is a composite of many pieces of data. Therefore, the functions |
| in this module define state as an ordered dictionary. Here is an example of |
| some test output showing machine state: |
| |
| default_state: |
| default_state[chassis]: On |
| default_state[boot_progress]: OSStart |
| default_state[operating_system]: BootComplete |
| default_state[host]: Running |
| default_state[os_ping]: 1 |
| default_state[os_login]: 1 |
| default_state[os_run_cmd]: 1 |
| |
| Different users may very well have different needs when inquiring about |
| state. Support for new pieces of state information may be added to this |
| module as needed. |
| |
| By using the wait_state function, a caller can start a boot and then wait for |
| a precisely defined state to indicate that the boot has succeeded. If |
| the boot fails, they can see exactly why by looking at the current state as |
| compared with the expected state. |
| """ |
| |
| import gen_print as gp |
| import gen_valid as gv |
| import gen_robot_utils as gru |
| import gen_cmd as gc |
| import bmc_ssh_utils as bsu |
| |
| from robot.libraries.BuiltIn import BuiltIn |
| from robot.utils import DotDict |
| |
| import re |
| import os |
| import sys |
| import imp |
| |
| |
| # NOTE: Avoid importing utils.robot because utils.robot imports state.py |
| # (indirectly) which will cause failures. |
| gru.my_import_resource("rest_client.robot") |
| |
| base_path = os.path.dirname(os.path.dirname( |
| imp.find_module("gen_robot_print")[1])) + os.sep |
| sys.path.append(base_path + "data/") |
| |
| # Previously, I had this coded: |
| # import variables as var |
| # However, we ran into a problem where a robot program did this... |
| # Variables ../../lib/ras/variables.py |
| # Prior to doing this... |
| # Library ../lib/state.py |
| |
| # This caused the wrong variables.py file to be selected. Attempts to fix this |
| # have failed so far. For the moment, we will hard-code the value we need from |
| # the file. |
| |
| SYSTEM_STATE_URI = "/xyz/openbmc_project/state/" |
| |
| # The BMC code has recently been changed as far as what states are defined and |
| # what the state values can be. This module now has a means of processing both |
| # the old style state (i.e. OBMC_STATES_VERSION = 0) and the new style (i.e. |
| # OBMC_STATES_VERSION = 1). |
| # The caller can set environment variable OBMC_STATES_VERSION to dictate |
| # whether we're processing old or new style states. If OBMC_STATES_VERSION is |
| # not set it will default to 1. |
| |
| # As of the present moment, OBMC_STATES_VERSION of 0 is for cold that is so old |
| # that it is no longer worthwhile to maintain. The OBMC_STATES_VERSION 0 code |
| # is being removed but the OBMC_STATES_VERSION value will stay for now in the |
| # event that it is needed in the future. |
| |
| OBMC_STATES_VERSION = int(os.environ.get('OBMC_STATES_VERSION', 1)) |
| |
| # When a user calls get_state w/o specifying req_states, default_req_states |
| # is used as its value. |
| default_req_states = ['rest', |
| 'chassis', |
| 'bmc', |
| 'boot_progress', |
| 'operating_system', |
| 'host', |
| 'os_ping', |
| 'os_login', |
| 'os_run_cmd'] |
| |
| # valid_req_states is a list of sub states supported by the get_state function. |
| # valid_req_states, default_req_states and master_os_up_match are used by the |
| # get_state function. |
| valid_req_states = ['ping', |
| 'packet_loss', |
| 'uptime', |
| 'epoch_seconds', |
| 'rest', |
| 'chassis', |
| 'requested_chassis', |
| 'bmc', |
| 'requested_bmc', |
| 'boot_progress', |
| 'operating_system', |
| 'host', |
| 'requested_host', |
| 'attempts_left', |
| 'os_ping', |
| 'os_login', |
| 'os_run_cmd'] |
| |
| # valid_os_req_states and default_os_req_states are used by the os_get_state |
| # function. |
| # valid_os_req_states is a list of state information supported by the |
| # get_os_state function. |
| valid_os_req_states = ['os_ping', |
| 'os_login', |
| 'os_run_cmd'] |
| # When a user calls get_os_state w/o specifying req_states, |
| # default_os_req_states is used as its value. |
| default_os_req_states = ['os_ping', |
| 'os_login', |
| 'os_run_cmd'] |
| |
| # Presently, some BMCs appear to not keep time very well. This environment |
| # variable directs the get_state function to use either the BMC's epoch time |
| # or the local epoch time. |
| USE_BMC_EPOCH_TIME = int(os.environ.get('USE_BMC_EPOCH_TIME', 0)) |
| |
| # Useful state constant definition(s). |
| # default_state is an initial value which may be of use to callers. |
| default_state = DotDict([('rest', '1'), |
| ('chassis', 'On'), |
| ('bmc', 'Ready'), |
| ('boot_progress', 'OSStart'), |
| ('operating_system', 'BootComplete'), |
| ('host', 'Running'), |
| ('os_ping', '1'), |
| ('os_login', '1'), |
| ('os_run_cmd', '1')]) |
| |
| # A match state for checking that the system is at "standby". |
| standby_match_state = DotDict([('rest', '^1$'), |
| ('chassis', '^Off$'), |
| ('bmc', '^Ready$'), |
| ('boot_progress', '^Off|Unspecified$'), |
| ('operating_system', '^Inactive$'), |
| ('host', '^Off$')]) |
| |
| # A match state for checking that the system is at "os running". |
| os_running_match_state = DotDict([('chassis', '^On$'), |
| ('bmc', '^Ready$'), |
| ('boot_progress', |
| 'FW Progress, Starting OS|OSStart'), |
| ('operating_system', 'BootComplete'), |
| ('host', '^Running$'), |
| ('os_ping', '^1$'), |
| ('os_login', '^1$'), |
| ('os_run_cmd', '^1$')]) |
| |
| # A master dictionary to determine whether the os may be up. |
| master_os_up_match = DotDict([('chassis', '^On$'), |
| ('bmc', '^Ready$'), |
| ('boot_progress', |
| 'FW Progress, Starting OS|OSStart'), |
| ('operating_system', 'BootComplete'), |
| ('host', '^Running|Quiesced$')]) |
| |
| invalid_state_match = DotDict([('rest', '^$'), |
| ('chassis', '^$'), |
| ('bmc', '^$'), |
| ('boot_progress', '^$'), |
| ('operating_system', '^$'), |
| ('host', '^$')]) |
| |
| |
| def return_state_constant(state_name='default_state'): |
| r""" |
| Return the named state dictionary constant. |
| """ |
| |
| return eval(state_name) |
| |
| |
| def anchor_state(state): |
| r""" |
| Add regular expression anchors ("^" and "$") to the beginning and end of |
| each item in the state dictionary passed in. Return the resulting |
| dictionary. |
| |
| Description of Arguments: |
| state A dictionary such as the one returned by the get_state() |
| function. |
| """ |
| |
| anchored_state = state.copy() |
| for key, match_state_value in anchored_state.items(): |
| anchored_state[key] = "^" + str(anchored_state[key]) + "$" |
| |
| return anchored_state |
| |
| |
| def strip_anchor_state(state): |
| r""" |
| Strip regular expression anchors ("^" and "$") from the beginning and end |
| of each item in the state dictionary passed in. Return the resulting |
| dictionary. |
| |
| Description of Arguments: |
| state A dictionary such as the one returned by the get_state() |
| function. |
| """ |
| |
| stripped_state = state.copy() |
| for key, match_state_value in stripped_state.items(): |
| stripped_state[key] = stripped_state[key].strip("^$") |
| |
| return stripped_state |
| |
| |
| def compare_states(state, |
| match_state, |
| match_type='and'): |
| r""" |
| Compare 2 state dictionaries. Return True if they match and False if they |
| don't. Note that the match_state dictionary does not need to have an entry |
| corresponding to each entry in the state dictionary. But for each entry |
| that it does have, the corresponding state entry will be checked for a |
| match. |
| |
| Description of arguments: |
| state A state dictionary such as the one returned by the |
| get_state function. |
| match_state A dictionary whose key/value pairs are "state field"/ |
| "state value". The state value is interpreted as a |
| regular expression. Every value in this dictionary is |
| considered. When match_type is 'and', if each and every |
| comparison matches, the two dictionaries are considered to |
| be matching. If match_type is 'or', if any two of the |
| elements compared match, the two dictionaries are |
| considered to be matching. |
| This value may also be any string accepted by |
| return_state_constant (e.g. "standby_match_state"). |
| In such a case this function will call |
| return_state_constant to convert it to a proper |
| dictionary as described above. |
| match_type This may be 'and' or 'or'. |
| """ |
| |
| error_message = gv.svalid_value(match_type, var_name="match_type", |
| valid_values=['and', 'or']) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| try: |
| match_state = return_state_constant(match_state) |
| except TypeError: |
| pass |
| |
| default_match = (match_type == 'and') |
| for key, match_state_value in match_state.items(): |
| # Blank match_state_value means "don't care". |
| if match_state_value == "": |
| continue |
| try: |
| match = (re.match(match_state_value, str(state[key])) is not None) |
| except KeyError: |
| match = False |
| |
| if match != default_match: |
| return match |
| |
| return default_match |
| |
| |
| def get_os_state(os_host="", |
| os_username="", |
| os_password="", |
| req_states=default_os_req_states, |
| os_up=True, |
| quiet=None): |
| r""" |
| Get component states for the operating system such as ping, login, |
| etc, put them into a dictionary and return them to the caller. |
| |
| Note that all substate values are strings. |
| |
| Description of arguments: |
| os_host The DNS name or IP address of the operating system. |
| This defaults to global ${OS_HOST}. |
| os_username The username to be used to login to the OS. |
| This defaults to global ${OS_USERNAME}. |
| os_password The password to be used to login to the OS. |
| This defaults to global ${OS_PASSWORD}. |
| req_states This is a list of states whose values are being requested by |
| the caller. |
| os_up If the caller knows that the os can't possibly be up, it can |
| improve performance by passing os_up=False. This function |
| will then simply return default values for all requested os |
| sub states. |
| quiet Indicates whether status details (e.g. curl commands) should |
| be written to the console. |
| Defaults to either global value of ${QUIET} or to 1. |
| """ |
| |
| quiet = int(gp.get_var_value(quiet, 0)) |
| |
| # Set parm defaults where necessary and validate all parms. |
| if os_host == "": |
| os_host = BuiltIn().get_variable_value("${OS_HOST}") |
| error_message = gv.svalid_value(os_host, var_name="os_host", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| if os_username == "": |
| os_username = BuiltIn().get_variable_value("${OS_USERNAME}") |
| error_message = gv.svalid_value(os_username, var_name="os_username", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| if os_password == "": |
| os_password = BuiltIn().get_variable_value("${OS_PASSWORD}") |
| error_message = gv.svalid_value(os_password, var_name="os_password", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| invalid_req_states = [sub_state for sub_state in req_states |
| if sub_state not in valid_os_req_states] |
| if len(invalid_req_states) > 0: |
| error_message = "The following req_states are not supported:\n" +\ |
| gp.sprint_var(invalid_req_states) |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| # Initialize all substate values supported by this function. |
| os_ping = 0 |
| os_login = 0 |
| os_run_cmd = 0 |
| |
| if os_up: |
| if 'os_ping' in req_states: |
| # See if the OS pings. |
| rc, out_buf = gc.shell_cmd("ping -c 1 -w 2 " + os_host, |
| print_output=0, show_err=0, |
| ignore_err=1) |
| if rc == 0: |
| os_ping = 1 |
| |
| # Programming note: All attributes which do not require an ssh login |
| # should have been processed by this point. |
| master_req_login = ['os_login', 'os_run_cmd'] |
| req_login = [sub_state for sub_state in req_states if sub_state in |
| master_req_login] |
| must_login = (len(req_login) > 0) |
| |
| if must_login: |
| output, stderr, rc = bsu.os_execute_command("uptime", quiet=quiet, |
| ignore_err=1, |
| time_out=20) |
| if rc == 0: |
| os_login = 1 |
| os_run_cmd = 1 |
| else: |
| gp.dprint_vars(output, stderr) |
| gp.dprint_vars(rc, 1) |
| |
| os_state = DotDict() |
| for sub_state in req_states: |
| cmd_buf = "os_state['" + sub_state + "'] = str(" + sub_state + ")" |
| exec(cmd_buf) |
| |
| return os_state |
| |
| |
| def get_state(openbmc_host="", |
| openbmc_username="", |
| openbmc_password="", |
| os_host="", |
| os_username="", |
| os_password="", |
| req_states=default_req_states, |
| quiet=None): |
| r""" |
| Get component states such as chassis state, bmc state, etc, put them into a |
| dictionary and return them to the caller. |
| |
| Note that all substate values are strings. |
| |
| Description of arguments: |
| openbmc_host The DNS name or IP address of the BMC. |
| This defaults to global ${OPENBMC_HOST}. |
| openbmc_username The username to be used to login to the BMC. |
| This defaults to global ${OPENBMC_USERNAME}. |
| openbmc_password The password to be used to login to the BMC. |
| This defaults to global ${OPENBMC_PASSWORD}. |
| os_host The DNS name or IP address of the operating system. |
| This defaults to global ${OS_HOST}. |
| os_username The username to be used to login to the OS. |
| This defaults to global ${OS_USERNAME}. |
| os_password The password to be used to login to the OS. |
| This defaults to global ${OS_PASSWORD}. |
| req_states This is a list of states whose values are being requested |
| by the caller. |
| quiet Indicates whether status details (e.g. curl commands) |
| should be written to the console. |
| Defaults to either global value of ${QUIET} or to 1. |
| """ |
| |
| quiet = int(gp.get_var_value(quiet, 0)) |
| |
| # Set parm defaults where necessary and validate all parms. |
| if openbmc_host == "": |
| openbmc_host = BuiltIn().get_variable_value("${OPENBMC_HOST}") |
| error_message = gv.svalid_value(openbmc_host, |
| var_name="openbmc_host", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| if openbmc_username == "": |
| openbmc_username = BuiltIn().get_variable_value("${OPENBMC_USERNAME}") |
| error_message = gv.svalid_value(openbmc_username, |
| var_name="openbmc_username", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| if openbmc_password == "": |
| openbmc_password = BuiltIn().get_variable_value("${OPENBMC_PASSWORD}") |
| error_message = gv.svalid_value(openbmc_password, |
| var_name="openbmc_password", |
| invalid_values=[None, ""]) |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| # NOTE: OS parms are optional. |
| if os_host == "": |
| os_host = BuiltIn().get_variable_value("${OS_HOST}") |
| if os_host is None: |
| os_host = "" |
| |
| if os_username is "": |
| os_username = BuiltIn().get_variable_value("${OS_USERNAME}") |
| if os_username is None: |
| os_username = "" |
| |
| if os_password is "": |
| os_password = BuiltIn().get_variable_value("${OS_PASSWORD}") |
| if os_password is None: |
| os_password = "" |
| |
| invalid_req_states = [sub_state for sub_state in req_states |
| if sub_state not in valid_req_states] |
| if len(invalid_req_states) > 0: |
| error_message = "The following req_states are not supported:\n" +\ |
| gp.sprint_var(invalid_req_states) |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| # Initialize all substate values supported by this function. |
| ping = 0 |
| packet_loss = '' |
| uptime = '' |
| epoch_seconds = '' |
| rest = '' |
| chassis = '' |
| requested_chassis = '' |
| bmc = '' |
| requested_bmc = '' |
| boot_progress = '' |
| operating_system = '' |
| host = '' |
| requested_host = '' |
| attempts_left = '' |
| |
| # Get the component states. |
| if 'ping' in req_states: |
| # See if the OS pings. |
| rc, out_buf = gc.shell_cmd("ping -c 1 -w 2 " + openbmc_host, |
| print_output=0, show_err=0, |
| ignore_err=1) |
| if rc == 0: |
| ping = 1 |
| |
| if 'packet_loss' in req_states: |
| # See if the OS pings. |
| cmd_buf = "ping -c 5 -w 5 " + openbmc_host +\ |
| " | egrep 'packet loss' | sed -re 's/.* ([0-9]+)%.*/\\1/g'" |
| rc, out_buf = gc.shell_cmd(cmd_buf, |
| print_output=0, show_err=0, |
| ignore_err=1) |
| if rc == 0: |
| packet_loss = out_buf.rstrip("\n") |
| |
| if 'uptime' in req_states: |
| # Sometimes reading uptime results in a blank value. Call with |
| # wait_until_keyword_succeeds to ensure a non-blank value is obtained. |
| remote_cmd_buf = "read uptime filler 2>/dev/null < /proc/uptime" +\ |
| " && [ ! -z \"${uptime}\" ] && echo ${uptime}" |
| cmd_buf = ["BMC Execute Command", |
| re.sub('\\$', '\\$', remote_cmd_buf), 'quiet=1', |
| 'test_mode=0'] |
| gp.print_issuing(cmd_buf, 0) |
| gp.print_issuing(remote_cmd_buf, 0) |
| try: |
| stdout, stderr, rc =\ |
| BuiltIn().wait_until_keyword_succeeds("10 sec", "0 sec", |
| *cmd_buf) |
| if rc == 0 and stderr == "": |
| uptime = stdout |
| except AssertionError as my_assertion_error: |
| pass |
| |
| if 'epoch_seconds' in req_states: |
| date_cmd_buf = "date -u +%s" |
| if USE_BMC_EPOCH_TIME: |
| cmd_buf = ["BMC Execute Command", date_cmd_buf, 'quiet=${1}'] |
| if not quiet: |
| gp.print_issuing(cmd_buf) |
| status, ret_values = \ |
| BuiltIn().run_keyword_and_ignore_error(*cmd_buf) |
| if status == "PASS": |
| stdout, stderr, rc = ret_values |
| if rc == 0 and stderr == "": |
| epoch_seconds = stdout.rstrip("\n") |
| else: |
| shell_rc, out_buf = gc.cmd_fnc_u(date_cmd_buf, |
| quiet=quiet, |
| print_output=0) |
| if shell_rc == 0: |
| epoch_seconds = out_buf.rstrip("\n") |
| |
| master_req_rest = ['rest', 'host', 'requested_host', 'operating_system', |
| 'attempts_left', 'boot_progress', 'chassis', |
| 'requested_chassis' 'bmc' 'requested_bmc'] |
| |
| req_rest = [sub_state for sub_state in req_states if sub_state in |
| master_req_rest] |
| need_rest = (len(req_rest) > 0) |
| state = DotDict() |
| if need_rest: |
| cmd_buf = ["Read Properties", SYSTEM_STATE_URI + "enumerate", |
| "quiet=${" + str(quiet) + "}"] |
| gp.dprint_issuing(cmd_buf) |
| status, ret_values = \ |
| BuiltIn().run_keyword_and_ignore_error(*cmd_buf) |
| if status == "PASS": |
| state['rest'] = '1' |
| else: |
| state['rest'] = '0' |
| |
| if int(state['rest']): |
| for url_path in ret_values: |
| for attr_name in ret_values[url_path]: |
| # Create a state key value based on the attr_name. |
| try: |
| ret_values[url_path][attr_name] = \ |
| re.sub(r'.*\.', "", |
| ret_values[url_path][attr_name]) |
| except TypeError: |
| pass |
| # Do some key name manipulations. |
| new_attr_name = re.sub(r'^Current|(State|Transition)$', |
| "", attr_name) |
| new_attr_name = re.sub(r'BMC', r'Bmc', new_attr_name) |
| new_attr_name = re.sub(r'([A-Z][a-z])', r'_\1', |
| new_attr_name) |
| new_attr_name = new_attr_name.lower().lstrip("_") |
| new_attr_name = re.sub(r'power', r'chassis', new_attr_name) |
| if new_attr_name in req_states: |
| state[new_attr_name] = ret_values[url_path][attr_name] |
| |
| for sub_state in req_states: |
| if sub_state in state: |
| continue |
| if sub_state.startswith("os_"): |
| # We pass "os_" requests on to get_os_state. |
| continue |
| cmd_buf = "state['" + sub_state + "'] = str(" + sub_state + ")" |
| exec(cmd_buf) |
| |
| if os_host == "": |
| # The caller has not specified an os_host so as far as we're concerned, |
| # it doesn't exist. |
| return state |
| |
| os_req_states = [sub_state for sub_state in req_states |
| if sub_state.startswith('os_')] |
| |
| if len(os_req_states) > 0: |
| # The caller has specified an os_host and they have requested |
| # information on os substates. |
| |
| # Based on the information gathered on bmc, we'll try to make a |
| # determination of whether the os is even up. We'll pass the result |
| # of that assessment to get_os_state to enhance performance. |
| os_up_match = DotDict() |
| for sub_state in master_os_up_match: |
| if sub_state in req_states: |
| os_up_match[sub_state] = master_os_up_match[sub_state] |
| os_up = compare_states(state, os_up_match) |
| os_state = get_os_state(os_host=os_host, |
| os_username=os_username, |
| os_password=os_password, |
| req_states=os_req_states, |
| os_up=os_up, |
| quiet=quiet) |
| # Append os_state dictionary to ours. |
| state.update(os_state) |
| |
| return state |
| |
| |
| exit_wait_early_message = "" |
| |
| |
| def set_exit_wait_early_message(value): |
| r""" |
| Set global exit_wait_early_message to the indicated value. |
| |
| This is a mechanism by which the programmer can do an early exit from |
| wait_until_keyword_succeeds() based on some special condition. |
| |
| Description of argument(s): |
| value The value to assign to the global |
| exit_wait_early_message. |
| """ |
| |
| global exit_wait_early_message |
| exit_wait_early_message = value |
| |
| |
| def check_state(match_state, |
| invert=0, |
| print_string="", |
| openbmc_host="", |
| openbmc_username="", |
| openbmc_password="", |
| os_host="", |
| os_username="", |
| os_password="", |
| quiet=None): |
| r""" |
| Check that the Open BMC machine's composite state matches the specified |
| state. On success, this keyword returns the machine's composite state as a |
| dictionary. |
| |
| Description of arguments: |
| match_state A dictionary whose key/value pairs are "state field"/ |
| "state value". The state value is interpreted as a |
| regular expression. Example call from robot: |
| ${match_state}= Create Dictionary chassis=^On$ |
| ... bmc=^Ready$ |
| ... boot_progress=^OSStart$ |
| ${state}= Check State &{match_state} |
| invert If this flag is set, this function will succeed if the |
| states do NOT match. |
| print_string This function will print this string to the console prior |
| to getting the state. |
| openbmc_host The DNS name or IP address of the BMC. |
| This defaults to global ${OPENBMC_HOST}. |
| openbmc_username The username to be used to login to the BMC. |
| This defaults to global ${OPENBMC_USERNAME}. |
| openbmc_password The password to be used to login to the BMC. |
| This defaults to global ${OPENBMC_PASSWORD}. |
| os_host The DNS name or IP address of the operating system. |
| This defaults to global ${OS_HOST}. |
| os_username The username to be used to login to the OS. |
| This defaults to global ${OS_USERNAME}. |
| os_password The password to be used to login to the OS. |
| This defaults to global ${OS_PASSWORD}. |
| quiet Indicates whether status details should be written to the |
| console. Defaults to either global value of ${QUIET} or |
| to 1. |
| """ |
| |
| quiet = int(gp.get_var_value(quiet, 0)) |
| |
| gp.gp_print(print_string) |
| |
| try: |
| match_state = return_state_constant(match_state) |
| except TypeError: |
| pass |
| |
| req_states = match_state.keys() |
| # Initialize state. |
| state = get_state(openbmc_host=openbmc_host, |
| openbmc_username=openbmc_username, |
| openbmc_password=openbmc_password, |
| os_host=os_host, |
| os_username=os_username, |
| os_password=os_password, |
| req_states=req_states, |
| quiet=quiet) |
| if not quiet: |
| gp.print_var(state) |
| |
| if exit_wait_early_message != "": |
| # The exit_wait_early_message has been set by a signal handler so we |
| # will exit "successfully". It is incumbent upon the calling function |
| # (e.g. wait_state) to check/clear this variable and to fail |
| # appropriately. |
| return state |
| |
| match = compare_states(state, match_state) |
| |
| if invert and match: |
| fail_msg = "The current state of the machine matches the match" +\ |
| " state:\n" + gp.sprint_varx("state", state) |
| BuiltIn().fail("\n" + gp.sprint_error(fail_msg)) |
| elif not invert and not match: |
| fail_msg = "The current state of the machine does NOT match the" +\ |
| " match state:\n" +\ |
| gp.sprint_varx("state", state) |
| BuiltIn().fail("\n" + gp.sprint_error(fail_msg)) |
| |
| return state |
| |
| |
| def wait_state(match_state=(), |
| wait_time="1 min", |
| interval="1 second", |
| invert=0, |
| openbmc_host="", |
| openbmc_username="", |
| openbmc_password="", |
| os_host="", |
| os_username="", |
| os_password="", |
| quiet=None): |
| r""" |
| Wait for the Open BMC machine's composite state to match the specified |
| state. On success, this keyword returns the machine's composite state as |
| a dictionary. |
| |
| Description of arguments: |
| match_state A dictionary whose key/value pairs are "state field"/ |
| "state value". See check_state (above) for details. |
| This value may also be any string accepted by |
| return_state_constant (e.g. "standby_match_state"). |
| In such a case this function will call |
| return_state_constant to convert it to a proper |
| dictionary as described above. |
| wait_time The total amount of time to wait for the desired state. |
| This value may be expressed in Robot Framework's time |
| format (e.g. 1 minute, 2 min 3 s, 4.5). |
| interval The amount of time between state checks. |
| This value may be expressed in Robot Framework's time |
| format (e.g. 1 minute, 2 min 3 s, 4.5). |
| invert If this flag is set, this function will for the state of |
| the machine to cease to match the match state. |
| openbmc_host The DNS name or IP address of the BMC. |
| This defaults to global ${OPENBMC_HOST}. |
| openbmc_username The username to be used to login to the BMC. |
| This defaults to global ${OPENBMC_USERNAME}. |
| openbmc_password The password to be used to login to the BMC. |
| This defaults to global ${OPENBMC_PASSWORD}. |
| os_host The DNS name or IP address of the operating system. |
| This defaults to global ${OS_HOST}. |
| os_username The username to be used to login to the OS. |
| This defaults to global ${OS_USERNAME}. |
| os_password The password to be used to login to the OS. |
| This defaults to global ${OS_PASSWORD}. |
| quiet Indicates whether status details should be written to the |
| console. Defaults to either global value of ${QUIET} or |
| to 1. |
| """ |
| |
| quiet = int(gp.get_var_value(quiet, 0)) |
| |
| try: |
| match_state = return_state_constant(match_state) |
| except TypeError: |
| pass |
| |
| if not quiet: |
| if invert: |
| alt_text = "cease to " |
| else: |
| alt_text = "" |
| gp.print_timen("Checking every " + str(interval) + " for up to " |
| + str(wait_time) + " for the state of the machine to " |
| + alt_text + "match the state shown below.") |
| gp.print_var(match_state) |
| |
| if quiet: |
| print_string = "" |
| else: |
| print_string = "#" |
| |
| debug = int(BuiltIn().get_variable_value("${debug}", "0")) |
| if debug: |
| # In debug we print state so no need to print the "#". |
| print_string = "" |
| check_state_quiet = 1 - debug |
| cmd_buf = ["Check State", match_state, "invert=${" + str(invert) + "}", |
| "print_string=" + print_string, "openbmc_host=" + openbmc_host, |
| "openbmc_username=" + openbmc_username, |
| "openbmc_password=" + openbmc_password, "os_host=" + os_host, |
| "os_username=" + os_username, "os_password=" + os_password, |
| "quiet=${" + str(check_state_quiet) + "}"] |
| gp.dprint_issuing(cmd_buf) |
| try: |
| state = BuiltIn().wait_until_keyword_succeeds(wait_time, interval, |
| *cmd_buf) |
| except AssertionError as my_assertion_error: |
| gp.printn() |
| message = my_assertion_error.args[0] |
| BuiltIn().fail(message) |
| |
| if exit_wait_early_message: |
| # The global exit_wait_early_message was set by a signal handler |
| # indicating that we should fail. |
| message = exit_wait_early_message |
| # Clear the exit_wait_early_message variable for future use. |
| set_exit_wait_early_message("") |
| BuiltIn().fail(gp.sprint_error(message)) |
| |
| if not quiet: |
| gp.printn() |
| if invert: |
| gp.print_timen("The states no longer match:") |
| else: |
| gp.print_timen("The states match:") |
| gp.print_var(state) |
| |
| return state |
| |
| |
| def wait_for_comm_cycle(start_boot_seconds, |
| quiet=None): |
| r""" |
| Wait for communications to the BMC to stop working and then resume working. |
| This function is useful when you have initiated some kind of reboot. |
| |
| Description of arguments: |
| start_boot_seconds The time that the boot test started. The format is the |
| epoch time in seconds, i.e. the number of seconds since |
| 1970-01-01 00:00:00 UTC. This value should be obtained |
| from the BMC so that it is not dependent on any kind of |
| synchronization between this machine and the target BMC |
| This will allow this program to work correctly even in |
| a simulated environment. This value should be obtained |
| by the caller prior to initiating a reboot. It can be |
| obtained as follows: |
| state = st.get_state(req_states=['epoch_seconds']) |
| """ |
| |
| quiet = int(gp.get_var_value(quiet, 0)) |
| |
| # Validate parms. |
| error_message = gv.svalid_integer(start_boot_seconds, |
| var_name="start_boot_seconds") |
| if error_message != "": |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| match_state = anchor_state(DotDict([('packet_loss', '100')])) |
| # Wait for 100% packet loss trying to ping machine. |
| wait_state(match_state, wait_time="8 mins", interval="0 seconds") |
| |
| match_state['packet_loss'] = '^0$' |
| # Wait for 0% packet loss trying to ping machine. |
| wait_state(match_state, wait_time="8 mins", interval="0 seconds") |
| |
| # Get the uptime and epoch seconds for comparisons. We want to be sure |
| # that the uptime is less than the elapsed boot time. Further proof that |
| # a reboot has indeed occurred (vs random network instability giving a |
| # false positive. We also use wait_state because the BMC may take a short |
| # while to be ready to process SSH requests. |
| match_state = DotDict([('uptime', '^[0-9\\.]+$'), |
| ('epoch_seconds', '^[0-9]+$')]) |
| state = wait_state(match_state, wait_time="2 mins", interval="1 second") |
| |
| elapsed_boot_time = int(state['epoch_seconds']) - start_boot_seconds |
| gp.qprint_var(elapsed_boot_time) |
| if state['uptime'] == "": |
| error_message = "Unable to obtain uptime from the BMC. BMC is not" +\ |
| " communicating." |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| if int(float(state['uptime'])) < elapsed_boot_time: |
| uptime = state['uptime'] |
| gp.qprint_var(uptime) |
| gp.qprint_timen("The uptime is less than the elapsed boot time," |
| + " as expected.") |
| else: |
| error_message = "The uptime is greater than the elapsed boot time," +\ |
| " which is unexpected:\n" +\ |
| gp.sprint_var(start_boot_seconds) +\ |
| gp.sprint_var(state) |
| BuiltIn().fail(gp.sprint_error(error_message)) |
| |
| gp.qprint_timen("Verifying that REST API interface is working.") |
| match_state = DotDict([('rest', '^1$')]) |
| state = wait_state(match_state, wait_time="5 mins", interval="2 seconds") |