idrac 0.1.3 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64086a691b3fd5b5811d7d69d40697a72cf7467b6162e3a83fd0eb717f040005
-  data.tar.gz: a7449f049f549858c740dc59ca3c931a3c670c4a99142ef808cec85f29d12e56
+  metadata.gz: 7861b7c63381663cd3f744ddeaf04f8dc05834511dd7d603890737df1f1d0e42
+  data.tar.gz: 10527f9d3a9247578727e6c50c4717427c676b4d9ff553b9cfa7d9ebf85f1e7b
 SHA512:
-  metadata.gz: 13ddf72ffd57083293314dc546ba68b0e0a70c506fa8c9385d5c37a41301aaa2adf4f7c010c49777cca489e71abba4847f23c026c56373f0ee928e4f2c5c50ae
-  data.tar.gz: c2cb2c1396a8f78e7cb6ed5d9921777a090331c8a5ac24b09169af945b9610d852cc55b7156c2e01298440e1d66587abbf18b0c5977b403decbfe784159e0231
+  metadata.gz: 4b49ca40714ed11052d56d79cdf5b9b79d3a3006ca34a8fccc8b2d04cfd3323dcfcde3463aaf80ef7a4ce0ad5700f48fbb4e51d77a5c92b9a7783bdbcea2cd8b
+  data.tar.gz: 4ee880173ba0a0b477fb2f70fc81ebabd6586778985198f7e52e46c09460b50bd0dcbab97cb3234ea33e1cb065fb8afa238b574607d16c92db734e0884f0ae89

data/README.md

@@ -1,24 +1,96 @@
-# Idrac
+# IDRAC
 
-TODO: Delete this and the text below, and describe your gem
+A Ruby client for the Dell iDRAC API. This gem provides a command-line interface and a Ruby API for interacting with Dell iDRAC servers.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/idrac`. To experiment with that code, run `bin/console` for an interactive prompt.
+## Features
+
+- Take screenshots of the iDRAC console
+- Update firmware using Dell's catalog
+- Check for firmware updates
+- Interactive firmware update process
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'idrac'
+```
 
-Install the gem and add to the application's Gemfile by executing:
+And then execute:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    $ bundle install
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or install it yourself as:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    $ gem install idrac
 
 ## Usage
 
-TODO: Write usage instructions here
+### Command Line Interface
+
+The gem provides a command-line interface for interacting with iDRAC servers:
+
+```bash
+# Take a screenshot of the iDRAC console
+idrac screenshot --host=192.168.1.100 --username=root --password=calvin
+# Specify a custom output filename
+idrac screenshot --host=192.168.1.100 --username=root --password=calvin --output=my_screenshot.png
+
+# Download the Dell firmware catalog
+idrac firmware:catalog --host=192.168.1.100 --username=root --password=calvin
+
+# Check firmware status and available updates
+idrac firmware:status --host=192.168.1.100 --username=root --password=calvin
+
+# Update firmware using a specific file
+idrac firmware:update /path/to/firmware.exe --host=192.168.1.100 --username=root --password=calvin
+
+# Interactive firmware update
+idrac firmware:interactive --host=192.168.1.100 --username=root --password=calvin
+```
+
+### Ruby API
+
+```ruby
+require 'idrac'
+
+# Create a client
+client = IDRAC.new(
+  host: '192.168.1.100',
+  username: 'root',
+  password: 'calvin'
+)
+
+# Take a screenshot (using the client convenience method)
+filename = client.screenshot
+puts "Screenshot saved to: #{filename}"
+
+# Or use the Screenshot class directly for more control
+screenshot = IDRAC::Screenshot.new(client)
+filename = screenshot.capture
+puts "Screenshot saved to: #{filename}"
+
+# Firmware operations
+firmware = IDRAC::Firmware.new(client)
+
+# Download catalog
+catalog_path = firmware.download_catalog
+
+# Get system inventory
+inventory = firmware.get_system_inventory
+puts "Service Tag: #{inventory[:system][:service_tag]}"
+
+# Check for updates
+updates = firmware.check_updates(catalog_path)
+updates.each do |update|
+  puts "#{update[:name]}: #{update[:current_version]} -> #{update[:available_version]}"
+end
+
+# Update firmware
+job_id = firmware.update('/path/to/firmware.exe', wait: true)
+puts "Update completed with job ID: #{job_id}"
+```
 
 ## Development
 
