Skip to main content
Version: 3.1

CSI topology for FlashArray cloud drives

The CSI topology feature for FlashArray Cloud Drives (FACD) allows applications to provision and use cloud drives only on FlashArrays that are in the same zone as a given node. This improves fault tolerance for replicas, performance, and manageability for large clusters.


In order to use the CSI topology feature with a FlashArray Direct Access volume or FlashBlade Direct Access filesystem, you must meet the following prerequisites:

  • Portworx version 3.0.0 or newer installed on a new Kubernetes cluster deployed on infrastructure that meets the minimum requirements for Portworx.


    You cannot enable this feature on an existing Portworx installation.

  • Portworx Operator version 23.5.1 or newer.

  • One or more FlashArrays is reachable from worker nodes.

  • All nodes must have management access to all arrays.

  • All nodes must support iSCSI, FC, and NVMe technologies.

Enable CSI topology

To enable CSI topology, specify the label to describe the topology of each FlashArray.

Prepare your environment

  1. Label your Kubernetes nodes specifying the topology for each FlashArray, for example:

    kubectl label node <nodeName>
    kubectl label node <nodeName>
  2. Create a px-pure-secret containing the information for your FlashArrays with the label. For example:

    "FlashArrays": [
    "MgmtEndPoint": "<managementEndpoint>",
    "APIToken": "<apiToken>",
    "Labels": {
    "": "zone-1"
    "MgmtEndPoint": "<managementEndpoint>",
    "APIToken": "<apiToken>",
    "Labels": {
    "": "zone-2"

Generate the specs

  1. Navigate to Portworx Central and log in, or create an account.

  2. Select Portworx Enterprise from the product catalog and click Continue.

  3. On the Product Line page, choose any option depending on which license you intend to use, then select Continue to start the spec generator.

  4. Choose your Portworx version, platform, and click Customize at the bottom of the Summary section.

  5. Specify your cluster information on the Basic, Storage and Network pages.

  6. On the Customize page, specify the following in the Environment Variables tab:

    • Value: true

    Also, ensure that the Enable CSI checkbox is selected in the Advance Settings tab.
    Click Finish to create the specs.

Apply the specs and verify

  1. Deploy the Operator:

    kubectl apply -f '<version-number>?comp=pxoperator'
    serviceaccount/portworx-operator created
    podsecuritypolicy.policy/px-operator created created created
    deployment.apps/portworx-operator created
  2. Deploy the StorageCluster:

    kubectl apply -f '<version-number>?operator=true&mc=false&kbver=&b=true&kd=type%3Dgp2%2Csize%3D150&s=%22type%3Dgp2%2Csize%3D150%22&c=px-cluster-XXXX-XXXX&eks=true&stork=true&csi=true&mon=true&tel=false&st=k8s&e==AWS_ACCESS_KEY_ID%3XXXX%2CAWS_SECRET_ACCESS_KEY%3XXXX&promop=true' created
  3. Verify if the cloud drives for a given node are provisioned on arrays that are in the same zone:

pxctl sv pool show
PX drive configuration:
Pool ID: 0
Type: Default
UUID: 1841785e-649f-4be0-ac07-0d1797392d56
IO Priority: HIGH
Size: 250 GiB
Status: Online
Has metadata: No
Balanced: Yes

You will see that Labels flag is set for your volumes.

Was this page helpful?