ibm_power_hmc 0.12.2 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af80f7c29ca2a209985e3b7f62604fc9ba962f2b0c2da10041fad1eb881f7d32
-  data.tar.gz: 006f79fee2ae35c82ba612639662e85ed743753f74142b1054d7166a71e877f9
+  metadata.gz: 3e96072a9ae18c79163e6f52a904e3b4f696f9b5d56729fc92d234a385929269
+  data.tar.gz: 69738a546bff4977e35c4732894a0b1916ec8e0dd49601c7e41d95e793f83ae8
 SHA512:
-  metadata.gz: 0ae3f9052998b99880aa096c0cdd13fca6c8112b6c80b93b51b64f2c9f22e07070b2cf100c61a06011086bd0a459f9ec843103c6c8568c02083dd18fbfd5ebd8
-  data.tar.gz: a9ca88412d5554c3d3d5376c72447b90da0f940553fa83d4f5396a402413af3a411b0f51a105418c77a886260d16aff954029bd73e13ff5c2ce56cfa0e30375e
+  metadata.gz: cbe96ad163dc152b885638579ca712a47e07716d98485cd3585de86d8b01e8ba961211cc27a0d0d8b0e4273f610b94eab46e114fc98f1049b480ab73a266f0fa
+  data.tar.gz: 94dafbe96f39811e3b1e70eae35fcc22442c05bbe0eae3fbca3e1e5577c35dffeb575bef5ecc87babdd08939904882391f811b5ddd980983ce30679e7f6c7f18

data/lib/ibm_power_hmc/connection.rb

@@ -16,13 +16,12 @@ module IbmPowerHmc
     # @param username [String] User name.
     # @param port [Integer] TCP port number.
     # @param validate_ssl [Boolean] Verify SSL certificates.
-    def initialize(host:, password:, username: "hscroot", port: 12_443, validate_ssl: true, timeout: 60)
+    def initialize(host:, password:, username: "hscroot", port: 12_443, validate_ssl: true)
       @hostname = "#{host}:#{port}"
       @username = username
       @password = password
       @verify_ssl = validate_ssl
       @api_session_token = nil
-      @timeout = timeout
     end
 
     ##
@@ -161,6 +160,43 @@ module IbmPowerHmc
       modify_object_attributes(method_url, {:name => new_name})
     end
 
+    ##
+    # @!method lpar_migrate_validate(lpar_uuid, target_sys_name, sync = true)
+    # Validate if a logical partition can be migrated to another managed system.
+    # @raise [IbmPowerHmc::JobFailed] if validation fails
+    # @param lpar_uuid [String] The UUID of the logical partition to migrate.
+    # @param target_sys_name [String] The managed system to migrate partition to.
+    # @param sync [Boolean] Start the job and wait for its completion.
+    def lpar_migrate_validate(lpar_uuid, target_sys_name, sync = true)
+      # Need to include session token in payload so make sure we are logged in
+      logon if @api_session_token.nil?
+      method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/do/MigrateValidate"
+      params = {
+        "TargetManagedSystemName" => target_sys_name
+      }
+      HmcJob.new(self, method_url, "MigrateValidate", "LogicalPartition", params).tap do |job|
+        job.run if sync
+      end
+    end
+
+    ##
+    # @!method lpar_migrate(lpar_uuid, target_sys_name, sync = true)
+    # Migrate a logical partition to another managed system.
+    # @param lpar_uuid [String] The UUID of the logical partition to migrate.
+    # @param target_sys_name [String] The managed system to migrate partition to.
+    # @param sync [Boolean] Start the job and wait for its completion.
+    def lpar_migrate(lpar_uuid, target_sys_name, sync = true)
+      # Need to include session token in payload so make sure we are logged in
+      logon if @api_session_token.nil?
+      method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/do/Migrate"
+      params = {
+        "TargetManagedSystemName" => target_sys_name
+      }
+      HmcJob.new(self, method_url, "Migrate", "LogicalPartition", params).tap do |job|
+        job.run if sync
+      end
+    end
+
     ##
     # @!method vioses(sys_uuid = nil, search = {}, permissive = true)
     # Retrieve the list of virtual I/O servers managed by the HMC.
