Support for Partition Links

Signed-off-by: Andreas Maier <[email protected]>
zhmcclient · Jan 10, 2025 · 5b61c6e · 5b61c6e
1 parent 07eb7e7
commit 5b61c6e
Show file tree

Hide file tree

Showing 15 changed files with 2,068 additions and 3 deletions.
diff --git a/changes/1678.feature.rst b/changes/1678.feature.rst
@@ -0,0 +1,3 @@
+Added support for Partition Links with a new 'zhmcclient.PartitionLink'
+resource class (and corresponding manager class). Added attach/detach/list
+methods for partition links to the 'zhmcclient.Partition' class.
diff --git a/docs/appendix.rst b/docs/appendix.rst
@@ -489,6 +489,11 @@ Resources scoped to CPCs in DPM mode
 
      For details, see section :ref:`Partitions`.
 
+  Partition Link
+     A resource that interconnects two or more :term:`Partitions <Partition>`,
+     using one of multiple interconnect technologies such as SMC-D,
+     Hipersockets, or CTC.
+
   Port
      The physical connector port (jack) of an :term:`Adapter`.
 

diff --git a/docs/resources.rst b/docs/resources.rst
@@ -398,6 +398,26 @@ Storage Volume Templates
    :special-members: __str__
 
 
+.. _`Partition Links`:
+
+Partition Links
+---------------
+
+.. automodule:: zhmcclient._partition_link
+
+.. autoclass:: zhmcclient.PartitionLinkManager
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+.. autoclass:: zhmcclient.PartitionLink
+   :members:
+   :autosummary:
+   :autosummary-inherited-members:
+   :special-members: __str__
+
+
 .. _`Capacity Groups`:
 
 Capacity Groups

diff --git a/examples/list_attached_partition_links.py b/examples/list_attached_partition_links.py
@@ -0,0 +1,81 @@
+#!/usr/bin/env python
+# Copyright 2025 IBM Corp. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Example that lists partition links attached to a partition.
+"""
+
+import sys
+import requests.packages.urllib3
+
+import zhmcclient
+from zhmcclient.testutils import hmc_definitions
+
+requests.packages.urllib3.disable_warnings()
+
+# Get HMC info from HMC inventory and vault files
+hmc_def = hmc_definitions()[0]
+nickname = hmc_def.nickname
+host = hmc_def.host
+userid = hmc_def.userid
+password = hmc_def.password
+verify_cert = hmc_def.verify_cert
+
+if len(sys.argv) != 3:
+    print(f"Usage: {sys.argv[0]} CPC PARTITION")
+    sys.exit(2)
+
+cpc_name = sys.argv[1]
+part_name = sys.argv[2]
+
+print(__doc__)
+
+print(f"Using HMC {nickname} at {host} with userid {userid} ...")
+
+print("Creating a session with the HMC ...")
+try:
+    session = zhmcclient.Session(
+        host, userid, password, verify_cert=verify_cert)
+except zhmcclient.Error as exc:
+    print(f"Error: Cannot establish session with HMC {host}: "
+          f"{exc.__class__.__name__}: {exc}")
+    sys.exit(1)
+
+try:
+    client = zhmcclient.Client(session)
+    console = client.consoles.console
+
+    print(f"Finding partition {part_name} on CPC {cpc_name} ...")
+    cpc = client.cpcs.find(name=cpc_name)
+    part = cpc.partitions.find(name=part_name)
+
+    print(f"Listing partition links attached to partition {part_name} ...")
+    partition_links = part.list_attached_partition_links()
+
+    print()
+    print("Partition Link        Type          State       Attached partitions")
+    print("---------------------------------------------------------------------------------------")
+    for pl in partition_links:
+        name = pl.get_property('name')
+        type = pl.get_property('type')
+        state = pl.get_property('state')
+        attached_parts = pl.list_attached_partitions()
+        attached_part_names = [p.name for p in attached_parts]
+        print(f"{name:20s}  {type:12s}  {state:10}  {', '.join(attached_part_names)}")
+    print()
+
+finally:
+    print("Logging off ...")
+    session.logoff()
diff --git a/examples/list_partition_links.py b/examples/list_partition_links.py
@@ -0,0 +1,74 @@
+#!/usr/bin/env python
+# Copyright 2024 IBM Corp. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Example that lists partition links.
+"""
+
+import sys
+import requests.packages.urllib3
+from pprint import pprint
+
+import zhmcclient
+from zhmcclient.testutils import hmc_definitions
+
+requests.packages.urllib3.disable_warnings()
+
+# Get HMC info from HMC inventory and vault files
+hmc_def = hmc_definitions()[0]
+nickname = hmc_def.nickname
+host = hmc_def.host
+userid = hmc_def.userid
+password = hmc_def.password
+verify_cert = hmc_def.verify_cert
+
+# Whether to list partition links with full properties
+full_properties = False
+
+print(__doc__)
+
+print(f"Using HMC {nickname} at {host} with userid {userid} ...")
+
+print("Creating a session with the HMC ...")
+try:
+    session = zhmcclient.Session(
+        host, userid, password, verify_cert=verify_cert)
+except zhmcclient.Error as exc:
+    print(f"Error: Cannot establish session with HMC {host}: "
+          f"{exc.__class__.__name__}: {exc}")
+    sys.exit(1)
+
+try:
+    client = zhmcclient.Client(session)
+    console = client.consoles.console
+
+    print(f"Listing all partition links ...")
+    partition_links = console.partition_links.list()
+
+    print()
+    print("Partition Link        Type          State       Attached partitions")
+    print("---------------------------------------------------------------------------------------")
+    for pl in partition_links:
+        name = pl.get_property('name')
+        type = pl.get_property('type')
+        state = pl.get_property('state')
+        attached_parts = pl.list_attached_partitions()
+        attached_part_names = [p.name for p in attached_parts]
+        print(f"{name:20s}  {type:12s}  {state:10}  {', '.join(attached_part_names)}")
+    print()
+
+finally:
+    print("Logging off ...")
+    session.logoff()
diff --git a/examples/partition_link_attached_partitions.py b/examples/partition_link_attached_partitions.py
@@ -0,0 +1,76 @@
+#!/usr/bin/env python
+# Copyright 2024 IBM Corp. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Example that lists the attached partitions of a partition link.
+"""
+
+import sys
+import requests.packages.urllib3
+from pprint import pprint
+
+import zhmcclient
+from zhmcclient.testutils import hmc_definitions
+
+requests.packages.urllib3.disable_warnings()
+
+# Get HMC info from HMC inventory and vault files
+hmc_def = hmc_definitions()[0]
+nickname = hmc_def.nickname
+host = hmc_def.host
+userid = hmc_def.userid
+password = hmc_def.password
+verify_cert = hmc_def.verify_cert
+
+# Whether to list partition links with full properties
+full_properties = False
+
+print(__doc__)
+
+print(f"Using HMC {nickname} at {host} with userid {userid} ...")
+
+print("Creating a session with the HMC ...")
+try:
+    session = zhmcclient.Session(
+        host, userid, password, verify_cert=verify_cert)
+except zhmcclient.Error as exc:
+    print(f"Error: Cannot establish session with HMC {host}: "
+          f"{exc.__class__.__name__}: {exc}")
+    sys.exit(1)
+
+try:
+    client = zhmcclient.Client(session)
+    console = client.consoles.console
+
+    print(f"\nListing partition links ...")
+    partition_links = console.partition_links.list(
+        full_properties=full_properties)
+    print(f"Number of partition links: {len(partition_links)}")
+
+    print(f"\nAttached partitions for all partition links:")
+    for pl in partition_links:
+        pl_type = pl.get_property('type')
+        pl_state = pl.get_property('state')
+        print(f"\nPartition Link {pl.name!r}:")
+        print(f"  Type: {pl_type}")
+        print(f"  State: {pl_state}")
+        print(f"  Attached partitions:")
+        parts = pl.list_attached_partitions()
+        for part in parts:
+            print(f"    {part.name}")
+
+finally:
+    print("Logging off ...")
+    session.logoff()