Installation

Operator Installation

1. On the OpenShift console, navigate to OperatorHub and use the keyword filter to search for Dell Container Storage Modules.

2. Click Dell Container Storage Modules tile

3. Keep all default settings and click Install.

Verify that the operator is deployed

oc get operators

NAME                                                          AGE
dell-csm-operator-certified.openshift-operators               2d21h

oc get pod -n openshift-operators

NAME                                                       READY   STATUS       RESTARTS      AGE
dell-csm-operator-controller-manager-86dcdc8c48-6dkxm      2/2     Running      21 (19h ago)  2d21h

CSI Driver Installation

1. Create project:

   
   

   Use this command to create new project. You can use any project name instead of powerstore.

   oc new-project powerstore
   

2. Create config secret:

   
   

   Create a file called config.yaml or use sample:

   Example:

   cat << EOF > config.yaml
   arrays:
   - endpoint: "https://11.0.0.1/api/rest"
       globalID: "unique"
       username: "user"
       password: "password"
       skipCertificateValidation: true
       blockProtocol: "FC"
   EOF
   

   Add blocks for each PowerStore array in config.yaml, and include both source and target arrays if replication is enabled.

   The username in config.yaml must be from PowerStore’s authentication providers and have at least the Storage Operator role.

   
   

   Edit the file, then run the command to create the powerstore-config.

   oc create secret generic powerstore-config --from-file=config=config.yaml -n powerstore --dry-run=client -oyaml > secret-config.yaml
   

   Use this command to create the config:

   oc apply -f secret-powerstore-config.yaml
   

   Use this command to replace or update the config:

   oc replace -f secret-powerstore-config.yaml --force
   

   Verify config secret is created.

   oc get secret -n powerstore
   
   NAME                 TYPE        DATA   AGE
   powerstore-config    Opaque      1      3h7m
   

3. Create Custom Resource ContainerStorageModule for powerstore.

   
   

   Use this command to create the ContainerStorageModule Custom Resource:

   oc create -f csm-store.yaml
   

   Example:

   cat << EOF > csm-powerstore.yaml
   apiVersion: storage.dell.com/v1
   kind: ContainerStorageModule
   metadata:
   name: powerstore
   namespace: powerstore
   spec:
   driver:
      csiDriverType: "powerstore"
      configVersion: v2.13.0
      forceRemoveDriver: true
   EOF 
   

   Detailed Configuration: Use the sample file for detailed settings.

   To set the parameters in CR. The table shows the main settings of the PowerStore driver and their defaults.

Parameters

Parameter	Description	Required	Default
replicas	Controls the number of controller pods you deploy. If the number of controller pods is greater than the number of available nodes, the excess pods will be in pending state until new nodes are available for scheduling. Default is 2 which allows for Controller high availability.	Yes	2
namespace	Specifies namespace where the driver will be installed	Yes	“powerstore”
fsGroupPolicy	Defines which FS Group policy mode to be used. Supported modes None, File and ReadWriteOnceWithFSType. In OCP <= 4.16 and K8s <= 1.29, fsGroupPolicy is an immutable field.	No	“ReadWriteOnceWithFSType”
storageCapacity	Enable/Disable storage capacity tracking feature	No	false
Common parameters for node and controller
X_CSI_POWERSTORE_NODE_NAME_PREFIX	Prefix to add to each node registered by the CSI driver	Yes	“csi-node”
X_CSI_FC_PORTS_FILTER_FILE_PATH	To set path to the file which provides a list of WWPN which should be used by the driver for FC connection on this node	No	“/etc/fc-ports-filter”
Controller parameters
X_CSI_POWERSTORE_EXTERNAL_ACCESS	allows specifying additional entries for hostAccess of NFS volumes. Both single IP address and subnet are valid entries	No	empty
X_CSI_NFS_ACLS	Defines permissions - POSIX mode bits or NFSv4 ACLs, to be set on NFS target mount directory.	No	“0777”
Node parameters
X_CSI_POWERSTORE_ENABLE_CHAP	Set to true if you want to enable iSCSI CHAP feature	No	false

Check if ContainerStorageModule CR is created successfully:

oc get csm powerstore -n powerstore

NAME        CREATIONTIME   CSIDRIVERTYPE   CONFIGVERSION   STATE
powerstore   3h            powerstore      v2.13.0         Succeeded      

Check the status of the CR to verify if the driver installation is in the Succeeded state. If the status is not Succeeded, see the Troubleshooting guide for more information.

4. Create Storage class:

   
   

   Use this command to create the Storage Class:

   oc apply -f sc-powerstore.yaml
   

   Example:

   cat << EOF > sc-powerstore.yaml
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
   name: "powerstore-ext4"
   provisioner: "csi-powerstore.dellemc.com"
   parameters:
   csi.storage.k8s.io/fstype: "ext4"
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   volumeBindingMode: Immediate
   EOF
   

   Replace placeholders with actual values for your powerstore array and various storage class sample refer here

   
   

   Verify Storage Class is created:

   oc get storageclass powerstore
   
   NAME                    PROVISIONER                    RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
   powerstore(default)     csi-powerstore.dellemc.com     Delete          Immediate           true                   3h8m
   

   
   

5. Create Volume Snapshot Class:

   
   

   Use this command to create the Volume Snapshot:

   oc appky -f vsclass-powerstore.yaml
   

   Example:

   cat << EOF > vsclass-powerstore.yaml
   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
   name: powerstore-snapshot
   driver: "csi-powerstore.dellemc.com" 
   deletionPolicy: Delete
   EOF 
   

   Verify Volume Snapshot Class is created:

   oc get volumesnapshotclass
   
   NAME                      DRIVER                              DELETIONPOLICY   AGE
   powerstore-snapclass      csi-powerstore.dellemc.com          Delete           3h9m
   

   
   

Configurations