ibm_power_hmc 0.16.1 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28ceda6d2c9095912e1bcf9b7a24bcb0153bc34a5c437a41966be9036fffb858
-  data.tar.gz: 94d8d1706954d560303e96f8c793fde5e9b0a181a7e2657a75d5f37fb5977fa3
+  metadata.gz: 4a067e3697998766bac04fad91eafee2e1563a5203c9bdcd9570cccea7b8cf3d
+  data.tar.gz: 0152c5e104b2fe95acb8a232e448708c3e44fd59cf2754a743da35a2856cc3a8
 SHA512:
-  metadata.gz: c001400d781dbadea9f68df8dc4eb5266ac6c3e74a9d8035ed7c112b404ec7553c8b97eab297dd72ce22919b024d8eaa3cfb30bf133514df1eae266ce198252b
-  data.tar.gz: 62dd1000797804b87a22528c711e777c07071d80df40621f6007d88e5b68ed90da6413888eee5e185379a15a9da522cfb0cbaa9c693640ccedecad23b2af9bd9
+  metadata.gz: dc1d8e450a39902ea9aaee7765b2bd8c8850a9d7dc99abca96ee320287852d0d3fb7738fd4820edd3827c00030e66edaada481aab2de9e3850a9d8b32c98e2c1
+  data.tar.gz: 01c46f3e296b808afccfcf37e4a3f259b51b807fc051929965e4f2d5eba0cd3f4e14e0432819c9626b36647128d0fb59e9a1e1b0b6c740e839662308991f3079

data/lib/ibm_power_hmc/connection.rb

@@ -80,17 +80,32 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method managed_systems(search = nil)
+    # @!method managed_systems(search = nil, group_name = nil)
     # Retrieve the list of systems managed by the HMC.
     # @param search [String] The optional search criteria.
+    # @param group_name [String] The extended group attributes.
     # @return [Array<IbmPowerHmc::ManagedSystem>] The list of managed systems.
-    def managed_systems(search = nil)
+    def managed_systems(search = nil, group_name = nil)
       method_url = "/rest/api/uom/ManagedSystem"
       method_url += "/search/(#{ERB::Util.url_encode(search)})" unless search.nil?
+      method_url += "?group=#{group_name}" unless group_name.nil?
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:ManagedSystem)
     end
 
+    ##
+    # @!method managed_system(sys_uuid, group_name = nil)
+    # Retrieve information about a managed system.
+    # @param sys_uuid [String] The UUID of the managed system.
+    # @param group_name [String] The extended group attributes.
+    # @return [IbmPowerHmc::ManagedSystem] The managed system.
+    def managed_system(sys_uuid, group_name = nil)
+      method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}"
+      method_url += "?group=#{group_name}" unless group_name.nil?
+      response = request(:get, method_url)
+      Parser.new(response.body).object(:ManagedSystem)
+    end
+
     ##
     # @!method managed_systems_quick
     # Retrieve the list of systems managed by the HMC (using Quick API).
@@ -115,32 +130,20 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method managed_system(lpar_uuid, sys_uuid = nil, group_name = nil)
-    # Retrieve information about a managed system.
-    # @param sys_uuid [String] The UUID of the managed system.
-    # @param group_name [String] The extended group attributes.
-    # @return [IbmPowerHmc::ManagedSystem] The managed system.
-    def managed_system(sys_uuid, group_name = nil)
-      method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}"
-      method_url += "?group=#{group_name}" unless group_name.nil?
-
-      response = request(:get, method_url)
-      Parser.new(response.body).object(:ManagedSystem)
-    end
-
-    ##
-    # @!method lpars(sys_uuid = nil, search = nil)
+    # @!method lpars(sys_uuid = nil, search = nil, group_name = nil)
     # Retrieve the list of logical partitions managed by the HMC.
     # @param sys_uuid [String] The UUID of the managed system.
     # @param search [String] The optional search criteria.
+    # @param group_name [String] The extended group attributes.
     # @return [Array<IbmPowerHmc::LogicalPartition>] The list of logical partitions.
-    def lpars(sys_uuid = nil, search = nil)
+    def lpars(sys_uuid = nil, search = nil, group_name = nil)
       if sys_uuid.nil?
         method_url = "/rest/api/uom/LogicalPartition"
         method_url += "/search/(#{ERB::Util.url_encode(search)})" unless search.nil?
       else
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/LogicalPartition"
       end
+      method_url += "?group=#{group_name}" unless group_name.nil?
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:LogicalPartition)
     end
