text:  # Copyright 2019 Hewlett Packard Enterprise Development LP
   #
   # Licensed under the Apache License, Version 2.0 (the "License"); you may
   # not use this file except in compliance with the License. You may obtain
   # a copy of the License at
   #
   #      http://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
   # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
   # License for the specific language governing permissions and limitations
   # under the License.
  
  # -*- coding: utf-8 -*-
  """
  An example of setting an ISCSI boot instance for HPE iLO systems
  """
  
  import sys
  import json
  from redfish import RedfishClient
  from redfish.rest.v1 import ServerDownOrUnreachableError
  from ansible.module_utils.basic import *
  
  from get_resource_directory import get_resource_directory
  
  def set_bios_iscsi(_redfishobj, iscsi_properties):
  
      iscsi_uri = None
      iscsi_data = None
  
      resource_instances = get_resource_directory(_redfishobj)
      if DISABLE_RESOURCE_DIR or not resource_instances:
          #if we do not have a resource directory or want to force it's non use to find the
          #relevant URI
          systems_uri = _redfishobj.root.obj['Systems']['@odata.id']
          systems_response = _redfishobj.get(systems_uri)
          systems_members_uri = next(iter(systems_response.obj['Members']))['@odata.id']
          systems_members_response = _redfishobj.get(systems_members_uri)
          bios_uri = systems_members_response.obj['Bios']['@odata.id']
          bios_response = _redfishobj.get(bios_uri)
          iscsi_uri = bios_response.obj.Oem.Hpe.Links['iScsi']['@odata.id']
      else:
          #Use Resource directory to find the relevant URI
          for instance in resource_instances:
              if '#HpeiSCSISoftwareInitiator.' in instance['@odata.type']:
                  iscsi_uri = instance['@odata.id']
  
      if iscsi_uri:
          iscsi_data = _redfishobj.get(iscsi_uri)
          iscsi_settings_uri = iscsi_data.obj['@Redfish.Settings']['SettingsObject']['@odata.id']
          for inst, _ in enumerate(iscsi_data.obj['iSCSISources']):
              if iscsi_properties['iSCSIBootInstance'] == inst:
                  del iscsi_properties["iSCSIBootInstance"]
                  iscsi_data.dict['iSCSISources'][inst].update(iscsi_properties)
                  resp = _redfishobj.patch(iscsi_settings_uri, {'iSCSISources' : \
                                                                  iscsi_data.dict['iSCSISources']})
                  #If iLO responds with soemthing outside of 200 or 201 then lets check the
                  #iLO extended info error message to see what went wrong
                  if resp.status == 400:
                      try:
                          print(json.dumps(resp.obj['error']['@Message.ExtendedInfo'], \
                                                                          indent=4, sort_keys=True))
                      except Exception as excp:
                          print(json.dumps(resp.ori, indent=4, sort_keys=True))
                          sys.stderr.write("A response error occurred, unable to access iLO " \
                                           "Extended Message Info...")
                  elif resp.status != 200:
                      sys.stderr.write("An http response of \'%s\' was returned.\n" % resp.status)
                  else:
                      print("Success! A system reboot will be required to complete the change.\n")
                      print(json.dumps(resp.dict, indent=4, sort_keys=True))
                  break
  
  if __name__ == "__main__":
      module = AnsibleModule(
          argument_spec = dict(            
              name      = dict(required=True),
              enabled   = dict(required=True, type='bool')
          )
      )
  
      # When running remotely connect using the secured (https://) address,
      # account name, and password to send https requests
      # SYSTEM_URL acceptable examples:
      # "https://10.0.0.100"
      # "https://ilo.hostname"
      SYSTEM_URL = "blobstore://."
      LOGIN_ACCOUNT = "None"
      LOGIN_PASSWORD = "None"
  
      #iscsi properties
      ISCSI_PROPERTIES = {"iSCSIBootInstance": 2, \
                        "iSCSITargetName": "Target", \
                        "iSCSIAttemptName": "Empty", \
                        "iSCSIConnectRetry": 5}
      # flag to force disable resource directory. Resource directory and associated operations are
      # intended for HPE servers.
      DISABLE_RESOURCE_DIR = False
  
      try:
          # Create a Redfish client object
          REDFISHOBJ = RedfishClient(base_url=SYSTEM_URL, username=LOGIN_ACCOUNT, \
                                                                              password=LOGIN_PASSWORD)
          # Login with the Redfish client
          REDFISHOBJ.login()
      except ServerDownOrUnreachableError as excp:
          sys.stderr.write("ERROR: server not reachable or does not support RedFish.\n")
          sys.exit()
  
      set_bios_iscsi(REDFISHOBJ, ISCSI_PROPERTIES)
      REDFISHOBJ.logout()
      module.exit_json(changed=True)
  