@@ -28,4 +100,4 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/idrac.
+Bug reports and pull requests are welcome on GitHub at https://github.com/usiegj00/idrac.

data/Rakefile

@@ -12,6 +12,6 @@ task default: :spec
 # Depend on the build task to ensure the gem is up to date.
 task :release => [:build] do
   system "git tag v#{Idrac::VERSION}"
-  system "git push origin v#{Idrac::VERSION}"
+  system "git push --tags"
   system "gem push pkg/idrac-#{Idrac::VERSION}.gem"
 end

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "idrac"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/idrac

@@ -0,0 +1,179 @@
+#!/usr/bin/env ruby
+
+# Attempt to load bundler/setup, but don't fail if it's not available
+begin
+  require "bundler/setup"
+rescue LoadError
+  # Continue without bundler
+end
+
+# Load required gems directly
+require "thor"
+require "idrac"
+
+module IDRAC
+  class CLI < Thor
+    class_option :host, type: :string, required: true, desc: "iDRAC host address"
+    class_option :username, type: :string, required: true, desc: "iDRAC username"
+    class_option :password, type: :string, required: true, desc: "iDRAC password"
+    class_option :port, type: :numeric, default: 443, desc: "iDRAC port"
+    class_option :no_ssl, type: :boolean, default: false, desc: "Disable SSL"
+    class_option :no_verify_ssl, type: :boolean, default: false, desc: "Disable SSL verification"
+
+    desc "firmware:update PATH", "Update firmware using the specified file"
+    method_option :wait, type: :boolean, default: true, desc: "Wait for the update to complete"
+    method_option :timeout, type: :numeric, default: 3600, desc: "Timeout in seconds when waiting"
+    def firmware_update(path)
+      client = create_client
+      firmware = IDRAC::Firmware.new(client)
+      
+      begin
+        job_id = firmware.update(path, wait: options[:wait], timeout: options[:timeout])
+        puts "Firmware update initiated with job ID: #{job_id}"
+      rescue IDRAC::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      ensure
+        client.logout
+      end
+    end
+    
+    desc "firmware:catalog [DIRECTORY]", "Download Dell firmware catalog"
+    def firmware_catalog(directory = nil)
+      client = create_client
+      firmware = IDRAC::Firmware.new(client)
+      
+      begin
+        catalog_path = firmware.download_catalog(directory)
+        puts "Catalog downloaded to: #{catalog_path}"
+      rescue IDRAC::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      ensure
+        client.logout
+      end
+    end
+    
+    desc "firmware:status", "Show current firmware status and available updates"
+    method_option :catalog, type: :string, desc: "Path to existing catalog file"
+    def firmware_status
+      client = create_client
+      firmware = IDRAC::Firmware.new(client)
+      
+      begin
+        # Get system inventory
+        inventory = firmware.get_system_inventory
+        
+        puts "System Information:"
+        puts "  Model: #{inventory[:system][:model]}"
+        puts "  Manufacturer: #{inventory[:system][:manufacturer]}"
+        puts "  Service Tag: #{inventory[:system][:service_tag]}"
+        puts "  BIOS Version: #{inventory[:system][:bios_version]}"
+        
+        puts "\nInstalled Firmware:"
+        inventory[:firmware].each do |fw|
+          puts "  #{fw[:name]}: #{fw[:version]} (#{fw[:updateable] ? 'Updateable' : 'Not Updateable'})"
+        end
+        
+        # Check for updates if catalog is available
+        if options[:catalog] || File.exist?(File.join(Dir.pwd, "Catalog.xml"))
+          catalog_path = options[:catalog] || File.join(Dir.pwd, "Catalog.xml")
+          puts "\nChecking for updates using catalog: #{catalog_path}"
+          
+          updates = firmware.check_updates(catalog_path)
+          
+          if updates.empty?
+            puts "No updates available."
+          else
+            puts "\nAvailable Updates:"
+            updates.each do |update|
+              puts "  #{update[:name]}: #{update[:current_version]} -> #{update[:available_version]}"
+            end
+          end
+        else
+          puts "\nTo check for updates, download the catalog first with 'idrac firmware:catalog'"
+        end
+      rescue IDRAC::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      ensure
+        client.logout
+      end
+    end
+    
+    desc "firmware:interactive", "Interactive firmware update"
+    method_option :catalog, type: :string, desc: "Path to existing catalog file"
+    def firmware_interactive
+      client = create_client
+      firmware = IDRAC::Firmware.new(client)
+      
+      begin
+        catalog_path = options[:catalog]
+        
+        # If no catalog specified, check if one exists in current directory
+        if catalog_path.nil? && File.exist?(File.join(Dir.pwd, "Catalog.xml"))
+          catalog_path = File.join(Dir.pwd, "Catalog.xml")
+        end
+        
+        # If still no catalog, download it
+        if catalog_path.nil?
+          puts "No catalog found. Downloading..."
+          catalog_path = firmware.download_catalog
+        end
+        
+        firmware.interactive_update(catalog_path)
+      rescue IDRAC::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      ensure
+        client.logout
+      end
+    end
+    
+    desc "screenshot", "Take a screenshot of the current iDRAC console"
+    method_option :output, type: :string, desc: "Output filename (default: idrac_screenshot_timestamp.png)"
+    def screenshot
+      client = create_client
+      
+      begin
+        # Create a Screenshot instance directly
+        screenshot = IDRAC::Screenshot.new(client)
+        filename = screenshot.capture
+        
+        # Rename the file if output option is provided
+        if options[:output]
+          new_filename = options[:output]
+          File.rename(filename, new_filename)
+          filename = new_filename
+        end
+        
+        puts "Screenshot saved to: #{filename}"
+      rescue IDRAC::Error => e
+        puts "Error: #{e.message}"
+        exit 1
+      ensure
+        client.logout
+      end
+    end
+    
+    map "firmware:update" => :firmware_update
+    map "firmware:catalog" => :firmware_catalog
+    map "firmware:status" => :firmware_status
+    map "firmware:interactive" => :firmware_interactive
+
+    private
+
+    def create_client
+      IDRAC::Client.new(
+        host: options[:host],
+        username: options[:username],
+        password: options[:password],
+        port: options[:port],
+        use_ssl: !options[:no_ssl],
+        verify_ssl: !options[:no_verify_ssl]
+      )
+    end
+  end
+end
+
+IDRAC::CLI.start(ARGV) 

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/idrac.gemspec

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "lib/idrac/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "idrac"
+  spec.version = IDRAC::VERSION
+  spec.authors = ["Jonathan Siegel"]
+  spec.email = ["<248302+usiegj00@users.noreply.github.com>"]
+
+  spec.summary = "API Client for Dell iDRAC"
+  spec.description = "A Ruby client for the Dell iDRAC API"
+  spec.homepage = "http://github.com"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0" # Updated to support Ruby 3.2.x
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "bin"
+  spec.executables = ["idrac"]
+  spec.require_paths = ["lib"]
+
+  # Dependencies - Using more flexible version constraints
+  spec.add_dependency "httparty", ">= 0.21.0", "< 0.22.0"
+  spec.add_dependency "nokogiri", ">= 1.15.0", "< 1.19.0"
+  spec.add_dependency "faraday", ">= 2.7.0", "< 2.8.0"
+  spec.add_dependency "faraday-multipart", ">= 1.0.0", "< 1.1.0"
+  spec.add_dependency "thor", ">= 1.2.0", "< 1.4.0"
+  spec.add_dependency "base64", "~> 0.1", ">= 0.1.0"
+
+  # Development dependencies
+  spec.add_development_dependency "bundler", "~> 2.4", ">= 2.4.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "debug", "~> 1.8"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/lib/idrac/client.rb

