Merge pull request #111893 from shdeshpa07/OADP-7880

Add troubleshooting doc for pvc delay binding

Author: shdeshpa07

backup_and_restore/application_backup_and_restore/troubleshooting/backup-and-restore-cr-issues.adoc

@@ -19,4 +19,6 @@ include::modules/troubleshooting-backup-cr-cannot-retrieve-volume-issue.adoc[lev
 
 include::modules/troubleshooting-backup-cr-status-remains-in-progress-issue.adoc[leveloffset=+1]
 
-include::modules/troubleshooting-backup-cr-status-remains-in-partiallyfailed-issue.adoc[leveloffset=+1]
+include::modules/troubleshooting-backup-cr-status-remains-in-partiallyfailed-issue.adoc[leveloffset=+1]
+
+include::modules/oadp-troubleshooting-pvc-binding-delay.adoc[leveloffset=+1]

modules/oadp-troubleshooting-pvc-binding-delay.adoc

@@ -0,0 +1,35 @@
+// Module included in the following assemblies:
+//
+// * backup_and_restore/application_backup_and_restore/troubleshooting/backup-and-restore-cr-issues.adoc
+
+:_mod-docs-content-type: PROCEDURE
+
+[id="oadp-troubleshooting-pvc-binding-delay_{context}"]
+= Troubleshooting PVC binding failures with the waitForFirstConsumer storage class
+
+[role="_abstract"]
+To ensure that restored persistent volume claims (PVCs) successfully bind to PVs when node affinity is configured, adjust the storage class binding mode settings during restore operations.
+
+PVCs that use a storage class with `bindingMode: WaitForFirstConsumer` might fail to bind to a PV when node affinity is configured. This issue can occur during restore operations, including virtual machine file restore (VMFR) workflows.
+
+.Procedure
+
+* Set the `ignoreDelayBinding` field to `true` in the `restorePVC` section of the `nodeAgent` configuration in the `DataProtectionApplication` CR, as shown in the following example:
++
+[source,yaml,subs="+quotes"]
+----
+apiVersion: oadp.openshift.io/v1alpha1
+kind: DataProtectionApplication
+metadata:
+  name: dpa-test
+  namespace: openshift-adp
+spec:
+# ...
+  configuration:
+    nodeAgent:
+      enable: true
+      restorePVC:
+        ignoreDelayBinding: true
+      uploaderType: kopia
+----
+