Merge pull request #56465 from amolnar-rh/OCPBUGS-5981

OCPBUGS-5981: Add to LVM Storage docs how to expand a PVC

Author: jeana-redhat

modules/lvms-scaling-storage-expand-pvc.adoc

@@ -0,0 +1,25 @@
+// Module included in the following assemblies:
+//
+// storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc
+
+:_content-type: PROCEDURE
+[id="lvms-scaling-expand-pvc_{context}"]
+= Expanding PVCs
+
+To leverage the new storage after adding additional capacity, you can expand existing persistent volume claims (PVCs) with LVM Storage.
+
+.Prerequisites
+
+* Dynamic provisioning is used.
+* The controlling `StorageClass` object has `allowVolumeExpansion` set to `true`.
+
+.Procedure
+
+. Modify the `.spec.resources.requests.storage` field in the desired PVC resource to the new size by running the following command:
++
+[source,terminal]
+----
+oc patch <pvc_name> -n <application_namespace> -p '{ "spec": { "resources": { "requests": { "storage": "<desired_size>" }}}}'
+----
+
+. Watch the `status.conditions` field of the PVC to see if the resize has completed. {product-title} adds the `Resizing` condition to the PVC during expansion, which is removed after the expansion completes.

storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc

@@ -85,6 +85,17 @@ include::modules/lvms-scaling-storage-of-single-node-openshift-cluster-using-rha
 
 * xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file]
 
+include::modules/lvms-scaling-storage-expand-pvc.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.html#lvms-scaling-storage-of-single-node-openshift-cluster_logical-volume-manager-storage[Scaling up storage by adding capacity to your {sno} cluster]
+
+* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.html#lvms-scaling-storage-of-single-node-openshift-cluster-using-rhacm_logical-volume-manager-storage[Scaling up storage by adding capacity to your single-node OpenShift cluster using RHACM]
+
+* xref:../../../storage/expanding-persistent-volumes.adoc#add-volume-expansion_expanding-persistent-volumes[Enabling volume expansion support]
+
 //Upgrading
 include::modules/lvms-upgrading-lvms-on-sno.adoc[leveloffset=+1]