ibm_power_hmc 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c866478ebd950e9570ce2983d62e90b15fdc27163ea77f3b3f5873138b57cf9
-  data.tar.gz: c58488b78a699e4d0f1fc48c43d41db03f9df7c20f861d29e37d80375e8068a2
+  metadata.gz: 288ed57579492fd505491fe8e56f9dbd371cb6aaae118f98c14202fd20e8bf85
+  data.tar.gz: b21286ee62bfa69e14d609ad001b72f012ccbe3fdebc59f090320d03877e6d20
 SHA512:
-  metadata.gz: 8201481418ec67876a0298d8785ca23a7f2e366a4765ddda8e98024fa71a97a79932661d920090b033da9958c3859460865bb56b7379058e02a9d4f688dab523
-  data.tar.gz: cfee7c90c9c22149358b17cf861df4d31d757dde93cf5a30c1196f7957fe48d28bb636643bfbed99238b18215d2048d61c85067b66c8d481bc7678d3fe5ab112
+  metadata.gz: 7d5010709dd4a423ca131c99d3891ef78c4de8a479e87afe402eb554db660f03f2d85b24728d22773ff1681263f4346ff303e08078c4e9b91519e5ad6398a40a
+  data.tar.gz: fd6e00f6bb1039b0320d7fb7959f6a3a2206047fe6ebcb1cc795a6f0f37e92e8740cbe8d980d4fa496bfa6c00d3de6efeafba6f4136b7974630b5d187e4bbc7d

data/lib/ibm_power_hmc/connection.rb

@@ -262,6 +262,44 @@ module IbmPowerHmc
       network_adapter("VirtualIOServer", vios_uuid, netadap_uuid)
     end
 
+    ##
+    # @!method sriov_elp_lpar(lpar_uuid, sriov_elp_uuid = nil)
+    # Retrieve one or all SR-IOV ethernet logical ports attached to a logical partition.
+    # @param lpar_uuid [String] UUID of the logical partition.
+    # @param netadap_uuid [String] UUID of the port to match (returns all ports if omitted).
+    # @return [Array<IbmPowerHmc::ClientNetworkAdapter>, IbmPowerHmc::ClientNetworkAdapter] The list of ports.
+    def sriov_elp_lpar(lpar_uuid, sriov_elp_uuid = nil)
+      sriov_ethernet_port("LogicalPartition", lpar_uuid, sriov_elp_uuid)
+    end
+
+    ##
+    # @!method network_adapter_vios(vios_uuid, netadap_uuid = nil)
+    # Retrieve one or all SR-IOV ethernet logical ports attached to a Virtual I/O Server.
+    # @param vios_uuid [String] UUID of the Virtual I/O Server.
+    # @param netadap_uuid [String] UUID of the port to match (returns all ports if omitted).
+    # @return [Array<IbmPowerHmc::ClientNetworkAdapter>, IbmPowerHmc::ClientNetworkAdapter] The list of ports.
+    def sriov_elp_vios(vios_uuid, sriov_elp_uuid = nil)
+      sriov_ethernet_port("VirtualIOServer", vios_uuid, sriov_elp_uuid)
+    end
+
+    ##
+    # @!method vnic_dedicated(lpar_uuid, vnic_uuid = nil)
+    # Retrieve one or all dedicated virtual network interface controller (vNIC) attached to a logical partition.
+    # @param lpar_uuid [String] UUID of the logical partition.
+    # @param netadap_uuid [String] UUID of the vNIC to match (returns all vNICs if omitted).
+    # @return [Array<IbmPowerHmc::ClientNetworkAdapter>, IbmPowerHmc::ClientNetworkAdapter] The list of vNICs.
+    def vnic_dedicated(lpar_uuid, vnic_uuid = nil)
+      if vnic_uuid.nil?
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualNICDedicated"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:VirtualNICDedicated)
+      else
+        method_url = "/rest/api/uom/LogicalPartition/#{lpar_uuid}/VirtualNICDedicated/#{vnic_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:VirtualNICDedicated)
+      end
+    end
+
     ##
     # @!method poweron_lpar(lpar_uuid, params = {}, sync = true)
     # Power on a logical partition.
@@ -518,5 +556,24 @@ module IbmPowerHmc
         Parser.new(response.body).object(:ClientNetworkAdapter)
       end
     end
+
+    ##
+    # @!method sriov_ethernet_port(vm_type, lpar_uuid, sriov_elp_uuid)
+    # Retrieve one or all SR-IOV Ethernet loical ports attached to a Logical Partition or a Virtual I/O Server.
+    # @param vm_type [String] "LogicalPartition" or "VirtualIOServer".
+    # @param lpar_uuid [String] UUID of the Logical Partition or the Virtual I/O Server.
+    # @param netadap_uuid [String] UUID of the port to match (returns all ports if nil).
+    # @return [Array<IbmPowerHmc::ClientNetworkAdapter>, IbmPowerHmc::ClientNetworkAdapter] The list of ports.
+    def sriov_ethernet_port(vm_type, lpar_uuid, sriov_elp_uuid)
+      if sriov_elp_uuid.nil?
+        method_url = "/rest/api/uom/#{vm_type}/#{lpar_uuid}/SRIOVEthernetLogicalPort"
+        response = request(:get, method_url)
+        FeedParser.new(response.body).objects(:SRIOVEthernetLogicalPort)
+      else
+        method_url = "/rest/api/uom/#{vm_type}/#{lpar_uuid}/SRIOVEthernetLogicalPort/#{sriov_elp_uuid}"
+        response = request(:get, method_url)
+        Parser.new(response.body).object(:SRIOVEthernetLogicalPort)
+      end
+    end
   end
 end

data/lib/ibm_power_hmc/parser.rb

@@ -116,8 +116,14 @@ module IbmPowerHmc
       attr.nil? ? elem.text&.strip : elem.attributes[attr]
     end
 
-    def extract_uuid_from_href(href)
-      URI(href).path.split('/').last
+    def extract_uuid_from_href(href, index = -1)
+      URI(href).path.split('/')[index]
+    end
+
+    def uuids_from_links(elem, index = -1)
+      xml.get_elements("#{elem}/link[@href]").map do |link|
+        extract_uuid_from_href(link.attributes["href"], index)
+      end.compact
     end
   end
 
@@ -165,9 +171,7 @@ module IbmPowerHmc
     }.freeze
 
     def managed_systems_uuids
-      xml.get_elements("ManagedSystems/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("ManagedSystems")
     end
   end
 
@@ -189,15 +193,19 @@ module IbmPowerHmc
     }.freeze
 
     def lpars_uuids
-      xml.get_elements("AssociatedLogicalPartitions/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("AssociatedLogicalPartitions")
     end
 
     def vioses_uuids
-      xml.get_elements("AssociatedVirtualIOServers/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("AssociatedVirtualIOServers")
+    end
+
+    def vswitches_uuids
+      uuids_from_links("AssociatedSystemIOConfiguration/AssociatedSystemVirtualNetwork/VirtualSwitches")
+    end
+
+    def networks_uuids
+      uuids_from_links("AssociatedSystemIOConfiguration/AssociatedSystemVirtualNetwork/VirtualNetworks")
     end
   end
 
@@ -225,9 +233,11 @@ module IbmPowerHmc
     end
 
     def net_adap_uuids
-      xml.get_elements("ClientNetworkAdapters/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("ClientNetworkAdapters")
+    end
+
+    def sriov_elp_uuids
+      uuids_from_links("SRIOVEthernetLogicalPorts")
     end
 
     def name=(name)
@@ -238,6 +248,9 @@ module IbmPowerHmc
 
   # Logical Partition information
   class LogicalPartition < BasePartition
+    def vnic_dedicated_uuids
+      uuids_from_links("DedicatedVirtualNICs")
+    end
   end
 
   # VIOS information
@@ -257,9 +270,7 @@ module IbmPowerHmc
     end
 
     def networks_uuids
-      xml.get_elements("VirtualNetworks/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("VirtualNetworks")
     end
   end
 
@@ -278,9 +289,7 @@ module IbmPowerHmc
     end
 
     def lpars_uuids
-      xml.get_elements("ConnectedPartitions/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("ConnectedPartitions")
     end
   end
 
@@ -299,24 +308,37 @@ module IbmPowerHmc
     ATTRS = ATTRS.merge({
       :macaddr    => "MACAddress",
       :vswitch_id => "VirtualSwitchID",
-      :vlan_id    => "PortVLANID"
+      :vlan_id    => "PortVLANID",
+      :location   => "LocationCode"
     }.freeze)
 
     def vswitch_uuid
-      href = singleton("AssociatedVirtualSwitch/link", "href")
-      extract_uuid_from_href(href)
+      uuids_from_links("AssociatedVirtualSwitch").first
     end
   end
 
   # Client Network Adapter information
   class ClientNetworkAdapter < VirtualEthernetAdapter
     def networks_uuids
-      xml.get_elements("VirtualNetworks/link").map do |link|
-        extract_uuid_from_href(link.attributes["href"])
-      end.compact
+      uuids_from_links("VirtualNetworks")
     end
   end
 
+  class SRIOVEthernetLogicalPort < AbstractRest
+    ATTRS = {
+      :macaddr  => "MACAddress",
+      :location => "LocationCode"
+    }.freeze
+  end
+
+  class VirtualNICDedicated < AbstractRest
+    ATTRS = {
+      :macaddr => "Details/MACAddress",
+      :slot => "VirtualSlotNumber",
+      :location => "DynamicReconfigurationConnectorName"
+    }.freeze
+  end
+
   # HMC Event
   class Event < AbstractRest
     ATTRS = {

data/lib/ibm_power_hmc/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ibm_power_hmc
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - IBM Power
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2021-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client