Before You Begin CSI Configuration

Before configuring the Container Storage Interface (CSI) Storage Plugin, be sure to review the following notes about supported and unsupported features and parameters. For an overview of the Container Storage Interface (CSI) Storage Plugin, see Container Storage Interface (CSI) Storage Plugin Overview.

Data Fabric Parameters for Static and Dynamic Provisioning

In dynamic provisioning, you can specify parameters for the Data Fabric volume to be created. For a list of the parameters that you can use, see volume create. Note these considerations for using the parameters:
  • Volume attributes must be represented as a string (enclosed within quotations). Using an integer or boolean is not supported. In the following example, the aetype attribute generates an error because the value (1) is not enclosed in quotations.
    namePrefix: "pv"
mountPrefix: "/pv"
type: "rw"
advisoryquota: "100M"
aetype: 1
  • The following parameters are ignored because they are redundant. The CSI Driver configures these parameters automatically during volume creation:
    • mount
    • quota*
    • createparent
    • path
    • name

*Specifying resources: requests: storage in a PersistentVolumeClaim (PVC) makes it unnecessary to set the quota parameter. For an example, see Example: Statically Provisioning a Volume Using the Container Storage Interface (CSI) Storage Plugin.

Kubernetes Access Modes

Kubernetes access modes control how a PersistentVolume (PV) is mounted on the host. Access modes can be specified on both PVs and PVCs. Only Volumes with a matching Access Mode will be bound to a PVC. The Container Storage Interface (CSI) Storage Plugin supports the following access modes for the PV and PVC spec:
  • ROX (ReadOnlyMany)
  • RWO (ReadWriteOnce)
  • RWX (ReadWriteMany)
  • RWOP (ReadWriteOncePod)*
*Supported for the latest CSI drivers (FUSE 1.2.11 and Loopback NFS 1.0.11 or later) on Kubernetes 1.29.

For more information, see the Kubernetes CSI documentation.

Reclaim Policy

The Kubernetes reclaimPolicy parameter controls what happens to a PersistentVolume if the corresponding PersistentVolumeClaim is deleted. The Recycle Reclaim Policy is not supported by Kubernetes CSI Drivers, so it cannot be used with the Kubernetes Interfaces for Data Fabric. You can specify the reclaim policy normally when you configure a persistent volume.

The following table shows the supported values for the reclaim policy:
Reclaim Policy Value Description Support
Delete (default value) The PersistentVolume and the Data Fabric volume are deleted when the user deletes the corresponding PersistentVolumeClaim. Supported
Retain The PersistentVolume and the Data Fabric volume are not deleted when the user deletes the corresponding PersistentVolumeClaim. Supported

For more information about the reclaim policy, see Change the Reclaim Policy of a PersistentVolume.

Kubernetes Mount Options

The Kubernetes mountOptions parameter is not supported for use with the Container Storage Interface (CSI) Storage Plugin.