powerflex storage capacity docs changes.

dell · Aug 19, 2023 · e16cc32 · e16cc32
1 parent df5a7f2
commit e16cc32
Show file tree

Hide file tree

Showing 6 changed files with 17 additions and 1 deletion.
diff --git a/content/docs/csidriver/_index.md b/content/docs/csidriver/_index.md
@@ -48,7 +48,7 @@ The CSI Drivers by Dell implement an interface between [CSI](https://kubernetes-
 | Topology                 | yes      | yes       | yes       | yes        | yes        |
 | Multi-array              | yes      | yes       | yes       | yes        | yes        |
 | Volume Health Monitoring | yes      | yes       | yes       | yes        | yes        |
-| Storage Capacity Tracking | yes      | no        | yes        | yes        | yes        |
+| Storage Capacity Tracking | yes      | yes        | yes        | yes        | yes        |
 {{</table>}}
 ### Supported Storage Platforms
 {{<table "table table-striped table-bordered table-sm">}}

diff --git a/content/docs/csidriver/features/powerflex.md b/content/docs/csidriver/features/powerflex.md
@@ -658,6 +658,16 @@ Warning  VolumeConditionAbnormal      35s (x9 over 12m)  kubelet       Volume vo
 Warning  VolumeConditionAbnormal      5s                 kubelet       Volume vol2: Volume is not found by node driver at 2021-11-11 02:04:49
 ```
 
+## Storage Capacity Tracking
+CSI-PowerFlex driver version 2.8.0 and above supports Storage Capacity Tracking.
+
+This feature helps the scheduler to make more informed choices about where to schedule pods which depends on unbound volumes with late binding (aka "wait for first consumer"). Pods will be scheduled on a node (satisfying the topology constraints) only if the requested capacity is available on the storage array.
+If such a node is not available, the pods stay in Pending state. This means pods are not scheduled.
+
+Without storage capacity tracking, pods get scheduled on a node satisfying the topology constraints. If the required capacity is not available, volume attachment to the pods fails, and pods remain in ContainerCreating state. Storage capacity tracking eliminates unnecessary scheduling of pods when there is insufficient capacity.
+
+The attribute `storageCapacity.enabled` in `values.yaml` can be used to enable/disable the feature during driver installation using helm. This is by default set to true. To configure how often driver checks for changed capacity set `storageCapacity.pollInterval` attribute. In case of driver installed via operator, this interval can be configured in the sample file provided [here.](https://github.com/dell/csm-operator/blob/main/samples/storage_csm_powerflex_v280.yaml) by editing the `--capacity-poll-interval` argument present in the provisioner sidecar.
+
 ## Set QoS Limits
 Starting in version 2.5, CSI Driver for PowerFlex now supports setting the limits for the bandwidth and IOPS that one SDC generates for the specified volume. This enables the CSI driver to control the quality of service (QoS).
 In this release this is supported at the StorageClass level, so once a volume is created QoS Settings can't be adjusted later.

diff --git a/content/docs/csidriver/installation/helm/powerflex.md b/content/docs/csidriver/installation/helm/powerflex.md
@@ -183,6 +183,8 @@ Use the below command to replace or update the secret:
 | enabled | A boolean that enable/disable rename SDC feature. | No | false |
 | prefix | Defines a string for the prefix of the SDC. | No | " " |
 | approveSDC.enabled | A boolean that enable/disable SDC approval feature. | No | false |
+| storageCapacity.enabled | Enable/Disable storage capacity tracking | No | true |
+| storageCapacity.pollInterval | Configure how often the driver checks for changed capacity | No | 5m |
 | **monitor**              | This section allows the configuration of the SDC monitoring pod.                                                                                                                                                                                                                                                                                                                                                  | -        | -       |
 | enabled                  | Set to enable the usage of the monitoring pod.                                                                                                                                                                                                                                                                                                                                                                | Yes     | false |
 | hostNetwork              | Set whether the monitor pod should run on the host network or not.                                                                                                                                                                                                                                                                                                                                            | Yes     | true |

diff --git a/content/docs/csidriver/release/powerflex.md b/content/docs/csidriver/release/powerflex.md
@@ -8,6 +8,7 @@ description: Release notes for PowerFlex CSI driver
 ### New Features/Changes
 - [Added support for OpenShift 4.13](https://github.com/dell/csm/issues/724)
 - [Enabled volume limits feature](https://github.com/dell/csm/issues/878)
+- [Added support for Storage Capacity Tracking feature](https://github.com/dell/csm/issues/876)
 
 ### Fixed Issues
 - 

diff --git a/content/docs/deployment/csmoperator/drivers/powerflex.md b/content/docs/deployment/csmoperator/drivers/powerflex.md
@@ -158,6 +158,8 @@ For detailed PowerFlex installation procedure, see the _Dell PowerFlex Deploymen
    | dnsPolicy | Determines the DNS Policy of the Node service | Yes | ClusterFirstWithHostNet |
    | fsGroupPolicy | Defines which FS Group policy mode to be used, Supported modes `None, File and ReadWriteOnceWithFSType` | No | "ReadWriteOnceWithFSType" |
    | replicas | Controls the number of controller pods you deploy. If the number of controller pods is greater than the number of available nodes, excess pods will become stay in a pending state. Defaults are 2 which allows for Controller high availability. | Yes | 2 |
+   | storageCapacity.enabled | Enable/Disable storage capacity tracking | No | true |
+   | storageCapacity.pollInterval | Configure how often the driver checks for changed capacity | No | 5m |
    | ***Common parameters for node and controller*** |
    | X_CSI_VXFLEXOS_ENABLELISTVOLUMESNAPSHOT | Enable list volume operation to include snapshots (since creating a volume from a snap actually results in a new snap) | No | false |
    | X_CSI_VXFLEXOS_ENABLESNAPSHOTCGDELETE | Enable this to automatically delete all snapshots in a consistency group when a snap in the group is deleted | No | false |

diff --git a/content/docs/deployment/csmoperator/release/_index.md b/content/docs/deployment/csmoperator/release/_index.md
@@ -10,6 +10,7 @@ Description: >
 
 ### New Features/Changes
 - [Added support for Storage Capacity Tracking feature for Unity XT](https://github.com/dell/csm/issues/876)
+- [Added support for Storage Capacity Tracking feature for PowerFlex](https://github.com/dell/csm/issues/876)
 
 ### Fixed Issues