Troubleshooting OpenEBS - Dynamic LocalPV
General guidelines for troubleshooting
- Contact OpenEBS Community for support.
- Search for similar issues added in this troubleshootiung section.
- Search for any reported issues on StackOverflow under OpenEBS tag
Application pod using LocalPV device not coming into running state
Stale BDC in pending state after PVC is deleted
Created a PVC using localpv-device / localpv-hostpath storage class. But the PV is not created and PVC in Pending state. PVC in Pending state
Troubleshooting:
The default localpv storage classes from openebs have volumeBindingMode: WaitForFirstConsumer
. This means that only when the application pod that uses the PVC is scheduled to a node, the provisioner will receive the volume provision request and will create the volume.
Resolution: Deploy an application that uses the PVC and the PV will be created and application will start using the PV
Application pod that uses localpv device is stuck in Application pod using LocalPV not coming into running state
Pending
state with error
Warning FailedScheduling 7m24s (x2 over 7m24s) default-scheduler persistentvolumeclaim "<pvc-name>" not found
Troubleshooting: Check if there is a blockdevice present on the node (to which the application pod was scheduled,) which mathces the capacity requirements of the PVC.
kubectl get bd -n openebs -o wide
If matching blockdevices are not present, then the PVC will never get Bound.
Resolution: Schedule the application pod to a node which has a matching blockdevice available on it.
Stale BDC in pending state after PVC is deleted
kubectl get bdc -n openebs
shows stale Pending
BDCs created by localpv provisioner, even after the corresponding PVC has been deleted.
Resolution: LocalPV provisioner currently does not delete BDCs in Pending state if the corresponding PVCs are deleted. To remove the stale BDC entries,
- Edit the BDC and remove the
- local.openebs.io/finalizer
finalizer
kubectl edit bdc <bdc-name> -n openebs
- Delete the BDC
kubectl delete bdc <bdc-name> -n openebs
See Also:
FAQs
Seek support or help
Latest release notes
Feedback
Was this page helpful?
Thanks for the feedback. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement. Engage and get additional help on https://kubernetes.slack.com/messages/openebs/.