Node preparation

Mon, 01 Jan 0001 00:00:00 +0000

Install the Lustre client stack

Every node that runs Lustre-backed pods must have:

Verify installation:

mount.lustre --version
lsmod | grep lustre

The default storage class and daemonset use the label lustre.csi.klustrefs.io/lustre-client=true.

kubectl label nodes <node-name> lustre.csi.klustrefs.io/lustre-client=true

Remove the label when a node no longer has Lustre access:

Mon, 01 Jan 0001 00:00:00 +0000

DaemonSet/klustre-csi-node mounts the following host paths:

/var/lib/kubelet/plugins and /var/lib/kubelet/pods – required for CSI socket registration and mount propagation.
/dev – ensures device files (if any) are accessible when mounting Lustre.
/sbin, /usr/sbin, /lib, /lib64 – expose the host’s Lustre client binaries and libraries to the container.

If your kubelet uses custom directories, update pluginDir and registrationDir in the settings ConfigMap.

The node plugin listens on csiEndpoint (defaults to /var/lib/kubelet/plugins/lustre.csi.klustrefs.io/csi.sock).
The node-driver-registrar sidecar registers that socket with kubelet via registrationDir.
Kubelet uses the UNIX socket to call NodePublishVolume and NodeUnpublishVolume when pods mount or unmount PVCs.

If the daemonset does not come up or kubelet cannot reach the socket, run: