diff --git a/content/docs/csidriver/features/powerscale.md b/content/docs/csidriver/features/powerscale.md index ca7675ee27..f60af64b30 100644 --- a/content/docs/csidriver/features/powerscale.md +++ b/content/docs/csidriver/features/powerscale.md @@ -129,7 +129,7 @@ Following are the manifests for the Volume Snapshot Class: 1. VolumeSnapshotClass ```yaml -# For kubernetes version 20 and above (v1 snaps) + apiVersion: snapshot.storage.k8s.io/v1 kind: VolumeSnapshotClass metadata: @@ -542,7 +542,7 @@ For example, if a volume were to be deleted from the array, or unmounted outside ## Single Pod Access Mode for PersistentVolumes- ReadWriteOncePod (ALPHA FEATURE) -Use `ReadWriteOncePod(RWOP)` access mode if you want to ensure that only one pod across the whole cluster can read that PVC or write to it. This is only supported for CSI Driver for PowerScale 2.1.0 and Kubernetes version 1.22+. +Use `ReadWriteOncePod(RWOP)` access mode if you want to ensure that only one pod across the whole cluster can read that PVC or write to it. This is supported for CSI Driver for PowerScale 2.1.0+ and Kubernetes version 1.22+. To use this feature, enable the ReadWriteOncePod feature gate for kube-apiserver, kube-scheduler, and kubelet, by setting command line arguments: `--feature-gates="...,ReadWriteOncePod=true"` diff --git a/content/docs/csidriver/installation/helm/isilon.md b/content/docs/csidriver/installation/helm/isilon.md index 820c8a8a6f..d234799c7d 100644 --- a/content/docs/csidriver/installation/helm/isilon.md +++ b/content/docs/csidriver/installation/helm/isilon.md @@ -24,6 +24,7 @@ The following are requirements to be met before installing the CSI Driver for De - Mount propagation is enabled on container runtime that is being used - If using Snapshot feature, satisfy all Volume Snapshot requirements - If enabling CSM for Authorization, please refer to the [Authorization deployment steps](../../../../authorization/deployment/) first +- If enabling CSM for Replication, please refer to the [Replication deployment steps](../../../../replication/deployment/) first ### Install Helm 3.0 @@ -118,6 +119,9 @@ CRDs should be configured during replication prepare stage with repctl as descri | healthMonitor.interval | Interval of monitoring volume health condition | Yes | 60s | | nodeSelector | Define node selection constraints for pods of controller deployment | No | | | tolerations | Define tolerations for the controller deployment, if required | No | | + | leader-election-lease-duration | Time duration for one of the controller pods to be a leader | No | 20s | + | leader-election-renew-deadline | Time duration for the selection of leader to expire | No | 15s | + | leader-election-retry-period | Time duration post which an attempt is made to become leader | No | 5s | | ***node*** | Configure node pod specific parameters | | | | nodeSelector | Define node selection constraints for pods of node daemonset | No | | | tolerations | Define tolerations for the node daemonset, if required | No | | @@ -227,7 +231,7 @@ The CSI driver for Dell PowerScale version 1.5 and later, `dell-csi-helm-install ### What happens to my existing storage classes? -*Upgrading from CSI PowerScale v2.1 driver* +*Upgrading from CSI PowerScale v2.1 driver*: The storage classes created as part of the installation have an annotation - "helm.sh/resource-policy": keep set. This ensures that even after an uninstall or upgrade, the storage classes are not deleted. You can continue using these storage classes if you wish so. *NOTE*: diff --git a/content/docs/csidriver/installation/operator/isilon.md b/content/docs/csidriver/installation/operator/isilon.md index 35e693d674..5ed3c96ec9 100644 --- a/content/docs/csidriver/installation/operator/isilon.md +++ b/content/docs/csidriver/installation/operator/isilon.md @@ -124,13 +124,20 @@ User can query for CSI-PowerScale driver using the following command: | X_CSI_ISI_AUTOPROBE | To enable auto probing for driver | No | true | | X_CSI_ISI_NO_PROBE_ON_START | Indicates whether the controller/node should probe during initialization | Yes | | | X_CSI_ISI_VOLUME_PATH_PERMISSIONS | The permissions for isi volume directory path | Yes | 0777 | + | X_CSI_ISI_AUTH_TYPE | Indicates the authentication method to be used. If set to 1 then it follows as session-based authentication else basic authentication | No | 0 | | ***Controller parameters*** | | X_CSI_MODE | Driver starting mode | No | controller | | X_CSI_ISI_ACCESS_ZONE | Name of the access zone a volume can be created in | No | System | - | X_CSI_ISI_QUOTA_ENABLED | To enable SmartQuotas | Yes | | + | X_CSI_ISI_QUOTA_ENABLED | To enable SmartQuotas | Yes | | + | nodeSelector | Define node selection constraints for pods of controller deployment | No | | | ***Node parameters*** | | X_CSI_MAX_VOLUMES_PER_NODE | Specify the default value for the maximum number of volumes that the controller can publish to the node | Yes | 0 | - | X_CSI_MODE | Driver starting mode | No | node | + | X_CSI_MODE | Driver starting mode | No | node | + | ***Side car parameters*** | + | leader-election-lease-duration | Time duration for one of the controller pods to be a leader | No | 20s | + | leader-election-renew-deadline | Time duration for the selection of leader to expire | No | 15s | + | leader-election-retry-period | Time duration post which an attempt is made to become leaders | No | 5s | + 6. Execute the following command to create PowerScale custom resource: ```kubectl create -f ``` . This command will deploy the CSI-PowerScale driver in the namespace specified in the input YAML file. @@ -140,3 +147,36 @@ User can query for CSI-PowerScale driver using the following command: 2. Node selector and node tolerations can be added in both controller parameters and node parameters section, based on the need. 3. "Kubelet config dir path" is not yet configurable in case of Operator based driver installation. 4. Also, snapshotter and resizer sidecars are not optional to choose, it comes default with Driver installation. + +## Volume Health Monitoring +Volume Health Monitoring feature is optional and by default this feature is disabled for drivers when installed via operator. + +To enable this feature, add the below block to the driver manifest before installing the driver. This ensures to install external +health monitor sidecar. To get the volume health state value under controller should be set to true as seen below. To get the +volume stats value under node should be set to true. + + ```yaml + # Uncomment the following to install 'external-health-monitor' sidecar to enable health monitor of CSI volumes from Controller plugin. + # Also set the env variable controller.envs.X_CSI_HEALTH_MONITOR_ENABLED to "true". + # - name: external-health-monitor + # args: ["--monitor-interval=60s"] + + # Install the 'external-health-monitor' sidecar accordingly. + # Allowed values: + # true: enable checking of health condition of CSI volumes + # false: disable checking of health condition of CSI volumes + # Default value: false + controller: + envs: + - name: X_CSI_HEALTH_MONITOR_ENABLED + value: "true" + node: + envs: + # X_CSI_HEALTH_MONITOR_ENABLED: Enable/Disable health monitor of CSI volumes from node plugin - volume usage + # Allowed values: + # true: enable checking of health condition of CSI volumes + # false: disable checking of health condition of CSI volumes + # Default value: false + - name: X_CSI_HEALTH_MONITOR_ENABLED + value: "true" + ``` diff --git a/content/docs/csidriver/upgradation/drivers/isilon.md b/content/docs/csidriver/upgradation/drivers/isilon.md index 56bf93061e..e473a299e4 100644 --- a/content/docs/csidriver/upgradation/drivers/isilon.md +++ b/content/docs/csidriver/upgradation/drivers/isilon.md @@ -15,7 +15,7 @@ You can upgrade the CSI Driver for Dell PowerScale using Helm or Dell CSI Operat **Steps** 1. Clone the repository using `git clone -b v2.2.0 https://github.com/dell/csi-powerscale.git`, copy the helm/csi-isilon/values.yaml into a new location with a custom name say _my-isilon-settings.yaml_, to customize settings for installation. Edit _my-isilon-settings.yaml_ as per the requirements. 2. Change to directory dell-csi-helm-installer to install the Dell PowerScale `cd dell-csi-helm-installer` -3. Upgrade the CSI Driver for Dell PowerScale version 2.1.0 using following command: +3. Upgrade the CSI Driver for Dell PowerScale using following command: `./csi-install.sh --namespace isilon --values ./my-isilon-settings.yaml --upgrade`