Helm

Starting with CSM 1.12, all deployments will need to use images from quay.io. Please note that from CSM 1.14 (May 2025), upgrading with helm will fail if it attempts to use images from Docker Hub.

Upgrades to the CSI Driver for Dell PowerMax can be made using Helm or Dell CSM Operator.

Note: CSI Driver for PowerMax v2.4.0 and later requires Unisphere version 10.0, or later.

Updating the CSI Driver to use 10.0 Unisphere

  1. Upgrade the Unisphere to have 10.0 endpoint support. Please find the instructions here.
  2. Update the powermax-creds secret to specify endpoints with Unisphere version 10.0 support.

Update Driver from v2.13.0 to v2.14.0 using Helm

Steps

  1. Clone the csi-powermax repository, using the latest release branch. This will include the Helm charts and dell-csi-helm-installer scripts.
    git clone -b v2.14.0 https://github.com/dell/csi-powermax.git
    cd ./csi-powermax
    
  2. As of CSI PowerMax v2.14.0, the csi reverse proxy configuration and connectivity information has been migrated from a ConfigMap to a Secret. If the powermax-creds secret format was not previously updated, reference Step 2 in CSI Driver installation steps.

Note: The powermax-reverseproxy-config remains for backward compatibility only. Use of the powermax-creds Secret, as outlined above, is recommended. If you would like to continue using the powemax-reverseproxy-config ConfigMap, set global.useSecret: false in your helm values file, and skip the creation of this Secret.

  1. Download the latest helm values file and update as needed. Reference the CSI Driver installation steps for more details on the available options.

    cd ./dell-csi-helm-installer
    wget -O my-powermax-settings.yaml https://github.com/dell/helm-charts/raw/csi-powermax-2.14.0/charts/csi-powermax/values.yaml
    
  2. Confirm the value of global.useSecret is set to true if electing to use the new secret format, and false otherwise.

  3. Run the csi-install script with the option --upgrade by running:

    ./csi-install.sh --namespace powermax --values ./my-powermax-settings.yaml --upgrade --helm-charts-version <version>
    

Note: Powermax-array-config is deprecated and remains for backward compatibility only.

Notes:

  • The parameter --helm-charts-version is optional and if you do not specify the flag, by default the csi-install.sh script will clone the version of the helm chart that is specified in the driver’s csi-install.sh file. If you wish to install the driver using a different version of the helm chart, you need to include this flag. Also, remember to delete the helm-charts repository present in the csi-powermax directory if it was cloned before.

  • If you are upgrading from a driver version that was installed using Helm v2, ensure that you install Helm3 before installing the driver.

  • To update any installation parameter after the driver has been installed, change the my-powermax-settings.yaml file and run the install script with the option --upgrade, for example:

    ./csi-install.sh --namespace powermax --values ./my-powermax-settings.yaml –upgrade
    
  • You cannot upgrade between drivers with different fsGroupPolicies. To check the current driver’s fsGroupPolicy, use this command:

    kubectl describe csidriver csi-powermax
    

    and check the “Spec” section:

    ...
    Spec:
      Attach Required:     true
      Fs Group Policy:     ReadWriteOnceWithFSType
      Pod Info On Mount:   false
      Requires Republish:  false
      Storage Capacity:    false
    ...