OpenShift iSCSI on Everpure FlashArray - Quick Start Guide

cat /etc/iscsi/initiatorname.iscsi

InitiatorName=iqn.1994-05.com.redhat:2357875188ed

1. Discover iSCSI targets

   iscsiadm -m discovery -t sendtargets -p <flasharray-iscsi-ip>

   Example output:

   10.x.x.x:3260,2137 iqn.2010-06.com.purestorage:flasharray.64724aac22257212
   10.x.x.x:3260,2137 iqn.2010-06.com.purestorage:flasharray.64724aac22257212

2. Log in to discovered targets:

   iscsiadm -m node --loginall=automatic

   This logs the initiator in to all discovered targets. After login, SCSI block devices will appear on the worker node corresponding to each mapped volume path.

3. Verify multipath devices:

   multipath -ll

   Example output:

   mpatha (3624a93708eabcb40cc4241b209e0d22b) dm-0 PURE,FlashArray
   size=500G features='0' hwhandler='1 alua' wp=rw
   `-+- policy='service-time 0' prio=50 status=active
     |- 33:0:0:254 sdb 8:16 active ready running
     |- 34:0:0:254 sdc 8:32 active ready running

oc create namespace portworx


# Verify
oc get namespace portworx

NAME       STATUS   AGE
portworx   Active   <duration>

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: portworx-operator
  namespace: openshift-operators
spec:
  channel: stable
  name: portworx-certified
  source: certified-operators
  sourceNamespace: openshift-marketplace
  installPlanApproval: Automatic

oc apply -f portworx-operator-subscription.yaml

# List Portworx operator pods in the cluster-wide operator namespace
oc get pods -n openshift-operators | grep portworx

portworx-operator-xxxxxxxxxx-xxxxx   1/1   Running   0   <duration>

oc logs -n openshift-operators deploy/portworx-operator

oc get crd | grep storagecluster

purestorageclusters.core.libopenstorage.org   	   2026-03-22T12:58:39Z
storageclusters.core.libopenstorage.org           2026-03-22T12:58:18Z

1. Navigate to Settings > Access > Users, create a user (e.g. px-portworx) and assign the Storage Admin role:

   

2. Copy and store the API token:

   

• FlashArray management endpoint(s) (IP/FQDN)

• The API token for the Portworx user

{
  "FlashArrays": [
    {
      "MgmtEndPoint": "https://<flasharray-mgmt-ip-or-fqdn>",
      "APIToken": "<FLASHARRAY-API-TOKEN>"
    }
  ]
}

oc create secret generic px-pure-secret -n portworx --from-file=pure.json=./pure.json

oc apply -f portworx-csi.yaml

oc get storagecluster -n portworx

oc get pods -n portworx

• Check Operator logs:

  oc logs -n openshift-operators deploy/portworx-operator

• Check an individual Portworx pod's logs:

  oc logs -n portworx <portworx-pod-name>

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: px-pure-iscsi-sc
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
provisioner: pxd.portworx.com
parameters:
  backend: pure_block
allowVolumeExpansion: true

oc get storageclass

1. Create a small test namespace:

   oc create namespace px-test

2. Create a PVC using the Portworx + FlashArray StorageClass:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: px-test-pvc
     namespace: px-test
   spec:
     accessModes:
       - ReadWriteOnce
     storageClassName: px-pure-iscsi-sc
     resources:
       requests:
         storage: 5Gi

   oc apply -f px-test-pvc.yaml
   oc get pvc px-test-pvc -n px-test -w

   Validation:

   C:\oc>oc apply -f px-test-pvc.yaml
   persistentvolumeclaim/px-test-pvc created
   
   C:\oc>oc get pvc px-test-pvc -n px-test -w
   
   NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS       VOLUMEATTRIBUTESCLASS   AGE
   px-test-pvc   Bound    pvc-08a9597a-d1db-49a5-930a-670ac895cc95   5Gi  RWO px-pure-iscsi-sc   <unset>  27m

3. Create a simple pod that mounts it and runs I/O:

   apiVersion: v1
   kind: Pod
   metadata:
     name: px-test-pod
     namespace: px-test
   spec:
     containers:
       - name: app
         image: registry.access.redhat.com/ubi9/ubi-minimal
         command: ["sleep", "3600"]
         volumeMounts:
           - name: data
             mountPath: /data
     volumes:
       - name: data
         persistentVolumeClaim:
           claimName: px-test-pvc
   
   
   
   oc apply -f px-test-pod.yaml 
   oc get pod px-test-pod -n px-test

   Validation:

   C:\oc>oc get pod px-test-pod -n px-test
   NAME          READY   STATUS    RESTARTS   AGE
   px-test-pod   1/1     Running   0          14m
   
   C:\oc>oc exec -it px-test-pod -n px-test -- /bin/sh
   sh-5.1# df -h /data
   Filesystem Size  Used Avail Use% Mounted on
   /dev/mapper/3624a93708eabcb40cc4241b20a3ed51a  4.9G  129M  4.7G   3% /data
   
   sh-5.1# ls -ld /data
   drwxr-xr-x. 3 root root 4096 Mar 31 13:55 /data