@@ -1,41 +1,91 @@
-module Idrac
+require 'faraday'
+require 'faraday/multipart'
+require 'nokogiri'
+require 'base64'
+require 'uri'
+require 'httparty'
+
+module IDRAC
   class Client
-    def initialize(url:)
-      @url = url
+    attr_reader :host, :username, :password, :port, :use_ssl, :verify_ssl
+
+    def initialize(host:, username:, password:, port: 443, use_ssl: true, verify_ssl: true)
+      @host = host
+      @username = username
+      @password = password
+      @port = port
+      @use_ssl = use_ssl
+      @verify_ssl = verify_ssl
+      @session_id = nil
       @cookies = nil
     end
 
-    def login(user: 'root', password: 'calvin')
-      login_response = HTTParty.post(
-        "#{@url}/data/login",
-        body: { user: user, password: password },
-        headers: {
-          "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36",
-          "Accept-Encoding" => "deflate, gzip"
-        },
-        verify: false
-      )
-      @cookies = login_response.headers['set-cookie']
-      xml_doc = Nokogiri::XML(login_response.body)
-
-      # Extract the forwardUrl from the XML
-      error_message = xml_doc.at_xpath('//errorMsg')&.text
-      # Error Message: The maximum number of user sessions has been reached!
-      if error_message && !error_message.empty?
-        raise "Error Message: #{error_message}"
+    def connection
+      @connection ||= Faraday.new(url: base_url, ssl: { verify: verify_ssl }) do |faraday|
+        faraday.request :multipart
+        faraday.request :url_encoded
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+
+    def login
+      response = connection.post('/data/login') do |req|
+        req.headers['Content-Type'] = 'application/x-www-form-urlencoded'
+        req.body = "user=#{username}&password=#{password}"
+      end
+
+      if response.status == 200
+        # Extract session ID from response
+        doc = Nokogiri::HTML(response.body)
+        @session_id = doc.at_css('script:contains("_this.SID")').text.match(/_this\.SID\s*=\s*"([^"]+)"/)[1] rescue nil
+        
+        # Store cookies for screenshot functionality
+        @cookies = response.headers['set-cookie']
+        
+        # Extract forward URL for screenshot functionality
+        xml_doc = Nokogiri::XML(response.body)
+        error_message = xml_doc.at_xpath('//errorMsg')&.text
+        
+        if error_message && !error_message.empty?
+          raise Error, "Error Message: #{error_message}"
+        end
+        
+        forward_url = xml_doc.xpath('//forwardUrl').text
+        return forward_url
+      else
+        raise Error, "Login failed with status #{response.status}: #{response.body}"
       end
