ibm_power_hmc 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e8b824464b658e795023dba5c23ec80a7b90e830c204d7184a786029d37f276
-  data.tar.gz: 5eb6491fd0d3f7d465acc0a8bbdac0063ceb1e028ad4c7b14b3ac92e7f79d622
+  metadata.gz: 49c35a3e54753bb8c31a1eafc7c6e98e0ad2a662d4d24c284e873ec3d30aa144
+  data.tar.gz: 8429c8a52729102cfcdd2294fc25a2a27dd3f01b0ba9f3f0e46ebbea931903ac
 SHA512:
-  metadata.gz: 1a13e2dc82679cadc1ee2de5029aa30346402bf4d41e26932ab16325e097b63814d482ffcdd2d9e1fd14cb21e771231ca3ec52e5c5af6b2317fc1e43c3fd4adf
-  data.tar.gz: 1e502b797270f3b71bb9d01280dc40a3f60e81ed2782027273ca75e045347872b641499622f915ed36f1dc75605468c6b86caa5c4bbd1894cff38189b6023ded
+  metadata.gz: 7b0cdb3f5348b221cd5fd147e63d391719b06324a49eec554fd1820d90f8000fb4000e005d5e638e6445be0608f7ea30a3a1db1d1345ac1cbf32526fd428f01f
+  data.tar.gz: 06d590cf0b6f2d92fbdd685d511ebd499597a285a248807cbe2814e5d569ad237753c7b2196c03b40d9f4be25d08071f990dc3d9d3fad0b20e4f5a8ef7a64438

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.20.0
+* Add permissive option (`ignoreError=true`) for cluster APIs
+* Fix `modify_object` method when URI has a query part
+* Add `chcomgmt` method
+* Add `grow_lu` method
+* Add `shared_memory_pool` method
+* Improve schema definitions for CPU and memory
+* Add schema definition for shared memory pool
 ## v0.19.0
 * Major code refactoring
 * Add `serviceable_events` method

data/README.md

@@ -70,6 +70,14 @@ Shutting down a logical partition:
 hc.poweroff_lpar(lpar_uuid, { "operation" => "shutdown" })
 ```
 
+Setting the memory of a logical partition to 32GB:
+
+```ruby
+hc.modify_object do
+  hc.lpar(lpar_uuid).tap { |lpar| lpar.desired_memory = 32_768 }
+end
+```
+
 Listing serviceable events:
 
 ```ruby

data/lib/ibm_power_hmc/apis/connection.rb

@@ -184,7 +184,7 @@ module IbmPowerHmc
         # Use ETag to ensure object has not changed.
         headers = headers.merge("If-Match" => obj.etag, :content_type => obj.content_type)
         begin
-          request(:post, method_url.nil? ? obj.href.path : method_url, headers, obj.xml.to_s)
+          request(:post, method_url.nil? ? obj.href.to_s : method_url, headers, obj.xml.to_s)
           break
         rescue HttpError => e
           attempts -= 1

data/lib/ibm_power_hmc/apis/uom.rb

@@ -193,8 +193,8 @@ module IbmPowerHmc
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/VirtualIOServer"
       end
       query = {}
-      query["ignoreError"] = "true" if permissive
       query["group"] = group_name unless group_name.nil?
+      query["ignoreError"] = "true" if permissive
       method_url += "?" + query.map { |h| h.join("=") }.join("&") unless query.empty?
 
       response = request(:get, method_url)
@@ -413,11 +413,12 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method clusters
+    # @!method clusters(permissive = true)
     # Retrieve the list of clusters managed by the HMC.
+    # @param permissive [Boolean] Ignore errors generated from bad clusters.
     # @return [Array<IbmPowerHmc::Cluster>] The list of clusters.
-    def clusters
-      method_url = "/rest/api/uom/Cluster"
+    def clusters(permissive = true)
+      method_url = "/rest/api/uom/Cluster#{'?ignoreError=true' if permissive}"
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:Cluster)
     end
@@ -434,11 +435,12 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method ssps
+    # @!method ssps(permissive = true)
     # Retrieve the list of shared storage pools managed by the HMC.
+    # @param permissive [Boolean] Ignore errors generated from bad clusters.
     # @return [Array<IbmPowerHmc::SharedStoragePool>] The list of shared storage pools.
-    def ssps
-      method_url = "/rest/api/uom/SharedStoragePool"
+    def ssps(permissive = true)
+      method_url = "/rest/api/uom/SharedStoragePool#{'?ignoreError=true' if permissive}"
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:SharedStoragePool)
     end
@@ -455,13 +457,17 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method tiers(group_name = nil)
+    # @!method tiers(group_name = nil, permissive = true)
     # Retrieve the list of tiers that are part of shared storage pools managed by the HMC.
     # @param group_name [String] The extended group attributes.
+    # @param permissive [Boolean] Ignore errors generated from bad clusters.
     # @return [Array<IbmPowerHmc::Tier>] The list of tiers.
-    def tiers(group_name = nil)
+    def tiers(group_name = nil, permissive = true)
       method_url = "/rest/api/uom/Tier"
-      method_url += "?group=#{group_name}" unless group_name.nil?
+      query = {}
+      query["group"] = group_name unless group_name.nil?
+      query["ignoreError"] = "true" if permissive
+      method_url += "?" + query.map { |h| h.join("=") }.join("&") unless query.empty?
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:Tier)
     end
@@ -503,6 +509,24 @@ module IbmPowerHmc
       end
     end
 
+    ##
+    # @!method shared_memory_pool(sys_uuid, pool_uuid = nil)
+    # Retrieve information about Shared Memory Pools.
+    # @param sys_uuid [String] The UUID of the managed system.
+    # @param pool_uuid [String] The UUID of the shared memory pool (return all pools if omitted)
+    # @return [Array<IbmPowerHmc::SharedMemoryPool>, IbmPowerHmc::SharedMemoryPool] The list of shared memory pools.
+    def shared_memory_pool(sys_uuid, pool_uuid = nil)
+      if pool_uuid.nil?
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/SharedMemoryPool"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:SharedMemoryPool)
+      else
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/SharedMemoryPool/#{pool_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:SharedMemoryPool)
+      end
+    end
+
     ##
     # @!method poweron_lpar(lpar_uuid, params = {}, sync = true)
     # Power on a logical partition.
@@ -602,6 +626,21 @@ module IbmPowerHmc
       job
     end
 
+    ##
+    # @!method chcomgmt(sys_uuid, status)
+    # Change the co-management settings for a managed system.
+    # @param sys_uuid [String] The UUID of the managed system.
+    # @param status [String] The new co-management status ("rel", "norm", "keep").
+    # @return [IbmPowerHmc::HmcJob] The HMC job.
+    def chcomgmt(sys_uuid, status)
+      operation = status == "rel" ? "ReleaseController" : "RequestController"
+      method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/do/#{operation}"
+
+      params = {}
+      params["coManagementControllerStatus"] = status unless status == "rel"
+      HmcJob.new(self, method_url, operation, "ManagedSystem", params).tap(&:run)
+    end
+
     ##
     # @!method cli_run(hmc_uuid, cmd, sync = true)
     # Run a CLI command on the HMC as a job.
@@ -621,6 +660,23 @@ module IbmPowerHmc
       job
     end
 
+    ##
+    # @!method grow_lu(cl_uuid, lu_uuid, capacity)
+    # Increase the size of a logical unit in a cluster.
+    # @param cl_uuid [String] The UUID of the cluster.
+    # @param lu_uuid [String] The UUID of the logical unit.
+    # @param capacity [Float] The new logical unit size (in GB).
+    # @return [IbmPowerHmc::HmcJob] The HMC job.
+    def grow_lu(cl_uuid, lu_uuid, capacity)
+      method_url = "/rest/api/uom/Cluster/#{cl_uuid}/do/GrowLogicalUnit"
+
+      params = {
+        "LogicalUnitUDID" => lu_uuid,
+        "Capacity" => capacity
+      }
+      HmcJob.new(self, method_url, "GrowLogicalUnit", "Cluster", params).tap(&:run)
+    end
+
     ##
     # @!method next_events(wait = true)
     # Retrieve a list of events that occured since last call.

