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 isilon.

   oc new-project isilon
   

2. Create config secret:

   
   

   Create a file called config.yaml or use sample:

   Example:

   cat << EOF > config.yaml
   isilonClusters:
    - clusterName: "cluster2"
       username: "user"
       password: "password"
       endpoint: "1.2.3.4"
       endpointPort: "8080"
   EOF
   

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

   
   

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

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

   Use this command to create the config:

   oc apply -f secret-isilon-config.yaml
   

   Use this command to replace or update the config:

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

   Verify config secret is created.

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

3. Create isilon-certs-n secret.

   
   

   If certificate validation is skipped, empty secret must be created. To create an empty secret. Ex: empty-secret.yaml

   cat << EOF > empty-secret.yaml
   apiVersion: v1
   kind: Secret
   metadata:
      name: isilon-certs-0
      namespace: isilon
   type: Opaque
   data:
      cert-0: "" 
   EOF
   

    oc create -f empty-secret.yaml
   

4. Create Custom Resource ContainerStorageModule for PowerScale.

   
   

   Use this command to create the ContainerStorageModule Custom Resource:

   oc create -f csm-isilon.yaml
   

   Example:

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

   Detailed Configuration: Use the sample file for detailed settings.

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

Parameters

Parameter	Description	Required	Default
namespace	Specifies namespace where the driver will be installed	Yes	“isilon”
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
dnsPolicy	Determines the DNS Policy of the Node service	Yes	ClusterFirstWithHostNet
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
CSI_ENDPOINT	The UNIX socket address for handling gRPC calls	No	/var/run/csi/csi.sock
X_CSI_ISI_SKIP_CERTIFICATE_VALIDATION	Specifies whether SSL security needs to be enabled for communication between PowerScale and CSI Driver	No	true
X_CSI_ISI_PATH	Base path for the volumes to be created	Yes
X_CSI_ALLOWED_NETWORKS	Custom networks for PowerScale export. List of networks that can be used for NFS I/O traffic, CIDR format should be used	No	empty
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. If CSM Authorization is enabled, this value must be set to 1.	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
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
Sidecar parameters
volume-name-prefix	The volume-name-prefix will be used by provisioner sidecar as a prefix for all the volumes created	Yes	k8s
monitor-interval	The monitor-interval will be used by external-health-monitor as an interval for health checks	Yes	60s

Check if ContainerStorageModule CR is created successfully:

oc get csm isilon -n isilon

NAME        CREATIONTIME   CSIDRIVERTYPE   CONFIGVERSION   STATE
isilon      3h             isilon      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-isilon.yaml
   

   Example:

   cat << EOF > sc-isilon.yaml
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
      name: isilon
   provisioner: csi-isilon.dellemc.com
   reclaimPolicy: Delete
   allowVolumeExpansion: true
   parameters:  
      AccessZone: System  
      IsiPath: /ifs/data/csi  
      RootClientEnabled: "false" 
   volumeBindingMode: Immediate
   EOF
   

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

   
   

   Verify Storage Class is created:

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

   
   

5. Create Volume Snapshot Class:

   
   

   Use this command to create the Volume Snapshot:

   oc apply -f vsclass-isilon.yaml
   

   Example:

   cat << EOF > vsclass-isilon.yaml
   apiVersion: snapshot.storage.k8s.io/v1
   kind: VolumeSnapshotClass
   metadata:
      name: isilon-snapclass
   driver: csi-isilon.dellemc.com
   deletionPolicy: Delete
   parameters:
      IsiPath: /ifs/data/csi
   EOF 
   

   Verify Volume Snapshot Class is created:

   oc get volumesnapshot
   
   NAME                      DRIVER                              DELETIONPOLICY   AGE
   isilon-snapclass          csi-isilon.dellemc.com              Delete           3h9m
   

   
   

Configurations