-      forward_url = xml_doc.xpath('//forwardUrl').text
     end
 
     def logout
-      path = "data/logout"
-      res = get(path: path)
-      raise "Invalid login." unless res.code.between?(200, 299)
+      return unless @session_id
+      
+      response = connection.get('/data/logout') do |req|
+        req.headers['Cookie'] = "sessionid=#{@session_id}"
+      end
+      
+      @session_id = nil
+      @cookies = nil
+      response.status == 200
     end
+
+    def authenticated_request(method, path, options = {})
+      login unless @session_id
+      
+      options[:headers] ||= {}
+      options[:headers]['Cookie'] = "sessionid=#{@session_id}"
+      
+      response = connection.send(method, path, options[:params]) do |req|
+        req.headers.merge!(options[:headers])
+        req.body = options[:body] if options[:body]
+      end
       
+      response
+    end
+
     def get(path:, headers: {})
       response = HTTParty.get(
-        "#{@url}/#{path}",
+        "#{base_url}/#{path}",
         headers: {
           "User-Agent" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36",
           "Accept-Encoding" => "deflate, gzip",
@@ -44,5 +94,16 @@ module Idrac
         verify: false
       )
     end
+
+    def screenshot
+      # Create a Screenshot instance and capture a screenshot
+      screenshot_instance = Screenshot.new(self)
+      screenshot_instance.capture
+    end
+
+    def base_url
+      protocol = use_ssl ? 'https' : 'http'
+      "#{protocol}://#{host}:#{port}"
+    end
   end
 end

data/lib/idrac/firmware.rb

@@ -0,0 +1,366 @@
+require 'tempfile'
+require 'net/http'
+require 'uri'
+require 'json'
+require 'nokogiri'
+require 'fileutils'
+require 'securerandom'
+
+module IDRAC
+  class Firmware
+    attr_reader :client
+
+    CATALOG_URL = "https://downloads.dell.com/catalog/Catalog.xml.gz"
+    
+    def initialize(client)
+      @client = client
+    end
+
+    def update(firmware_path, options = {})
+      # Validate firmware file exists
+      unless File.exist?(firmware_path)
+        raise Error, "Firmware file not found: #{firmware_path}"
+      end
+
+      # Login to iDRAC
+      client.login unless client.instance_variable_get(:@session_id)
+
+      # Upload firmware file
+      job_id = upload_firmware(firmware_path)
+      
+      # Check if we should wait for the update to complete
+      if options[:wait]
+        wait_for_job_completion(job_id, options[:timeout] || 3600)
+      end
+
+      job_id
+    end
+    
+    def download_catalog(output_dir = nil)
+      output_dir ||= Dir.pwd
+      FileUtils.mkdir_p(output_dir) unless Dir.exist?(output_dir)
+      
+      catalog_gz_path = File.join(output_dir, "Catalog.xml.gz")
+      catalog_path = File.join(output_dir, "Catalog.xml")
+      
+      puts "Downloading Dell catalog from #{CATALOG_URL}..."
+      
+      uri = URI.parse(CATALOG_URL)
+      Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        request = Net::HTTP::Get.new(uri)
+        http.request(request) do |response|
+          if response.code == "200"
+            File.open(catalog_gz_path, 'wb') do |file|
+              response.read_body do |chunk|
+                file.write(chunk)
+              end
+            end
+          else
+            raise Error, "Failed to download catalog: #{response.code} #{response.message}"
+          end
+        end
+      end
+      
+      puts "Extracting catalog..."
+      system("gunzip -f #{catalog_gz_path}")
+      
+      if File.exist?(catalog_path)
+        puts "Catalog downloaded and extracted to #{catalog_path}"
+        return catalog_path
+      else
+        raise Error, "Failed to extract catalog"
+      end
+    end
+    
+    def get_system_inventory
+      puts "Retrieving system inventory..."
+      
+      # Get basic system information
+      system_uri = URI.parse("#{client.base_url}/redfish/v1/Systems/System.Embedded.1")
+      system_response = client.authenticated_request(:get, "/redfish/v1/Systems/System.Embedded.1")
+      
+      if system_response.status != 200
+        raise Error, "Failed to get system information: #{system_response.status}"
+      end
+      
+      system_data = JSON.parse(system_response.body)
+      
+      # Get firmware inventory
+      firmware_uri = URI.parse("#{client.base_url}/redfish/v1/UpdateService/FirmwareInventory")
+      firmware_response = client.authenticated_request(:get, "/redfish/v1/UpdateService/FirmwareInventory")
+      
+      if firmware_response.status != 200
+        raise Error, "Failed to get firmware inventory: #{firmware_response.status}"
+      end
+      
+      firmware_data = JSON.parse(firmware_response.body)
+      
+      # Get detailed firmware information for each component
+      firmware_inventory = []
+      
+      if firmware_data['Members'] && firmware_data['Members'].is_a?(Array)
+        firmware_data['Members'].each do |member|
+          if member['@odata.id']
+            component_uri = member['@odata.id']
+            component_response = client.authenticated_request(:get, component_uri)
+            
+            if component_response.status == 200
+              component_data = JSON.parse(component_response.body)
+              firmware_inventory << {
+                name: component_data['Name'],
+                id: component_data['Id'],
+                version: component_data['Version'],
+                updateable: component_data['Updateable'] || false,
+                status: component_data['Status'] ? component_data['Status']['State'] : 'Unknown'
+              }
+            end
+          end
+        end
+      end
+      
+      {
+        system: {
+          model: system_data['Model'],
+          manufacturer: system_data['Manufacturer'],
+          serial_number: system_data['SerialNumber'],
+          part_number: system_data['PartNumber'],
+          bios_version: system_data['BiosVersion'],
+          service_tag: system_data['SKU']
+        },
+        firmware: firmware_inventory
+      }
+    end
+    
+    def check_updates(catalog_path = nil)
+      # Download catalog if not provided
+      catalog_path ||= download_catalog
+      
+      # Get system inventory
+      inventory = get_system_inventory
+      
+      # Parse catalog
+      catalog_doc = File.open(catalog_path) { |f| Nokogiri::XML(f) }
+      
+      # Extract service tag
+      service_tag = inventory[:system][:service_tag]
+      
+      puts "Checking updates for system with service tag: #{service_tag}"
+      
+      # Find applicable updates
+      updates = []
+      
+      # Get current firmware versions
+      current_versions = {}
+      inventory[:firmware].each do |fw|
+        current_versions[fw[:name]] = fw[:version]
+      end
+      
+      # Find matching components in catalog
+      catalog_doc.xpath('//SoftwareComponent').each do |component|
+        name = component.at_xpath('Name')&.text
+        version = component.at_xpath('Version')&.text
+        path = component.at_xpath('Path')&.text
+        component_type = component.at_xpath('ComponentType')&.text
+        
+        # Check if this component matches any of our firmware
+        inventory[:firmware].each do |fw|
+          if fw[:name].include?(name) || name.include?(fw[:name])
+            current_version = fw[:version]
+            
+            # Simple version comparison (this could be improved)
+            if version != current_version
+              updates << {
+                name: name,
+                current_version: current_version,
+                available_version: version,
+                path: path,
+                component_type: component_type,
+                download_url: "https://downloads.dell.com/#{path}"
+              }
+            end
+          end
+        end
+      end
+      
+      updates
+    end
+    
+    def interactive_update(catalog_path = nil)
+      updates = check_updates(catalog_path)
+      
+      if updates.empty?
+        puts "No updates available for your system."
+        return
+      end
+      
+      puts "\nAvailable updates:"
+      updates.each_with_index do |update, index|
+        puts "#{index + 1}. #{update[:name]}: #{update[:current_version]} -> #{update[:available_version]}"
+      end
+      
+      puts "\nEnter the number of the update to install (or 'all' for all updates, 'q' to quit):"
+      choice = STDIN.gets.chomp
+      
+      return if choice.downcase == 'q'
+      
+      selected_updates = if choice.downcase == 'all'
+                          updates
+                        else
+                          index = choice.to_i - 1
+                          if index >= 0 && index < updates.size
+                            [updates[index]]
+                          else
+                            puts "Invalid selection."
+                            return
+                          end
+                        end
+      
+      selected_updates.each do |update|
+        puts "Downloading #{update[:name]} version #{update[:available_version]}..."
+        
+        # Create temp directory
+        temp_dir = Dir.mktmpdir
+        
+        begin
+          # Download the update
+          update_filename = File.basename(update[:path])
+          update_path = File.join(temp_dir, update_filename)
+          
+          uri = URI.parse(update[:download_url])
+          Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+            request = Net::HTTP::Get.new(uri)
+            http.request(request) do |response|
+              if response.code == "200"
+                File.open(update_path, 'wb') do |file|
+                  response.read_body do |chunk|
+                    file.write(chunk)
+                  end
+                end
+              else
+                puts "Failed to download update: #{response.code} #{response.message}"
+                next
+              end
+            end
+          end
+          
+          puts "Installing #{update[:name]} version #{update[:available_version]}..."
+          job_id = update(update_path, wait: true)
+          puts "Update completed with job ID: #{job_id}"
+          
+        ensure
+          # Clean up temp directory
+          FileUtils.remove_entry(temp_dir)
+        end
+      end
+    end
+
+    private
+
+    def upload_firmware(firmware_path)
+      puts "Uploading firmware file: #{firmware_path}"
+      
+      # Get the HttpPushUri from UpdateService
+      update_service_response = client.authenticated_request(:get, "/redfish/v1/UpdateService")
+      update_service_data = JSON.parse(update_service_response.body)
+      
+      http_push_uri = update_service_data['HttpPushUri']
+      if http_push_uri.nil?
+        http_push_uri = "/redfish/v1/UpdateService/FirmwareInventory"
+        puts "HttpPushUri not found, using default: #{http_push_uri}"
+      else
+        puts "Found HttpPushUri: #{http_push_uri}"
+      end
+      
+      # Get the ETag for the HttpPushUri
+      etag_response = client.authenticated_request(:get, http_push_uri)
+      etag = etag_response.headers['etag']
+      
+      puts "Got ETag: #{etag}"
+      
+      # Create a boundary for multipart/form-data
+      boundary = "----WebKitFormBoundary#{SecureRandom.hex(16)}"
+      
+      # Read the file content
+      file_content = File.binread(firmware_path)
+      filename = File.basename(firmware_path)
+      
+      # Create the multipart body
+      post_body = []
+      post_body << "--#{boundary}\r\n"
+      post_body << "Content-Disposition: form-data; name=\"file\"; filename=\"#{filename}\"\r\n"
+      post_body << "Content-Type: application/octet-stream\r\n\r\n"
+      post_body << file_content
+      post_body << "\r\n--#{boundary}--\r\n"
+      
+      # Upload the firmware
+      response = client.authenticated_request(
+        :post,
+        http_push_uri,
+        {
+          headers: {
+            'Content-Type' => "multipart/form-data; boundary=#{boundary}",
+            'If-Match' => etag
+          },
+          body: post_body.join
+        }
+      )
+      
+      if response.status < 200 || response.status >= 300
+        raise Error, "Firmware upload failed with status #{response.status}: #{response.body}"
+      end
+      
+      # Extract job ID from response
+      response_data = JSON.parse(response.body)
+      job_id = response_data['Id'] || response_data['TaskId']
+      
+      if job_id.nil?
+        raise Error, "Failed to extract job ID from firmware upload response"
+      end
+      
+      puts "Firmware update job created with ID: #{job_id}"
+      job_id
+    end
+
+    def wait_for_job_completion(job_id, timeout)
+      puts "Waiting for firmware update job #{job_id} to complete..."
+      
+      start_time = Time.now
+      loop do
+        status = get_job_status(job_id)
+        
+        case status
+        when 'Completed'
+          puts "Firmware update completed successfully"
+          return true
+        when 'Failed'
+          raise Error, "Firmware update job failed"
+        when 'Scheduled', 'Running', 'Downloading', 'Pending'
+          # Job still in progress
+        else
+          puts "Unknown job status: #{status}"
+        end
+        
+        if Time.now - start_time > timeout
+          raise Error, "Firmware update timed out after #{timeout} seconds"
+        end
+        
+        # Wait before checking again
+        sleep 10
+      end
+    end
+
+    def get_job_status(job_id)
+      response = client.authenticated_request(
+        :get,
+        "/redfish/v1/TaskService/Tasks/#{job_id}"
+      )
+      
+      if response.status != 200
+        raise Error, "Failed to get job status with status #{response.status}: #{response.body}"
+      end
+      
+      response_data = JSON.parse(response.body)
+      response_data['TaskState'] || 'Unknown'
+    end
+  end
+end 

data/lib/idrac/screenshot.rb

@@ -1,24 +1,49 @@
-module Idrac
-  # Reverse engineered the screenshot functionality in iDRAC 2.X
-  # Emulates the manual screenshot functionality in the web UI.
-  class Client
-    def screenshot
-      forward_url = login
-      # Extract the key-value pairs from the forward URL
-      # index?ST1=ABC,ST2=DEF
-      tokens = forward_url.split("?").last.split(",").inject({}) { |acc,kv| k,v = kv.split("="); acc[k]=v; acc }
+require 'httparty'
+require 'nokogiri'
+
+module IDRAC
+  # Reverse engineered screenshot functionality for iDRAC
+  # This uses introspection on how the web UI creates screenshots rather than the Redfish API
+  class Screenshot
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def capture
+      # Login to get the forward URL and cookies
+      forward_url = client.login
+      
+      # Extract the key-value pairs from the forward URL (format: index?ST1=ABC,ST2=DEF)
+      tokens = forward_url.split("?").last.split(",").inject({}) do |acc, kv| 
+        k, v = kv.split("=")
+        acc[k] = v
+        acc
+      end
+      
+      # Generate a timestamp for the request
       timestamp_ms = (Time.now.to_f * 1000).to_i
+      
+      # First request to trigger the screenshot capture
       path = "data?get=consolepreview[manual%20#{timestamp_ms}]"
-      res = get(path: path, headers: tokens)
-      raise "Invalid login." unless res.code.between?(200, 299)
+      res = client.get(path: path, headers: tokens)
+      raise Error, "Failed to trigger screenshot capture." unless res.code.between?(200, 299)
+      
+      # Wait for the screenshot to be generated
       sleep 2
+      
+      # Second request to get the actual screenshot image
       path = "capconsole/scapture0.png?#{timestamp_ms}"
-      res = get(path: path, headers: tokens)
-      raise "Invalid login." unless res.code.between?(200, 299)
-      filename = "#{timestamp_ms}.png"
+      res = client.get(path: path, headers: tokens)
+      raise Error, "Failed to retrieve screenshot image." unless res.code.between?(200, 299)
+      
+      # Save the screenshot to a file
+      filename = "idrac_screenshot_#{timestamp_ms}.png"
       File.open(filename, "wb") { |f| f.write(res.body) }
-      logout
+      
+      # Return the filename
       filename
     end
   end
-end
+end 

data/lib/idrac/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
-module Idrac
-  VERSION = "0.1.3"
+module IDRAC
+  VERSION = "0.1.7"
 end

data/lib/idrac.rb

@@ -2,17 +2,29 @@
 
 require 'httparty'
 require 'nokogiri'
+require 'faraday'
+require 'faraday/multipart'
+require 'base64'
+require 'uri'
 # If dev, required debug
 require 'debug' if ENV['RUBY_ENV'] == 'development'
 
 require_relative "idrac/version"
 require_relative "idrac/client"
 require_relative "idrac/screenshot"
+require_relative "idrac/firmware"
 
-module Idrac
+module IDRAC
   class Error < StandardError; end
-  # Your code goes here...
-  def self.new(url:)
-    Client.new(url:)
+  
+  def self.new(host:, username:, password:, port: 443, use_ssl: true, verify_ssl: true)
+    Client.new(
+      host: host,
+      username: username,
+      password: password,
+      port: port,
+      use_ssl: use_ssl,
+      verify_ssl: verify_ssl
+    )
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idrac
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.7
 platform: ruby
 authors:
 - Jonathan Siegel
 autorequire:
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2024-09-08 00:00:00.000000000 Z
+date: 2025-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -16,101 +16,206 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.21.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.21.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 0.22.0
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.15.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.19.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.15.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.19.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.4.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.12'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.8'
 description: A Ruby client for the Dell iDRAC API
 email:
 - "<248302+usiegj00@users.noreply.github.com>"
-executables: []
+executables:
+- idrac
 extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
 - README.md
 - Rakefile
+- bin/console
+- bin/idrac
+- bin/setup
+- idrac.gemspec
 - lib/idrac.rb
 - lib/idrac/client.rb
+- lib/idrac/firmware.rb
 - lib/idrac/screenshot.rb
 - lib/idrac/version.rb
 - sig/idrac.rbs
 homepage: http://github.com
-licenses: []
+licenses:
+- MIT
 metadata:
   homepage_uri: http://github.com
 post_install_message:
@@ -121,14 +226,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: API Client for Dell iDRAC