ibm_power_hmc 0.24.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa2829db70216f23c73d2d06e8daebdbc2be4f3bde1f8f17d2659961288caa19
-  data.tar.gz: cb7a7cabacbf9efffe013715af8b0e4c5cc4fdf6b941cd0ef42cc8d19861fea5
+  metadata.gz: b15e5d3ed25c9329a63b1655da54869b5f0a979f7775149209648d86a0fa67ad
+  data.tar.gz: c1c78e4c661ef6c90ea743245b3e5c29777e7ab51e276a088ca9206d814b99ce
 SHA512:
-  metadata.gz: 390b00cf4dd7f4fd83ef4c8619d25274f3b708fe5bdc075eef77b8bd7f199875b2003cbc203ecdf3adbee4518a8905bd59003bd238a7c81033504e0763971943
-  data.tar.gz: 7fee8e0a80ce4b266b27469706e00dd8804a5f706a272301751680bc660bf04d6398583c8268a0b8e28176da6e4f96c161b22f4d71813c4b1b101c6c5872fa5a
+  metadata.gz: 379f4c199e6c5a818617608060d98fe75413856b588760a6c0a2a946002858d7df52ce2b86ba54a4af9a2de3b61391828d3fbca4457dae93319c37cc2813bec9
+  data.tar.gz: 5299f74322afac43f91af2a131b5fb1521fc0f3ca3ed87106405006ef181eaa9d776b80e1501f13dabdbdee9630ba3868a47b0839ba88458f88b2782ed43623b

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## v0.25.0
+* Add `vios_uuid` as alias to `lpar_uuid` for VFC schema definition
+* Add `lpar_delete_vios_mappings` util method
+* Add option to `lpar_delete` to delete associated VIOS VSCSI/VFC mappings
 ## v0.24.0
 * Add schema methods to modify VSCSI and VFC mappings
 * Add schema definition for IOSlot

data/lib/ibm_power_hmc/apis/templates.rb

@@ -119,20 +119,6 @@ module IbmPowerHmc
       job
     end
 
-    ##
-    # @!method template_provision(template_uuid, target_sys_uuid, changes)
-    # Deploy Logical Partition from a Template (performs Check, Transform and Deploy steps in a single method).
-    # @param template_uuid [String] The UUID of the Template to deploy an LPAR from.
-    # @param target_sys_uuid [String] The UUID of the Managed System to deploy the LPAR on.
-    # @param changes [Hash] Modifications to apply to the Template before deploying Logical Partition.
-    # @return [String] The UUID of the deployed Logical Partition.
-    def template_provision(template_uuid, target_sys_uuid, changes)
-      draft_uuid = template_check(template_uuid, target_sys_uuid).results["TEMPLATE_UUID"]
-      template_transform(draft_uuid, target_sys_uuid)
-      template_modify(draft_uuid, changes)
-      template_deploy(draft_uuid, target_sys_uuid).results["PartitionUuid"]
-    end
-
     ##
     # @!method template_modify(template_uuid, changes)
     # Modify a template.

data/lib/ibm_power_hmc/apis/uom.rb

@@ -168,11 +168,15 @@ module IbmPowerHmc
     end
 
     ##
-    # @!method lpar_delete(lpar_uuid)
+    # @!method lpar_delete(lpar_uuid, delete_vios_mappings: false)
     # Delete a logical partition.
     # @param lpar_uuid [String] The UUID of the logical partition to delete.
-    def lpar_delete(lpar_uuid)
+    # @param delete_vios_mappings [Boolean] Delete associated VIOS VFC and VSCSI server adapters.
+    def lpar_delete(lpar_uuid, delete_vios_mappings: false)
       method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}"
+
+      lpar_delete_vios_mappings(lpar_uuid) if delete_vios_mappings
+
       request(:delete, method_url)
       # Returns HTTP 204 if ok
     end

data/lib/ibm_power_hmc/schema/uom.rb

@@ -843,6 +843,8 @@ module IbmPowerHmc
 
   # VFC client information
   class VirtualFibreChannelClientAdapter < VirtualFibreChannelAdapter
+    alias vios_uuid lpar_uuid
+
     def nport_loggedin
       collection_of("NportLoggedInStatus", "VirtualFibreChannelNPortLoginStatus")
     end

data/lib/ibm_power_hmc/utils.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module IbmPowerHmc
+  class Connection
+    ##
+    # @!method lpar_delete_vios_mappings(lpar_uuid)
+    # Delete VIOS VSCSI and VFC mappings associated to a given logical partition.
+    # @param lpar_uuid [String] The logical partition UUID.
+    def lpar_delete_vios_mappings(lpar_uuid)
+      vscsi_client_adapter(lpar_uuid).concat(vfc_client_adapter(lpar_uuid)).group_by(&:vios_uuid).each do |vios_uuid, adapters|
+        modify_object do
+          vios(vios_uuid, nil, "ViosSCSIMapping,ViosFCMapping").tap do |vios|
+            adapters.collect(&:server).each do |server|
+              case server
+              when VirtualSCSIServerAdapter
+                vios.vscsi_mapping_delete!(server.location)
+              when VirtualFibreChannelServerAdapter
+                vios.vfc_mapping_delete!(server.location)
+              end
+            end
+          end
+        end
+      end
+    end
+
+    ##
+    # @!method template_provision(template_uuid, target_sys_uuid, changes)
+    # Deploy Logical Partition from a Template (performs Check, Transform and Deploy steps in a single method).
+    # @param template_uuid [String] The UUID of the Template to deploy an LPAR from.
+    # @param target_sys_uuid [String] The UUID of the Managed System to deploy the LPAR on.
+    # @param changes [Hash] Modifications to apply to the Template before deploying Logical Partition.
+    # @return [String] The UUID of the deployed Logical Partition.
+    def template_provision(template_uuid, target_sys_uuid, changes)
+      draft_uuid = template_check(template_uuid, target_sys_uuid).results["TEMPLATE_UUID"]
+      template_transform(draft_uuid, target_sys_uuid)
+      template_modify(draft_uuid, changes)
+      template_deploy(draft_uuid, target_sys_uuid).results["PartitionUuid"]
+    end
+  end
+end

data/lib/ibm_power_hmc/version.rb

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

data/lib/ibm_power_hmc.rb

@@ -19,4 +19,5 @@ module IbmPowerHmc
   require_relative "./ibm_power_hmc/schema/sem"
   require_relative "./ibm_power_hmc/schema/templates"
   require_relative "./ibm_power_hmc/schema/uom"
+  require_relative "./ibm_power_hmc/utils"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ibm_power_hmc
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.25.0
 platform: ruby
 authors:
 - IBM Power
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-25 00:00:00.000000000 Z
+date: 2022-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -68,6 +68,7 @@ files:
 - lib/ibm_power_hmc/schema/sem.rb
 - lib/ibm_power_hmc/schema/templates.rb
 - lib/ibm_power_hmc/schema/uom.rb
+- lib/ibm_power_hmc/utils.rb
 - lib/ibm_power_hmc/version.rb
 homepage: http://github.com/IBM/ibm_power_hmc_sdk_ruby
 licenses: