Skip to content

HDDS-15030. Add troubleshooting guide for Datanode storage exhaustion - #550

Open
dino2895 wants to merge 1 commit into
apache:masterfrom
dino2895:HDDS-15030-datanode-out-of-space
Open

dino2895 wants to merge 1 commit into
apache:masterfrom
dino2895:HDDS-15030-datanode-out-of-space

Conversation

@dino2895

@dino2895 dino2895 commented Sep 6, 2026

Copy link
Copy Markdown

What changes were proposed in this pull request?

Add a troubleshooting guide for Datanodes running out of storage space.

The guide explains how to:

  • Identify storage pressure through the SCM and Datanode web UIs.
  • Distinguish data-volume and Ratis-volume space issues.
  • Restore capacity by adding Datanodes or disks.
  • Use Disk Balancer or Container Balancer after expanding capacity.
  • Verify that writes and storage allocation have recovered.

The guide also clarifies that
ozone.scm.datanode.ratis.volume.free-space.min is an allocation
threshold and does not reserve disk space.

Jira: https://issues.apache.org/jira/browse/HDDS-15030

How was this patch tested?

  • pnpm run lint
  • pnpm run build

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant