idrac 0.1.38 → 0.1.41

data/lib/idrac/jobs.rb

@@ -0,0 +1,212 @@
+require 'json'
+require 'colorize'
+
+module IDRAC
+  module JobMethods
+    # Get a list of jobs
+    def jobs
+      response = authenticated_request(:get, '/redfish/v1/Managers/iDRAC.Embedded.1/Jobs?$expand=*($levels=1)')
+      
+      if response.status == 200
+        begin
+          jobs_data = JSON.parse(response.body)
+          puts "Jobs: #{jobs_data['Members'].count}"
+          if jobs_data['Members'].count > 0
+            puts "Job IDs:"
+            jobs_data["Members"].each do |job|
+              puts "  #{job['Id']}"
+            end
+          end
+          return jobs_data
+        rescue JSON::ParserError
+          raise Error, "Failed to parse jobs response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get jobs. Status code: #{response.status}"
+      end
+    end
+    
+    # Get detailed job information
+    def jobs_detail
+      response = authenticated_request(:get, '/redfish/v1/Managers/iDRAC.Embedded.1/Jobs?$expand=*($levels=1)')
+      
+      if response.status == 200
+        begin
+          jobs_data = JSON.parse(response.body)
+          jobs_data["Members"].each do |job| 
+            puts "#{job['Id']} : #{job['JobState']} > #{job['Message']}" 
+          end
+          return jobs_data
+        rescue JSON::ParserError
+          raise Error, "Failed to parse jobs detail response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get jobs detail. Status code: #{response.status}"
+      end
+    end
+    
+    # Clear all jobs from the job queue
+    def clear_jobs!
+      # Get list of jobs
+      jobs_response = authenticated_request(:get, '/redfish/v1/Managers/iDRAC.Embedded.1/Jobs?$expand=*($levels=1)')
+      
+      if jobs_response.status == 200
+        begin
+          jobs_data = JSON.parse(jobs_response.body)
+          members = jobs_data["Members"]
+          
+          # Delete each job individually
+          members.each.with_index do |job, i|
+            puts "Removing #{job['Id']} [#{i+1}/#{members.count}]"
+            delete_response = authenticated_request(:delete, "/redfish/v1/Managers/iDRAC.Embedded.1/Jobs/#{job['Id']}")
+            
+            unless delete_response.status.between?(200, 299)
+              puts "Warning: Failed to delete job #{job['Id']}. Status code: #{delete_response.status}".yellow
+            end
+          end
+          
+          puts "Successfully cleared all jobs".green
+          return true
+        rescue JSON::ParserError
+          raise Error, "Failed to parse jobs response: #{jobs_response.body}"
+        end
+      else
+        raise Error, "Failed to get jobs. Status code: #{jobs_response.status}"
+      end
+    end
+    
+    # Force clear the job queue
+    def force_clear_jobs!
+      # Clear the job queue using force option which will also clear any pending data and restart processes
+      path = '/redfish/v1/Dell/Managers/iDRAC.Embedded.1/DellJobService/Actions/DellJobService.DeleteJobQueue'
+      payload = { "JobID" => "JID_CLEARALL_FORCE" }
+      
+      response = authenticated_request(
+        :post, 
+        path, 
+        body: payload.to_json, 
+        headers: { 'Content-Type' => 'application/json' }
+      )
+      
+      if response.status.between?(200, 299)
+        puts "Successfully force-cleared job queue".green
+        
+        # Monitor LC status until it's Ready
+        puts "Waiting for LC status to be Ready..."
+        
+        retries = 12  # ~2 minutes with 10s sleep
+        while retries > 0
+          lc_response = authenticated_request(
+            :post, 
+            '/redfish/v1/Dell/Managers/iDRAC.Embedded.1/DellLCService/Actions/DellLCService.GetRemoteServicesAPIStatus',
+            body: {}.to_json, 
+            headers: { 'Content-Type': 'application/json' }
+          )
+          
+          if lc_response.status.between?(200, 299)
+            begin
+              lc_data = JSON.parse(lc_response.body)
+              status = lc_data["LCStatus"]
+              
+              if status == "Ready"
+                puts "LC Status is Ready".green
+                return true
+              end
+              
+              puts "Current LC Status: #{status}. Waiting..."
+            rescue JSON::ParserError
+              puts "Failed to parse LC status response, will retry...".yellow
+            end
+          end
+          
+          retries -= 1
+          sleep 10
+        end
+        
+        puts "Warning: LC status did not reach Ready state within timeout".yellow
+        return true
+      else
+        error_message = "Failed to force-clear job queue. Status code: #{response.status}"
+        
+        begin
+          error_data = JSON.parse(response.body)
+          error_message += ", Message: #{error_data['error']['message']}" if error_data['error'] && error_data['error']['message']
+        rescue
+          # Ignore JSON parsing errors
+        end
+        
+        raise Error, error_message
+      end
+    end
+    
+    # Wait for a job to complete
+    def wait_for_job(job_id)
+      # Job ID can be a job ID, path, or response hash from another request
+      job_path = if job_id.is_a?(Hash)
+                   if job_id['headers'] && job_id['headers']['location']
+                     job_id['headers']['location'].sub(/^\/redfish\/v1\//, '')
+                   else
+                     raise Error, "Invalid job hash, missing location header"
+                   end
+                 elsif job_id.to_s.start_with?('/redfish/v1/')
+                   job_id.sub(/^\/redfish\/v1\//, '')
+                 else
+                   "Managers/iDRAC.Embedded.1/Jobs/#{job_id}"
+                 end
+      
+      puts "Waiting for job to complete: #{job_id}".light_cyan
+      
+      retries = 36  # ~6 minutes with 10s sleep
+      while retries > 0
+        response = authenticated_request(:get, "/redfish/v1/#{job_path}")
+        
+        if response.status == 200
+          begin
+            job_data = JSON.parse(response.body)
+            job_state = job_data["JobState"]
+            
+            case job_state
+            when "Completed"
+              puts "Job completed successfully".green
+              return job_data
+            when "Failed"
+              puts "Job failed: #{job_data['Message']}".red
+              raise Error, "Job failed: #{job_data['Message']}"
+            when "CompletedWithErrors"
+              puts "Job completed with errors: #{job_data['Message']}".yellow
+              return job_data
+            end
+            
+            puts "Job state: #{job_state}. Waiting...".yellow
+          rescue JSON::ParserError
+            puts "Failed to parse job status response, will retry...".yellow
+          end
+        else
+          puts "Failed to get job status. Status code: #{response.status}".red
+        end
+        
+        retries -= 1
+        sleep 10
+      end
+      
+      raise Error, "Timeout waiting for job to complete"
+    end
+    
+    # Get system tasks
+    def tasks
+      response = authenticated_request(:get, '/redfish/v1/TaskService/Tasks')
+      
+      if response.status == 200
+        begin
+          tasks_data = JSON.parse(response.body)
+          # "Tasks: #{tasks_data['Members'].count}", 0 
+          return tasks_data['Members']
+        rescue JSON::ParserError
+          raise Error, "Failed to parse tasks response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get tasks. Status code: #{response.status}"
+      end
+    end
+  end
+end 

data/lib/idrac/lifecycle.rb

@@ -0,0 +1,300 @@
+require 'json'
+require 'colorize'
+
+module IDRAC
+  module LifecycleMethods
+    # Get the Lifecycle Controller status
+    def get_lifecycle_status
+      # Try first method (older iDRACs)
+      path1 = '/redfish/v1/Dell/Managers/iDRAC.Embedded.1/DellLCService/Actions/DellLCService.GetRemoteServicesAPIStatus'
+      
+      begin
+        response = authenticated_request(
+          :post, 
+          path1, 
+          body: {}.to_json, 
+          headers: { 'Content-Type' => 'application/json' }
+        )
+        
+        if response.status.between?(200, 299)
+          begin
+            lc_data = JSON.parse(response.body)
+            puts "LC Status: #{lc_data['LCStatus']}".light_cyan
+            return lc_data
+          rescue JSON::ParserError
+            # Fall through to alternative method
+          end
+        end
+      rescue => e
+        # Fall through to alternative method
+      end
+      
+      # Try alternative method (newer iDRACs)
+      path2 = '/redfish/v1/Managers/iDRAC.Embedded.1/Attributes'
+      
+      begin
+        response = authenticated_request(:get, path2)
+        
+        if response.status.between?(200, 299)
+          begin
+            attributes_data = JSON.parse(response.body)
+            
+            if attributes_data["Attributes"] && attributes_data["Attributes"]["LCAttributes.1.LifecycleControllerState"]
+              lifecycle_state = attributes_data["Attributes"]["LCAttributes.1.LifecycleControllerState"]
+              puts "Lifecycle Controller state: #{lifecycle_state}".light_cyan
+              return { "LCStatus" => lifecycle_state }
+            end
+          rescue JSON::ParserError
+            # Fall through to final error
+          end
+        end
+      rescue => e
+        # Fall through to final error
+      end
+
+      # If we get here, try one last approach - try to get iDRAC status
+      begin
+        response = authenticated_request(:get, '/redfish/v1/Managers/iDRAC.Embedded.1')
+        
+        if response.status.between?(200, 299)
+          begin
+            data = JSON.parse(response.body)
+            status = data["Status"] && data["Status"]["State"]
+            if status
+              puts "iDRAC State: #{status}".light_cyan
+              puts "Note: Could not retrieve direct LC status, showing iDRAC status instead".yellow
+              return { "iDRACStatus" => status }
+            end
+          rescue JSON::ParserError
+            # Fall through to final error
+          end
+        end
+      rescue => e
+        # Fall through to final error
+      end
+
+      # If we reached here, all methods failed
+      puts "Unable to retrieve Lifecycle Controller status through any available method".red
+      raise Error, "Failed to get Lifecycle Controller status through any available method"
+    end
+    
+    # Check if the Lifecycle Controller is enabled
+    def get_idrac_lifecycle_status
+      # Use the DellLCService GetRemoteServicesAPIStatus
+      path = '/redfish/v1/Dell/Managers/iDRAC.Embedded.1/DellLCService/Actions/DellLCService.GetRemoteServicesAPIStatus'
+      
+      response = authenticated_request(
+        :post, 
+        path, 
+        body: {}.to_json, 
+        headers: { 'Content-Type' => 'application/json' }
+      )
+      
+      if response.status.between?(200, 299)
+        begin
+          lc_data = JSON.parse(response.body)
+          status = lc_data["LCStatus"]
+          
+          debug "LC Status: #{status}", 1
+          
+          # Get the LCReplication status
+          attributes_path = "/redfish/v1/Managers/iDRAC.Embedded.1/Attributes"
+          attributes_response = authenticated_request(:get, attributes_path)
+          
+          if attributes_response.status == 200
+            begin
+              attributes_data = JSON.parse(attributes_response.body)
+              lc_replication = attributes_data["Attributes"]["ServiceModule.1.LCLReplication"]
+              
+              debug "ServiceModule.1.LCLReplication: #{lc_replication}", 1
+              
+              is_enabled = lc_replication == "Enabled"
+              
+              puts "Lifecycle Controller replication is #{is_enabled ? 'enabled' : 'disabled'}".light_cyan
+              puts "Lifecycle Controller status: #{status}".light_cyan
+              return is_enabled
+            rescue => e
+              debug "Error parsing attributes: #{e.message}", 1
+            end
+          end
+          
+          # If we can't determine from attributes, just return if LC is Ready
+          is_ready = status == "Ready"
+          puts "Lifecycle Controller is #{is_ready ? 'Ready' : status}".light_cyan
+          return is_ready
+        rescue JSON::ParserError
+          raise Error, "Failed to parse Lifecycle Controller status response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get Lifecycle Controller status. Status code: #{response.status}"
+      end
+    end
+    
+    # Set the Lifecycle Controller status (enable/disable)
+    def set_idrac_lifecycle_status(status)
+      enabled = !!status # Convert to boolean
+      
+      debug "Setting Lifecycle Controller status to #{enabled ? 'enabled' : 'disabled'}", 1
+      
+      # Use the attributes method to set the ServiceModule.1.LCLReplication
+      path = "/redfish/v1/Managers/iDRAC.Embedded.1/Attributes"
+      
+      # Create the payload with the attribute we want to modify
+      payload = {
+        "Attributes": {
+          "ServiceModule.1.LCLReplication": enabled ? "Enabled" : "Disabled"
+        }
+      }
+      
+      debug "Using attributes endpoint: #{path}", 1
+      debug "Payload: #{payload.inspect}", 1
+      
+      begin
+        response = authenticated_request(
+          :patch, 
+          path, 
+          body: payload.to_json,
+          headers: { 'Content-Type' => 'application/json' }
+        )
+        
+        debug "Response status: #{response.status}", 1
+        debug "Response body: #{response.body}", 2 if response.body
+        
+        if response.status.between?(200, 299)
+          puts "Successfully #{enabled ? 'enabled' : 'disabled'} Lifecycle Controller".green
+          return true
+        else
+          error_message = "Failed to set Lifecycle Controller status. Status code: #{response.status}"
+          
+          # Print the full response body for debugging
+          puts "Full error response body:".red
+          puts response.body.inspect.red
+          
+          begin
+            error_data = JSON.parse(response.body)
+            puts "Extended error information:".red if error_data['@Message.ExtendedInfo']
+            
+            if error_data['error'] && error_data['error']['message']
+              error_message += ", Message: #{error_data['error']['message']}"
+            end
+            
+            if error_data['@Message.ExtendedInfo']
+              error_data['@Message.ExtendedInfo'].each do |info|
+                puts "  Message: #{info['Message']}".red
+                puts "  Resolution: #{info['Resolution']}".yellow if info['Resolution']
+                puts "  Severity: #{info['Severity']}".yellow if info['Severity']
+                puts "  MessageId: #{info['MessageId']}".yellow if info['MessageId']
+              end
+              
+              if error_data['@Message.ExtendedInfo'].first
+                error_message += ", Message: #{error_data['@Message.ExtendedInfo'].first['Message']}"
+                error_message += ", Resolution: #{error_data['@Message.ExtendedInfo'].first['Resolution']}" if error_data['@Message.ExtendedInfo'].first['Resolution']
+              end
+            end
+          rescue => e
+            debug "Error parsing response: #{e.message}", 1
+            # Ignore JSON parsing errors
+          end
+          
+          raise Error, error_message
+        end
+      rescue => e
+        debug "Error in request: #{e.message}", 1
+        raise Error, "Failed to set Lifecycle Controller status: #{e.message}"
+      end
+    end
+    
+    # Ensure the Lifecycle Controller is enabled
+    def ensure_lifecycle_controller!
+      if !get_idrac_lifecycle_status
+        puts "Lifecycle Controller is disabled, enabling...".yellow
+        set_idrac_lifecycle_status(true)
+        
+        # Verify it was enabled
+        if !get_idrac_lifecycle_status
+          raise Error, "Failed to enable Lifecycle Controller"
+        end
+        
+        puts "Lifecycle Controller successfully enabled".green
+      else
+        puts "Lifecycle Controller is already enabled".green
+      end
+      
+      return true
+    end
+    
+    # Clear the Lifecycle log
+    def clear_lifecycle!
+      path = '/redfish/v1/Managers/iDRAC.Embedded.1/Oem/Dell/DellLCService/Actions/DellLCService.SystemErase'
+      payload = { "Component": ["LCData"] }
+      
+      response = authenticated_request(
+        :post, 
+        path, 
+        body: payload.to_json, 
+        headers: { 'Content-Type' => 'application/json' }
+      )
+      
+      if response.status.between?(200, 299)
+        puts "Lifecycle log cleared".green
+        return true
+      else
+        puts "Failed to clear Lifecycle log".red
+        
+        error_message = "Failed to clear Lifecycle log. Status code: #{response.status}"
+        
+        begin
+          error_data = JSON.parse(response.body)
+          error_message += ", Message: #{error_data['error']['message']}" if error_data['error'] && error_data['error']['message']
+        rescue
+          # Ignore JSON parsing errors
+        end
+        
+        raise Error, error_message
+      end
+    end
+    
+    # Get the system event logs
+    def get_system_event_logs
+      path = 'Managers/iDRAC.Embedded.1/Logs/Sel?$expand=*($levels=1)'
+      
+      response = authenticated_request(:get, path)
+      
+      if response.status == 200
+        begin
+          logs_data = JSON.parse(response.body)
+          return logs_data
+        rescue JSON::ParserError
+          raise Error, "Failed to parse system event logs response: #{response.body}"
+        end
+      else
+        raise Error, "Failed to get system event logs. Status code: #{response.status}"
+      end
+    end
+    
+    # Clear the system event logs
+    def clear_system_event_logs!
+      path = 'Managers/iDRAC.Embedded.1/LogServices/Sel/Actions/LogService.ClearLog'
+      
+      response = authenticated_request(:post, path, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+      
+      if response.status.between?(200, 299)
+        puts "System Event Logs cleared".green
+        return true
+      else
+        puts "Failed to clear System Event Logs".red
+        
+        error_message = "Failed to clear System Event Logs. Status code: #{response.status}"
+        
+        begin
+          error_data = JSON.parse(response.body)
+          error_message += ", Message: #{error_data['error']['message']}" if error_data['error'] && error_data['error']['message']
+        rescue
+          # Ignore JSON parsing errors
+        end
+        
+        raise Error, error_message
+      end
+    end
+  end
+end