[HDFS-14382] The hdfs fsck command docs do not explain the meaning of the reported fields

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 3.2.0
• Component/s: documentation
• Assignee: Unassigned
• Reporter: Daniel Templeton
• Created: 19/Mar/19 15:58
• Updated: 19/Mar/19 15:58

Description

The hdfs fsck command shows something like:

FSCK started by root (auth:SIMPLE) from /172.17.0.2 for path /tmp at Tue Mar 19 15:50:24 UTC 2019
.Status: HEALTHY
 Total size:	179159051 B
 Total dirs:	11
 Total files:	1
 Total symlinks:		0
 Total blocks (validated):	2 (avg. block size 89579525 B)
 Minimally replicated blocks:	2 (100.0 %)
 Over-replicated blocks:	0 (0.0 %)
 Under-replicated blocks:	0 (0.0 %)
 Mis-replicated blocks:		0 (0.0 %)
 Default replication factor:	1
 Average block replication:	1.0
 Corrupt blocks:		0
 Missing replicas:		0 (0.0 %)
 Number of data-nodes:		1
 Number of racks:		1
FSCK ended at Tue Mar 19 15:50:24 UTC 2019 in 3 milliseconds


The filesystem under path '/tmp' is HEALTHY

The fields are presumed to be self-explanatory, but I think that's a bold assumption. In particular, it's not obvious how "mis-replicated" blocks differ from "under-replicated" or "over-replicated" blocks. It would be nice to explain the meaning of all the fields clearly in the docs.