@@ -172,10 +208,10 @@ module IbmPowerHmc
       if sys_uuid.nil?
         method_url = "/rest/api/uom/VirtualIOServer"
         search.each { |key, value| method_url += "/search/(#{key}==#{value})" }
-        method_url += "?ignoreError=true" if permissive
       else
         method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/VirtualIOServer"
       end
+      method_url += "?ignoreError=true" if permissive
       response = request(:get, method_url)
       FeedParser.new(response.body).objects(:VirtualIOServer)
     end
@@ -315,6 +351,42 @@ module IbmPowerHmc
       end
     end
 
+    ##
+    # @!method vscsi_client_adapter(lpar_uuid, adap_uuid = nil)
+    # Retrieve one or all virtual SCSI storage client adapters attached to a logical partition.
+    # @param lpar_uuid [String] UUID of the logical partition.
+    # @param adap_uuid [String] UUID of the adapter to match (returns all adapters if omitted).
+    # @return [Array<IbmPowerHmc::VirtualSCSIClientAdapter>, IbmPowerHmc::VirtualSCSIClientAdapter] The list of storage adapters.
+    def vscsi_client_adapter(lpar_uuid, adap_uuid = nil)
+      if adap_uuid.nil?
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualSCSIClientAdapter"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:VirtualSCSIClientAdapter)
+      else
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualSCSIClientAdapter/#{adap_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:VirtualSCSIClientAdapter)
+      end
+    end
+
+    ##
+    # @!method vfc_client_adapter(lpar_uuid, adap_uuid = nil)
+    # Retrieve one or all virtual Fibre Channel storage client adapters attached to a logical partition.
+    # @param lpar_uuid [String] UUID of the logical partition.
+    # @param adap_uuid [String] UUID of the adapter to match (returns all adapters if omitted).
+    # @return [Array<IbmPowerHmc::VirtualFibreChannelClientAdapter>, IbmPowerHmc::VirtualFibreChannelClientAdapter] The list of storage adapters.
+    def vfc_client_adapter(lpar_uuid, adap_uuid = nil)
+      if adap_uuid.nil?
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualFibreChannelClientAdapter"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:VirtualFibreChannelClientAdapter)
+      else
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualFibreChannelClientAdapter/#{adap_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:VirtualFibreChannelClientAdapter)
+      end
+    end
+
     ##
     # @!method clusters
     # Retrieve the list of clusters managed by the HMC.
@@ -388,6 +460,24 @@ module IbmPowerHmc
       Parser.new(response.body).object(:Tier)
     end
 
+    ##
+    # @!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)
+    # @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?
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/SharedProcessorPool"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:SharedProcessorPool)
+      else
+        method_url = "/rest/api/uom/ManagedSystem/#{sys_uuid}/SharedProcessorPool/#{pool_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:SharedProcessorPool)
+      end
+    end
+
     ##
     # @!method templates_summary(draft = false)
     # Retrieve the list of partition template summaries.
@@ -768,8 +858,7 @@ module IbmPowerHmc
           :url => url,
           :verify_ssl => @verify_ssl,
           :payload => payload,
-          :headers => headers,
-          :timeout => @timeout
+          :headers => headers
         )
       rescue RestClient::Exception => e
         # Do not retry on failed logon attempts.

data/lib/ibm_power_hmc/parser.rb

@@ -896,6 +896,22 @@ module IbmPowerHmc
     }.freeze
   end
 
+  # Shared Processor Pool
+  class SharedProcessorPool < AbstractRest
+    ATTRS = {
+      :name => "PoolName",
+      :available => "AvailableProcUnits",
+      :max => "MaximumProcessingUnits",
+      :reserved => "CurrentReservedProcessingUnits",
+      :pending_reserved => "PendingReservedProcessingUnits",
+      :pool_id => "PoolID"
+    }.freeze
+
+    def lpar_uuids
+      uuids_from_links("AssignedPartitions")
+    end
+  end
+
   class PartitionTemplateSummary < AbstractRest
     ATTRS = {
       :name => "partitionTemplateName"

data/lib/ibm_power_hmc/version.rb

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

metadata

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