Chapter 11. Managing persistent volume claims

Procedure

1. Create a Persistent Volume Claim (PVC) for the application to use.

   1. In OpenShift Web Console, click Storage Persistent Volume Claims.
   2. Set the Project for the application pod.

   3. Click Create Persistent Volume Claim.

      1. Specify a Storage Class provided by OpenShift Data Foundation.
      2. Specify the PVC Name, for example, myclaim.

      3. Select the required Access Mode.

         Note

         The Access Mode, Shared access (RWX) is not supported in IBM FlashSystem.

      4. For Rados Block Device (RBD), if the Access mode is ReadWriteOnce (RWO), select the required Volume mode. The default volume mode is Filesystem.
      5. Specify a Size as per application requirement.
      6. Click Create and wait until the PVC is in Bound status.

2. Configure a new or existing application pod to use the new PVC.

   • For a new application pod, perform the following steps:

     1. Click Workloads →Pods.
     2. Create a new application pod.

     3. Under the spec: section, add volumes: section to add the new PVC as a volume for the application pod.

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        For example:

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

   • For an existing application pod, perform the following steps:

     1. Click Workloads →Deployment Configs.
     2. Search for the required deployment config associated with the application pod.
     3. Click on its Action menu (⋮) Edit Deployment Config.

     4. Under the spec: section, add volumes: section to add the new PVC as a volume for the application pod and click Save.

        volumes:
          - name: <volume_name>
            persistentVolumeClaim:
              claimName: <pvc_name>

        For example:

        volumes:
          - name: mypd
            persistentVolumeClaim:
              claimName: myclaim

3. Verify that the new configuration is being used.

   1. Click Workloads Pods.
   2. Set the Project for the application pod.
   3. Verify that the application pod appears with a status of Running.
   4. Click the application pod name to view pod details.
   5. Scroll down to Volumes section and verify that the volume has a Type that matches your new Persistent Volume Claim, for example, myclaim.

Procedure

1. Log in to OpenShift Web Console.
2. Click Storage Persistent Volume Claims
3. Search for the required PVC name by using the Filter textbox. You can also filter the list of PVCs by Name or Label to narrow down the list
4. Check the Status column corresponding to the required PVC.
5. Click the required Name to view the PVC details.

Procedure

1. In the OpenShift Web Console, click Storage OpenShift Data Foundation.
2. In the Storage systems tab, select the storage system and then click Overview Block and File.
3. Locate the Inventory card to see the number of PVCs with errors.
4. Click Storage Persistent Volume Claims
5. Search for the required PVC using the Filter textbox.
6. Click on the PVC name and navigate to Events
7. Address the events as required or as directed.