direct-csi-min-io
storage class. Why?discover
command, I do not find my storage drive(s). Why?no drive found ...
error message in my Persistent Volume Claim. Why?Pending
state. Why?volume XXXXX is not yet staged, but requested with YYYYY
error. Why?unable to find device by FSUUID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; either device is removed or run command `sudo udevadm control --reload-rules && sudo udevadm trigger` on the host to reload
error. Why?You need to have necessary privileges and permissions to perform installation. Go though the specifications documentation. For Red Hat OpenShift, refer to the OpenShift specific documentation.
direct-csi-min-io
storage class. Why?Legacy DirectCSI is deprecated including storage class direct-csi-min-io
and it is no longer supported. Previously created volumes continue to work normally. For new volume requests, use the directpv-min-io
storage class.
Installing DirectPV also tries to upgrade legacy DirectCSI. Upgrading DirectCSI older than v3.1.0 requires Conversion webhook service running. For appropriate upgrade process, refer this documentation
discover
command, I do not find my storage drive(s). Why?DirectPV ignores drives that meet any of the below conditions:
Check the last column of the discover --all
command output to see what condition(s) exclude the drive. Resolve the conditions and try again.
DirectPV is meant for high performance local volumes with Direct Attached Storage. We do not recommend any remote drives, as remote drives may lead to poor performance.
It works, but we strongly recommend to use raw devices for better performance.
Yes
Local Persistent Volumes are statically created PersistentVolume
which requires administrative skills. Whereas DirectPV dynamically provisions volumes on-demand; they are persistent through pod/node restarts. The lifecycle of DirectPV volumes are managd by associated Persistent Volume Claims (PVCs) which simplifies volume management.
no drive found ...
error message in my Persistent Volume Claim. Why?Below is the reason and solution | Reason | Solution | |:————————————————————-|:—————————————————| | Volume claim is made without adding any drive into DirectPV. | Please add drives. | | No drive has free space for requested size. | 1. Please add new drives. 2. Remove stale volumes. | | Requested topology is not met. | Please modify your Persistent Volume Claim. | | Requested drive is not found on the requested node. | Please modify Persistent Volume Claim. | | Requested node is not DirectPV node. | Please modify Persistent Volume Claim. |
DirectPV comes with WaitForFirstConsumer volume binding mode i.e. Pod consuming volume must be scheduled first.
Pending
state. Why?volume XXXXX is not yet staged, but requested with YYYYY
error. Why?According to CSI specification, Kubelet
should call StageVolume
RPC first, then PublishVolume
RPC next. In a rare event, StageVolume
RPC is not fired/called, but PublishVolume
RPC is called. Please restart your Kubelet and report this issue to your Kubernetes provider.
unable to find device by FSUUID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; either device is removed or run command `sudo udevadm control --reload-rules && sudo udevadm trigger` on the host to reload
error. Why?In a rare event, Udev
in your system missed updating /dev
directory. Please run command sudo udevadm control --reload-rules && sudo udevadm trigger
and report this issue to your OS vendor.