@@ -159,11 +162,25 @@ module IbmPowerHmc
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/LogicalPartition/#{lpar_uuid}"
       end
       method_url += "?group=#{group_name}" unless group_name.nil?
-
       response = request(:get, method_url)
       Parser.new(response.body).object(:LogicalPartition)
     end
 
+    ##
+    # @!method lpars_quick(sys_uuid = nil)
+    # Retrieve the list of logical partitions managed by the HMC (using Quick API).
+    # @param sys_uuid [String] The UUID of the managed system.
+    # @return [Array<Hash>] The list of logical partitions.
+    def lpars_quick(sys_uuid = nil)
+      if sys_uuid.nil?
+        method_url = "/rest/api/uom/LogicalPartition/quick/All"
+      else
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/LogicalPartition/quick/All"
+      end
+      response = request(:get, method_url)
+      JSON.parse(response.body)
+    end
+
     ##
     # @!method lpar_quick_property(lpar_uuid, property_name)
     # Retrieve a quick property of a logical partition.
@@ -177,17 +194,6 @@ module IbmPowerHmc
       response.body[1..-2]
     end
 
-    ##
-    # @!method rename_lpar(lpar_uuid, new_name)
-    # Rename a logical partition.
-    # @param lpar_uuid [String] The UUID of the logical partition.
-    # @param new_name [String] The new name of the logical partition.
-    def rename_lpar(lpar_uuid, new_name)
-      modify_object do
-        lpar(lpar_uuid).tap { |lpar| lpar.name = new_name }
-      end
-    end
-
     ##
     # @!method lpar_migrate_validate(lpar_uuid, target_sys_name, sync = true)
     # Validate if a logical partition can be migrated to another managed system.
@@ -226,20 +232,25 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method vioses(sys_uuid = nil, search = nil, permissive = true)
+    # @!method vioses(sys_uuid = nil, search = nil, group_name = nil, permissive = true)
     # Retrieve the list of virtual I/O servers managed by the HMC.
     # @param sys_uuid [String] The UUID of the managed system.
     # @param search [String] The optional search criteria.
+    # @param group_name [String] The extended group attributes.
     # @param permissive [Boolean] Skip virtual I/O servers that have error conditions.
     # @return [Array<IbmPowerHmc::VirtualIOServer>] The list of virtual I/O servers.
-    def vioses(sys_uuid = nil, search = nil, permissive = true)
+    def vioses(sys_uuid = nil, search = nil, group_name = nil, permissive = true)
       if sys_uuid.nil?
         method_url = "/rest/api/uom/VirtualIOServer"
         method_url += "/search/(#{ERB::Util.url_encode(search)})" unless search.nil?
       else
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/VirtualIOServer"
       end
-      method_url += "?ignoreError=true" if permissive
+      query = {}
+      query["ignoreError"] = "true" if permissive
+      query["group"] = group_name unless group_name.nil?
+      method_url += "?" + query.map { |h| h.join("=") }.join("&") unless query.empty?
+
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:VirtualIOServer)
     end
@@ -258,11 +269,25 @@ module IbmPowerHmc
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/VirtualIOServer/#{vios_uuid}"
       end
       method_url += "?group=#{group_name}" unless group_name.nil?
-
       response = request(:get, method_url)
       Parser.new(response.body).object(:VirtualIOServer)
     end
 
+    ##
+    # @!method vioses_quick(sys_uuid = nil)
+    # Retrieve the list of virtual I/O servers managed by the HMC (using Quick API).
+    # @param sys_uuid [String] The UUID of the managed system.
+    # @return [Array<Hash>] The list of virtual I/O servers.
+    def vioses_quick(sys_uuid = nil)
+      if sys_uuid.nil?
+        method_url = "/rest/api/uom/VirtualIOServer/quick/All"
+      else
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/VirtualIOServer/quick/All"
+      end
+      response = request(:get, method_url)
+      JSON.parse(response.body)
+    end
+
     ##
     # @!method groups
     # Retrieve the list of groups defined on the HMC.
@@ -492,7 +517,7 @@ module IbmPowerHmc
     # @!method shared_processor_pool(sys_uuid, pool_uuid = nil)
     # Retrieve information about Shared Processor Pools.
     # @param sys_uuid [String] The UUID of the managed system.
-    # @param pool_uuid [String] The UUID of the shared storage pool (return all pools if omitted)
+    # @param pool_uuid [String] The UUID of the shared processor pool (return all pools if omitted)
     # @return [Array<IbmPowerHmc::SharedProcessorPool>, IbmPowerHmc::SharedProcessorPool] The list of shared processor pools.
     def shared_processor_pool(sys_uuid, pool_uuid = nil)
       if pool_uuid.nil?

data/lib/ibm_power_hmc/parser.rb

@@ -379,6 +379,11 @@ module IbmPowerHmc
     def io_adapters
       collection_of("PartitionIOConfiguration/ProfileIOSlots/ProfileIOSlot/AssociatedIOSlot/RelatedIOAdapter", "*[1]")
     end
+
+    def shared_processor_pool_uuid
+      href = singleton("ProcessorPool", "href")
+      uuid_from_href(href) unless href.nil?
+    end
   end
 
   # Logical Partition information
@@ -414,6 +419,14 @@ module IbmPowerHmc
     def vfc_mappings
       collection_of("VirtualFibreChannelMappings", "VirtualFibreChannelMapping")
     end
+
+    def seas
+      collection_of("SharedEthernetAdapters", "SharedEthernetAdapter")
+    end
+
+    def trunks
+      collection_of("TrunkAdapters", "TrunkAdapter")
+    end
   end
 
   # Group information
@@ -437,6 +450,53 @@ module IbmPowerHmc
     end
   end
 
+  # SEA information
+  class SharedEthernetAdapter < AbstractNonRest
+    ATTRS = {
+      :udid => "UniqueDeviceID",
+      :name => "DeviceName",
+      :state => "ConfigurationState",
+      :large_send => "LargeSend",
+      :vlan_id => "PortVLANID",
+      :ha_mode => "HighAvailabilityMode",
+      :qos_mode => "QualityOfServiceMode",
+      :jumbo => "JumboFramesEnabled",
+      :queue_size => "QueueSize",
+      :primary => "IsPrimary"
+    }.freeze
+
+    def iface
+      elem = xml.elements["IPInterface"]
+      IPInterface.new(elem) unless elem.nil?
+    end
+
+    def device
+      elem = xml.elements["BackingDeviceChoice/*[1]"]
+      begin
+        Module.const_get("IbmPowerHmc::#{elem.name}").new(elem) unless elem.nil?
+      rescue NameError
+        nil
+      end
+    end
+
+    def trunks
+      collection_of("TrunkAdapters", "TrunkAdapter")
+    end
+  end
+
+  # IP Interface information
+  class IPInterface < AbstractNonRest
+    ATTRS = {
+      :name     => "InterfaceName",
+      :state    => "State",
+      :hostname => "HostName",
+      :ip       => "IPAddress",
+      :netmask  => "SubnetMask",
+      :gateway  => "Gateway",
+      :prefix   => "IPV6Prefix",
+    }.freeze
+  end
+
   # Empty parent class to match K2 schema definition
   class VirtualSCSIStorage < AbstractNonRest; end
 
@@ -547,6 +607,7 @@ module IbmPowerHmc
   # Virtual Ethernet Adapter information
   class VirtualEthernetAdapter < VirtualIOAdapter
     ATTRS = ATTRS.merge({
+      :name       => "DeviceName",
       :macaddr    => "MACAddress",
       :vswitch_id => "VirtualSwitchID",
       :vlan_id    => "PortVLANID",
@@ -565,9 +626,17 @@ module IbmPowerHmc
     end
   end
 
-  # LP-HEA information
-  class EthernetBackingDevice < IOAdapter; end
+  # Trunk Adapter information
+  class TrunkAdapter < VirtualEthernetAdapter; end
+
+  class EthernetBackingDevice < IOAdapter
+    def iface
+      elem = xml.elements["IPInterface"]
+      IPInterface.new(elem) unless elem.nil?
+    end
+  end
 
+  # LP-HEA information
   class HostEthernetAdapterLogicalPort < EthernetBackingDevice
     ATTRS = ATTRS.merge({
       :macaddr  => "MACAddress",
@@ -933,6 +1002,10 @@ module IbmPowerHmc
     def lpar_uuids
       uuids_from_links("AssignedPartitions")
     end
+
+    def sys_uuid
+      uuid_from_href(href, -3)
+    end
   end
 
   class PartitionTemplateSummary < AbstractRest

data/lib/ibm_power_hmc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IbmPowerHmc
-  VERSION = "0.16.1"
+  VERSION = "0.18.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ibm_power_hmc
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.18.0
 platform: ruby
 authors:
 - IBM Power
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-10 00:00:00.000000000 Z
+date: 2022-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client