idrac 0.8.1 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 527454266f07cf2a797f42c324d9a8a17ddc2586f72aa00af935500ea4386ef1
-  data.tar.gz: 3ff97e72d6947dd6c08e34d7682daa579b3bf3d4f505726feb4ab280172db56e
+  metadata.gz: 2ddf0acabc047b9ba1160d2c650b3590e7d6cc06d2d5c12aac37a4762fa85b7c
+  data.tar.gz: 40264a916185644f08009c693234d7463b929be7db77e8a1e4a1c28d13da70a0
 SHA512:
-  metadata.gz: a76db748a58725fe2c6409c40df95449d5a648a9647a816e8653f2c31adcb519d2d88a2e1a452e902ce7efb65d868f78e2a9bc09bf4952aaf141ed1b518b9836
-  data.tar.gz: 1e2bca28672a8ac30ad0573040374d016417a77cc6c264fb5434ce1ed40561260cccb54eb58385aeebe749fc27de20d780adeee82a67dabc7a49f54e299033bb
+  metadata.gz: be5ef5de0dac918e3f5cc55304b478cdba291a5637fecea1d456d993861246286d9601103aa20ac600a54c14acd15a92866fe455e96aa7cd7abebaf1ffbe5956
+  data.tar.gz: 5c148a96e54a35a8ffac7fca95163fb68ec86fd15500692210ebd9d3951ea836d25cb11d9a287379b7fbd265edd5fe0e67b57473aa6e9909b4f3578b33ba6d75

data/lib/idrac/client.rb

@@ -23,6 +23,7 @@ module IDRAC
     include License
     include SystemConfig
     include Utility
+    include Network
 
     def initialize(host:, username:, password:, port: 443, use_ssl: true, verify_ssl: false, direct_mode: false, retry_count: 3, retry_delay: 1, host_header: nil)
       @host = host

data/lib/idrac/network.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module IDRAC
+  module Network
+    def get_bmc_network
+      # Get the iDRAC ethernet interface
+      collection_response = authenticated_request(:get, "/redfish/v1/Managers/iDRAC.Embedded.1/EthernetInterfaces")
+      
+      if collection_response.status == 200
+        collection = JSON.parse(collection_response.body)
+        
+        if collection["Members"] && collection["Members"].any?
+          interface_path = collection["Members"][0]["@odata.id"]
+          response = authenticated_request(:get, interface_path)
+          
+          if response.status == 200
+            data = JSON.parse(response.body)
+            {
+              "ipv4_address" => data.dig("IPv4Addresses", 0, "Address"),
+              "subnet_mask" => data.dig("IPv4Addresses", 0, "SubnetMask"),
+              "gateway" => data.dig("IPv4Addresses", 0, "Gateway"),
+              "mode" => data.dig("IPv4Addresses", 0, "AddressOrigin"), # DHCP or Static
+              "mac_address" => data["MACAddress"],
+              "hostname" => data["HostName"],
+              "fqdn" => data["FQDN"],
+              "dns_servers" => data["NameServers"] || []
+            }
+          else
+            raise Error, "Failed to get interface details. Status: #{response.status}"
+          end
+        else
+          raise Error, "No ethernet interfaces found"
+        end
+      else
+        raise Error, "Failed to get ethernet interfaces. Status: #{collection_response.status}"
+      end
+    end
+    
+    def set_bmc_network(ip_address: nil, subnet_mask: nil, gateway: nil, 
+                        dns_primary: nil, dns_secondary: nil, hostname: nil, 
+                        dhcp: false)
+      # Get the interface path first
+      collection_response = authenticated_request(:get, "/redfish/v1/Managers/iDRAC.Embedded.1/EthernetInterfaces")
+      
+      if collection_response.status == 200
+        collection = JSON.parse(collection_response.body)
+        
+        if collection["Members"] && collection["Members"].any?
+          interface_path = collection["Members"][0]["@odata.id"]
+          
+          if dhcp
+            puts "Setting iDRAC to DHCP mode...".yellow
+            body = {
+              "DHCPv4" => {
+                "DHCPEnabled" => true
+              },
+              "IPv4Addresses" => [{
+                "AddressOrigin" => "DHCP"
+              }]
+            }
+          else
+            puts "Configuring iDRAC network settings...".yellow
+            body = {}
+            
+            # Configure static IP if provided
+            if ip_address && subnet_mask
+              body["IPv4Addresses"] = [{
+                "Address" => ip_address,
+                "SubnetMask" => subnet_mask,
+                "Gateway" => gateway,
+                "AddressOrigin" => "Static"
+              }]
+              puts "  IP: #{ip_address}/#{subnet_mask}".cyan
+              puts "  Gateway: #{gateway}".cyan if gateway
+            end
+            
+            # Configure DNS if provided
+            if dns_primary || dns_secondary
+              dns_servers = []
+              dns_servers << dns_primary if dns_primary
+              dns_servers << dns_secondary if dns_secondary
+              body["StaticNameServers"] = dns_servers
+              puts "  DNS: #{dns_servers.join(', ')}".cyan
+            end
+            
+            # Configure hostname if provided
+            if hostname
+              body["HostName"] = hostname
+              puts "  Hostname: #{hostname}".cyan
+            end
+          end
+          
+          response = authenticated_request(
+            :patch,
+            interface_path,
+            body: body.to_json,
+            headers: { 'Content-Type' => 'application/json' }
+          )
+          
+          if response.status.between?(200, 299)
+            puts "iDRAC network configured successfully.".green
+            puts "WARNING: iDRAC may restart network services. Connection may be lost.".yellow if ip_address
+            true
+          else
+            raise Error, "Failed to configure iDRAC network: #{response.status} - #{response.body}"
+          end
+        else
+          raise Error, "No ethernet interfaces found"
+        end
+      else
+        raise Error, "Failed to get ethernet interfaces"
+      end
+    end
+    
+    def set_bmc_dhcp
+      # Convenience method
+      set_bmc_network(dhcp: true)
+    end
+  end
+end

data/lib/idrac/power.rb

@@ -152,6 +152,14 @@ module IDRAC
       JSON.parse(handle_response(response))&.dig("PowerControl", 0, "PowerConsumedWatts")&.to_f
     end
     
+    # TODO: Migrate method names to match radfish interface for uniformity:
+    # - Rename get_power_usage_watts to power_consumption_watts
+    # - Rename get_power_state to power_status
+    # - Ensure all methods return consistent types across vendors
+    # Once all vendor gems conform to the same interface, the radfish adapters
+    # can become thin registration layers or be eliminated entirely.
+    alias_method :power_consumption_watts, :get_power_usage_watts
+    
     private
     
     def wait_for_power_state(target_state:, tries: 6)

data/lib/idrac/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IDRAC
-  VERSION = "0.8.1"
+  VERSION = "0.8.3"
 end

data/lib/idrac.rb

@@ -59,5 +59,6 @@ require 'idrac/boot'
 require 'idrac/license'
 require 'idrac/system_config'
 require 'idrac/utility'
+require 'idrac/network'
 # Client include must come last:
 require 'idrac/client'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idrac
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.3
 platform: ruby
 authors:
 - Jonathan Siegel
@@ -265,6 +265,7 @@ files:
 - lib/idrac/jobs.rb
 - lib/idrac/license.rb
 - lib/idrac/lifecycle.rb
+- lib/idrac/network.rb
 - lib/idrac/power.rb
 - lib/idrac/session.rb
 - lib/idrac/storage.rb