hashicorp/nomad · error

failed to find storage provider info for client %q, node plu

Error message

failed to find storage provider info for client %q, node plugin %q is not running or has not fingerprinted on this client

What it means

Fires in lookupExternalNodeID when the claiming node exists but its CSINodePlugins map has no info for this plugin — the node plugin never fingerprinted or is not running on that client, so its storage-provider node ID is unknown.

Source

Thrown at nomad/csi_endpoint.go:1013

		}
	}

	// fallback to looking up the node plugin
	ws := memdb.NewWatchSet()
	state := v.srv.fsm.State()
	targetNode, err := state.NodeByID(ws, claim.NodeID)
	if err != nil {
		return "", err
	}
	if targetNode == nil {
		return "", fmt.Errorf("%w %s", structs.ErrUnknownNode, claim.NodeID)
	}

	// get the storage provider's ID for the client node (not
	// Nomad's ID for the node)
	targetCSIInfo, ok := targetNode.CSINodePlugins[vol.PluginID]
	if !ok || targetCSIInfo.NodeInfo == nil {
		return "", fmt.Errorf("failed to find storage provider info for client %q, node plugin %q is not running or has not fingerprinted on this client", targetNode.ID, vol.PluginID)
	}
	return targetCSIInfo.NodeInfo.ID, nil
}

func (v *CSIVolume) checkpointClaim(vol *structs.CSIVolume, claim *structs.CSIVolumeClaim) error {
	v.logger.Trace("checkpointing claim")
	req := structs.CSIVolumeClaimRequest{
		VolumeID:     vol.ID,
		AllocationID: claim.AllocationID,
		NodeID:       claim.NodeID,
		Claim:        claim.Mode,
		State:        claim.State,
		WriteRequest: structs.WriteRequest{
			Namespace: vol.Namespace,
			Region:    v.srv.Region(),
			AuthToken: v.srv.getLeaderAcl(),
		},
	}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Ensure the CSI node plugin block is present in the client's client config and the plugin binary is installed
2. Check client fingerprint logs for the plugin
3. Restart the node plugin / client so CSINodePlugins info is populated, then retry

When it happens

Trigger: Thrown at nomad/csi_endpoint.go:1013 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/d00e3415195a1b2c. Report an issue: GitHub.