data/lib/ibm_power_hmc/schema/uom.rb

@@ -129,8 +129,13 @@ module IbmPowerHmc
       :state => "PartitionState",
       :type => "PartitionType",
       :memory => "PartitionMemoryConfiguration/CurrentMemory",
+      :desired_memory => "PartitionMemoryConfiguration/DesiredMemory",
+      :min_memory => "PartitionMemoryConfiguration/MinimumMemory",
+      :max_memory => "PartitionMemoryConfiguration/MaximumMemory",
       :dedicated => "PartitionProcessorConfiguration/CurrentHasDedicatedProcessors",
       :sharing_mode => "PartitionProcessorConfiguration/CurrentSharingMode",
+      :uncapped_weight => "PartitionProcessorConfiguration/CurrentSharedProcessorConfiguration/CurrentUncappedWeight",
+      :desired_uncapped_weight => "PartitionProcessorConfiguration/SharedProcessorConfiguration/UncappedWeight",
       :rmc_state => "ResourceMonitoringControlState",
       :rmc_ipaddr => "ResourceMonitoringIPAddress",
       :os => "OperatingSystemVersion",
@@ -138,6 +143,12 @@ module IbmPowerHmc
       :procs => "PartitionProcessorConfiguration/CurrentDedicatedProcessorConfiguration/CurrentProcessors",
       :proc_units => "PartitionProcessorConfiguration/CurrentSharedProcessorConfiguration/CurrentProcessingUnits",
       :vprocs => "PartitionProcessorConfiguration/CurrentSharedProcessorConfiguration/AllocatedVirtualProcessors",
+      :desired_proc_units => "PartitionProcessorConfiguration/SharedProcessorConfiguration/DesiredProcessingUnits",
+      :desired_vprocs => "PartitionProcessorConfiguration/SharedProcessorConfiguration/DesiredVirtualProcessors",
+      :minimum_proc_units => "PartitionProcessorConfiguration/SharedProcessorConfiguration/MinimumProcessingUnits",
+      :minimum_vprocs => "PartitionProcessorConfiguration/SharedProcessorConfiguration/MinimumVirtualProcessors",
+      :maximum_proc_units => "PartitionProcessorConfiguration/SharedProcessorConfiguration/MaximumProcessingUnits",
+      :maximum_vprocs => "PartitionProcessorConfiguration/SharedProcessorConfiguration/MaximumVirtualProcessors",
       :cpu_compat_mode => "CurrentProcessorCompatibilityMode",
       :description => "Description"
     }.freeze
@@ -795,6 +806,38 @@ module IbmPowerHmc
     end
   end
 
+  # Shared Memory Pool
+  class SharedMemoryPool < AbstractRest
+    ATTRS = {
+      :pool_mb => "CurrentPoolMemory",
+      :available_mb => "CurrentAvailablePoolMemory",
+      :max_mb => "CurrentMaximumPoolMemory",
+      :sys_mb =>"SystemFirmwarePoolMemory",
+      :pool_id => "PoolID",
+      :dedup => "MemoryDeduplicationEnabled"
+    }.freeze
+
+    def paging_vios_uuids
+      ["PagingServicePartitionOne", "PagingServicePartitionTwo"].map do |attr|
+        if (vios_href = singleton(attr, "href"))
+          uuid_from_href(vios_href)
+        end
+      end
+    end
+
+    def lpar_uuids
+      REXML::XPath.match(xml, "PagingDevices/ReservedStorageDevice").map do |dev|
+        if (lpar = dev.elements["AssociatedLogicalPartition"])
+          uuid_from_href(lpar.attributes["href"])
+        end
+      end.compact
+    end
+
+    def sys_uuid
+      uuid_from_href(href, -3)
+    end
+  end
+
   # HMC Event
   class Event < AbstractRest
     attr_accessor :usertask

data/lib/ibm_power_hmc/version.rb

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

metadata

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