docs updates: Add 1.12.5 missing updates, support for k8s1.34, ocp4.20, Z and Power, and several small additions

shlomitn · shlomitn · commit f62022673aa3 · 2025-12-11T16:37:47.000+02:00
Signed-off-by: Shlomit Neufeld &lt;shlomitn@il.ibm.com&gt;
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
@@ -11,8 +11,8 @@
         * [Lifecycle and support matrix](content/release_notes/lifecycle_support_matrix.md)
         * [Features and Capabilities](content/release_notes/features_and_capabilities.md)
     * [Change log](content/release_notes/change_log.md)
-        * [1.13.0 (TBD)](content/release_notes/changelog_1.13.0.md)
-        * [1.12.5 (TBD)](content/release_notes/changelog_1.12.5.md)
+        * [1.13.0 (December 2025)](content/release_notes/changelog_1.13.0.md)
+        * [1.12.5 (August 2025)](content/release_notes/changelog_1.12.5.md)
         * [1.12.4 (June 2025)](content/release_notes/changelog_1.12.4.md)
         * [1.12.3 (May 2025)](content/release_notes/changelog_1.12.3.md)
         * [1.12.2 (April 2025)](content/release_notes/changelog_1.12.2.md)
diff --git a/docs/book_files/csi_block_storage_kc_whatsnew.md b/docs/book_files/csi_block_storage_kc_whatsnew.md
@@ -4,5 +4,5 @@ This topic lists the dates and nature of updates to the published information of
 
 | Date            | Nature of updates to the published information                                                                                                                                                          |
 |-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| TBD        | The version information was added to IBM Documentation.<br>For more information about this version, see the [What's new in 1.13.0](../content/release_notes/whats_new.md) section in the release notes. |
+| December 2025   | The version information was added to IBM Documentation.<br>For more information about this version, see the [What's new in 1.13.0](../content/release_notes/whats_new.md) section in the release notes. |
 
diff --git a/docs/content/configuration/configuring_hostdefiner.md b/docs/content/configuration/configuring_hostdefiner.md
@@ -14,24 +14,40 @@ Use standard configmap CLIs to update the configuration, examples below.
 All CLIs accept an optional -n parameter to specify the namepsace
 
 Create/update a configuration parameter (replace key value with actual parameter setting):
+```
   kubectl create configmap ibm-csi-hostdefiner-config --from-literal=key=value
+```
+The key may be any key from the below table, under Field. The possible values are also specified in the table.
 
 Get a ConfigMap
+```
   kubectl get configmap ibm-csi-hostdefiner-config
+```
 
 Delete a ConfigMap:
+```
   kubectl delete configmap ibm-csi-hostdefiner-config
+```
 
 Delete a ConfigMap entry:
-  There's no simple command to delete an entry. You can either use:
+
+There's no simple command to delete an entry. You can either use:
+```
   kubectl edit configmap ibm-csi-hostdefiner-config
-    Which opens the editor to edit the config map.
+```
+
+  Which opens the editor to edit the config map.
   OR you can patch the config map:
+```
   kubectl get configmap ibm-csi-hostdefiner-config -o yaml > ibm-csi-hostdefiner-config.yaml
+```
+
   edit yaml and then reapply:
+```
   kubectl apply -f ibm-csi-hostdefiner-config.yaml
+```
 
-Consider [configuring dynamic host definition labels](../using/using_hostdefinition_labels.md) when possible to preserve HostDefiner customizations during IBM® Block Storage CSI driver upgrades.{: tip}
+Consider [configuring dynamic host definition labels](../using/using_hostdefinition_labels.md) for node-specific customizations.{: tip}
 
 For more information about using the host definer, see [Using dynamic host definition](../using/using_hostdefinition.md).
 
diff --git a/docs/content/release_notes/changelog_1.12.0.md b/docs/content/release_notes/changelog_1.12.0.md
@@ -3,8 +3,6 @@
 
 # 1.12.0 (December 2024)
 
-As of this document's publication date, IBM Power® and zLinux® architectures are not supported for this release. {: restriction}
-
 IBM® Block Storage CSI driver 1.12.0 added new support and enhancements.
 - Added support for PVC ReadWriteMany (RWX) access mode
 - Added FlashSystem-specific configuration option for host definer portSet to set the port set for new ports created by host definer
diff --git a/docs/content/release_notes/changelog_1.12.1.md b/docs/content/release_notes/changelog_1.12.1.md
@@ -3,8 +3,6 @@
 
 # 1.12.1 (February 2025)
 
-As of this document's publication date, IBM Power® and zLinux® architectures are not supported for this release. {: restriction}
-
 IBM® Block Storage CSI driver 1.12.1 added new support and enhancements.
 - Extended support to RedHat OpenShift® 4.18
 - Extended support to Kubernetes 1.32
diff --git a/docs/content/release_notes/changelog_1.12.5.md b/docs/content/release_notes/changelog_1.12.5.md
@@ -1,18 +1,18 @@
 
 {{site.data.keyword.attribute-definition-list}}
 
-# 1.12.5 (TBD)
+# 1.12.5 (August 2025)
 
-As of this document's publication date, the IBM Power® and zLinux® architectures are not supported for this release.{: restriction}
 
 As of this document's publication date, NVMe/FC is not supported for this release.{: restriction}
 
-IBM® Block Storage CSI driver 1.12.5 added new support and enhancements.
-- TBD
+IBM® Block Storage CSI driver 1.12.5 added new support and enhancements:
+- Mitigation for OS hanging scsi devices
 
 For more information regarding the IBM FlashSystem® Call Home feature, search IBM.com/docs for your product's documentation.{: tip}
 
 IBM® block storage CSI driver version 1.12.5 resolved the following issues:
 
 |Ticket ID|Severity|Description|
 |---------|--------|-----------|
+|CSI-5856|Medium|Remove ghost scsi devices|
diff --git a/docs/content/release_notes/changelog_1.13.0.md b/docs/content/release_notes/changelog_1.13.0.md
@@ -1,20 +1,20 @@
 
 {{site.data.keyword.attribute-definition-list}}
 
-# 1.13.0 (TBD)
-
-As of this document's publication date, the IBM Power® and zLinux® architectures are not supported for this release.{: restriction}
+# 1.13.0 (December 2025)
 
 As of this document's publication date, NVMe/FC is not supported for this release.{: restriction}
 
 IBM® Block Storage CSI driver 1.13.0 added new support and enhancements.
 - IBM Storage Virtualize® Partitions
+- Extended support to RedHat OpenShift® 4.20
+- Extended support to Kubernetes 1.34
 
 For more information regarding the IBM FlashSystem® Call Home feature, search IBM.com/docs for your product's documentation.{: tip}
 
 IBM® block storage CSI driver version 1.13.0 resolved the following issues:
 
 |Ticket ID|Severity|Description|
 |---------|--------|-----------|
-|**CSI-5900**|Medium|Configuration parameters are now saved in config maps for persistency|
-|**CSI-4095**|Medium|Removed internal restriction for maximum usable volumes on IBM Storage Virtualize® storage|
+|**CSI-5900**|Medium|Configuration parameters are now saved in config maps for upgrade persistency|
+|**CSI-4095**|Medium|Removed internal restriction for maximum usable number of volumes on IBM Storage Virtualize® storage|
diff --git a/docs/content/release_notes/lifecycle_support_matrix.md b/docs/content/release_notes/lifecycle_support_matrix.md
@@ -12,8 +12,8 @@ The following table details the IBM® block storage CSI driver lifecycle with co
 
 |IBM® Block Storage CSI driver version|General availability|End of support|Supported IBM FlashSystem A9000® and A9000R® microcode versions|Supported IBM Storage Virtualize® family microcode versions|Supported IBM DS8000® family versions|Supported operating systems|Supported Kubernetes versions, platform architecture and installation methods|Supported Red Hat OpenShift® versions, platform architecture and installation methods|
 |------------------------------------|--------------------|--------------|---------------------------------------------------------|------------------------------------------------------|--------------------------------|---------------------------|-----------------------------------------------------------------------------|------------------------------------------------------------------------------------|
-|1.13.0|TBD|No|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x, 9.1.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.15, 4.16, 4.17, 4.18, 4.19**|1.31, 1.32, 1.33<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.16, 4.17, 4.18, 4.19<ul><li>x86<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-github)</li></ul></li></ul>|
-|1.12.5|TBD|No|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.15, 4.16, 4.17, 4.18, 4.19**|1.31, 1.32, 1.33<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.15, 4.16, 4.17, 4.18, 4.19<ul><li>x86<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li></ul></li><li>IBM Z, IBM Power<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li></ul></li></ul>|
+|1.13.0|December 2025|No|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x, 9.1.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.16, 4.17, 4.18, 4.19, 4.20**|1.31, 1.32, 1.33, 1.34<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.16, 4.17, 4.18, 4.19, 4.20<ul><li>x86<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.13.0?topic=driver-installing-github)</li></ul></li></ul>|
+|1.12.5|August 2025|15 March 2026|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.15, 4.16, 4.17, 4.18, 4.19**|1.31, 1.32, 1.33<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.15, 4.16, 4.17, 4.18, 4.19<ul><li>x86<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li></ul></li><li>IBM Z, IBM Power<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.5?topic=driver-installing-github)</li></ul></li></ul>|
 |1.12.4|June 2025|15 October 2025|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.15, 4.16, 4.17, 4.18, 4.19**|1.31, 1.32, 1.33<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.4?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.4?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.15, 4.16, 4.17, 4.18, 4.19<ul><li>x86 (certified and community), IBM Power (community), IBM Z (community)<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.4?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.4?topic=driver-installing-github)</li></ul></li></ul>|
 |1.12.3|May 2025|15 September 2025|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.15, 4.16, 4.17, 4.18**|1.30, 1.31, 1.32<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.3?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.3?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.15, 4.16, 4.17, 4.18<ul><li>x86 (certified and community), IBM Power (community), IBM Z (community)<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.3?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.3?topic=driver-installing-github)</li></ul></li></ul>|
 |1.12.2|April 2025|15 August 2025|Not supported|8.4.x, 8.5.x, 8.6.x, 8.7.x|8.x and higher with same API interface|Kubernetes support:<br>**Red Hat Enterprise Linux (RHEL) 8.x**<br>**Red Hat Enterprise Linux (RHEL) 9.x**<br>**Ubuntu 22.04.x LTS**<br>**Ubuntu 24.04.x LTS**<br><br>Red Hat OpenShift support:<br>**Red Hat Enterprise Linux CoreOS (RHCOS) 4.14, 4.15, 4.16, 4.17, 4.18**|1.30, 1.31, 1.32<ul><li>x86<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.2?topic=driver-installing-github)</li><li>[OperatorHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.2?topic=driver-installing-operatorhubio)</li></ul></li></ul>|4.14, 4.15, 4.16, 4.17, 4.18<ul><li>x86<ul><li>[OpenShift Web Console](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.2?topic=driver-installing-openshift-web-console)</li><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.2?topic=driver-installing-github)</li></ul></li><li>IBM Z, IBM Power<ul><li>[GitHub](https://www.ibm.com/docs/en/stg-block-csi-driver/1.12.2?topic=driver-installing-github)</li></ul></li></ul>|
diff --git a/docs/content/release_notes/limitations.md b/docs/content/release_notes/limitations.md
@@ -5,12 +5,6 @@
 
 As opposed to known issues, limitations are functionality restrictions that are part of the predefined system design and capabilities in a particular version.
 
-## Custom configuration limitations
-
-Any configuration changes are reverted upon each IBM® Block Storage CSI driver upgrade. If configuration changes are required, it is recommended to set InstallPlans to manual upgrade only.
-
-Consider [configuring dynamic host definition labels](../using/using_hostdefinition_labels.md) when possible to preserve HostDefiner customizations during IBM® Block Storage CSI driver upgrades.{: tip}
-
 ## IBM DS8000 usage limitations
 
 When using the CSI driver with IBM DS8000® family storage systems:
diff --git a/docs/content/release_notes/supported_orchestration.md b/docs/content/release_notes/supported_orchestration.md
@@ -5,8 +5,6 @@
 
 Kubernetes from 1.32 onwards is not supported on Red Hat Enterprise Linux® (RHEL) 8.x.{: restriction}
 
-As of this document's publication date, the IBM Power® and zLinux® architectures are not supported for this release.{: restriction}
-
 As of this document's publication date, IBM Cloud Satellite® only supports RHEL 8 on x86 architecture for Red Hat OpenShift. For the latest support information, see [Satellite host system requirements](https://cloud.ibm.com/docs/satellite?topic=satellite-host-reqs).{: restriction}
 
 The following table details orchestration platforms suitable for deployment of the IBM® block storage CSI driver.
@@ -16,11 +14,12 @@ The following table details orchestration platforms suitable for deployment of t
 |Kubernetes            | 1.31    |x86|
 |Kubernetes            | 1.32    |x86|
 |Kubernetes            | 1.33    |x86|
-|Red Hat OpenShift®    | 4.15    |x86|
-|Red Hat OpenShift®    | 4.16    |x86|
-|Red Hat OpenShift®    | 4.17    |x86|
-|Red Hat OpenShift®    | 4.18    |x86|
-|Red Hat OpenShift®    | 4.19    |x86|
+|Kubernetes            | 1.34    |x86|
+|Red Hat OpenShift®    | 4.16    |x86, IBM Z®, IBM Power®|
+|Red Hat OpenShift®    | 4.17    |x86, IBM Z®, IBM Power®|
+|Red Hat OpenShift®    | 4.18    |x86, IBM Z®, IBM Power®|
+|Red Hat OpenShift®    | 4.19    |x86, IBM Z®, IBM Power®|
+|Red Hat OpenShift®    | 4.20    |x86, IBM Z®, IBM Power®|
 
 IBM Power® architecture is only supported with IBM Storage Virtualize® family storage systems.{: restriction}
 
diff --git a/docs/content/release_notes/supported_os.md b/docs/content/release_notes/supported_os.md
@@ -5,13 +5,10 @@
 
 Kubernetes from 1.32 onwards is not supported on Red Hat Enterprise Linux® (RHEL) 8.x.{: restriction}
 
-As of this document's publication date, the IBM Power® and zLinux® architectures are not supported for this release.{: restriction}
-
 The following table lists supported operating systems for deployment of the IBM® block storage CSI driver on Kubernetes orchestration platforms:
 
 | Operating system                                     |Architecture|
 |------------------------------------------------------|------------|
-| Red Hat Enterprise Linux® (RHEL) 8.x                 |x86|
 | Red Hat Enterprise Linux® (RHEL) 9.x                 |x86|
 | Ubuntu 22.04.x LTS                                   |x86|
 | Ubuntu 24.04.x LTS                                   |x86|
@@ -20,7 +17,7 @@ The following table lists supported operating systems for deployment of the IBM
 
 | Operating system                                     |Architecture           |
 |------------------------------------------------------|-----------------------|
-| Red Hat Enterprise Linux CoreOS® (RHCOS) 4.15-4.19   |x86|
+| Red Hat Enterprise Linux CoreOS® (RHCOS) 4.16-4.20   |x86, IBM Z®, IBM Power®|
 
 IBM Power® architecture is only supported with IBM Storage Virtualize® family storage systems.{: restriction}
 
diff --git a/docs/content/release_notes/whats_new.md b/docs/content/release_notes/whats_new.md
@@ -2,11 +2,20 @@
 
 IBM® block storage CSI driver 1.13.0 adds support for:
 
-- IBM Storage Virtualize® partitions, including high availability partitions (PBHA)
+- IBM Storage Virtualize® partitions, including Policy Based High Availability (PBHA) on partitions, over host FC only.
 - IBM Storage Virtualize® - option to define secret-specific port set
 
-**General availability date:** TBD
+**General availability date:** December 2025
 
 ## Miscellaneous resolved issues
 
-For information about the resolved issues in version 1.13.0, see [1.13.0 (TBD)](changelog_1.13.0.md).
+For information about the resolved issues in version 1.13.0, see [1.13.0](changelog_1.13.0.md).
+
+If you have any configuration changes that you want saved over upgrade, notice the following:{: attention}
+
+For configuration persistancy over upgrade, a config map procedure was added:
+Prior to upgrading to IBM® block storage CSI driver 1.13.0 (or above) from releases before 1.13.0, please create a configmap with your existing changes, for example:
+`kubectl create configmap ibm-csi-hostdefiner-config --from-literal=portSet=portset64`
+If you have more than one configuration change, you can add more `--from-literal=key=value` at the end of the above line. This configuration will be saved over upgrade.
+
+More info regarding this configmap in [Configuring the host definer](content/configuration/configuring_hostdefiner.md)
