Deleted File Handle Port Starvation

critical

configurationUpdated Jan 19, 2024

Files deleted but still held by processes (visible in lsof as 'deleted') can prevent MinIO from binding to required ports (9000/9001), causing service start failures or login errors despite no active service.

Sources

Debugging MinIO Installsblog.min.io

Technologies:

MinIOThe root cause of this issue originates in MinIO

minio.api.errors.5xx.total

minio.api.errors.401.total

minio.process.count

How to detect:

Detect MinIO service start failures with port binding errors, or 401/500 errors in MinIO Console with multiple minio processes running (ps aux | grep minio shows duplicates). Confirm with 'lsof -n | grep deleted' showing MinIO-related files.

Recommended action:

Kill stale MinIO processes (kill -9 <PID> for older PIDs). Run 'lsof -n | grep deleted' to find lingering file handles. Restart the node if file handles persist after killing processes. Implement process monitoring to detect duplicate MinIO processes and alert.