ibm_power_hmc 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: faeaaee474f96b0beb9747a2d346110a1321e9060b2b196770598f1bccfd85a8
-  data.tar.gz: 3af51fcdb06f722a95e44bcea28f8ed4f4fef9cdfd9e1332063c3bf288a00c61
+  metadata.gz: b656be196e11b14214f13c50871c1f9a892d6346db7729e2ce0f1cc4f976c5be
+  data.tar.gz: 24f50dbe1015ac99524604cece6275cd5fd9c79f0236acb2e8a01de0bcd6bd71
 SHA512:
-  metadata.gz: 1756c8a220a30ba88da0cd0d518a681657f9d08a231c11715e461d0fe5be1c171b17e98bb290fd29f9cdb551da48cdfc699707147abded7cfa204dcde26067be
-  data.tar.gz: 8906b25b90865262000331f4c371b546cac852eeb14714e8c75b0e7ae937422d441a1c920687d4e8913dad088a9eadbbbb7a5d740fceccd57f9733e9112ce2bc
+  metadata.gz: deb0194fb5f3df5bbcc69182f30f29956f11a66cf2a91740dec214d63fce5b16383626ef600f3478084616b23ee1a557620ce45cc05ff7adbdb0364719d2a371
+  data.tar.gz: 6c19000f0cf64c5413552d60a304e51005b688403e4171367ed3d7d5384a9315a819225e9a5255b51735ddf69f0e38c040888cacbd1ec1688b67f1c594a361e6

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 = 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 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.
@@ -226,20 +243,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 +280,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.
@@ -791,20 +827,21 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method next_events(timeout = -1)
+    # @!method next_events(wait = true)
     # Retrieve a list of events that occured since last call.
-    # @param timeout [Integer] The number of seconds to wait if no event is available.
-    #   Specify -1 to wait indefinitely.
+    # @param wait [Boolean] If no event is available, block until new events occur.
     # @return [Array<IbmPowerHmc::Event>] The list of events.
-    def next_events(timeout = -1)
+    def next_events(wait = true)
       method_url = "/rest/api/uom/Event"
-      method_url += "?timeout=#{timeout}" if timeout >= 0
 
       response = nil
       loop do
         response = request(:get, method_url)
-        # The HMC waits "timeout" seconds (10 if not specified) before returning 204.
-        break if response.code != 204 || timeout >= 0
+        # The HMC waits 10 seconds before returning 204 if there is no event.
+        # There is a hidden "?timeout=X" option but it does not always work.
+        # It will return "REST026C Maximum number of event requests exceeded"
+        # after a while.
+        break if response.code != 204 || !wait
       end
       FeedParser.new(response.body).objects(:Event).map do |e|
         data = e.data.split("/") unless e.data.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
@@ -933,6 +938,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.0"
+  VERSION = "0.17.0"
 end

metadata

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