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

["Daniel Templeton (JIRA)" <ji...@apache.org>]

Daniel Templeton created HDFS-14382:
---------------------------------------

             Summary: The hdfs fsck command docs do not explain the meaning of the reported fields
                 Key: HDFS-14382
                 URL: https://issues.apache.org/jira/browse/HDFS-14382
             Project: Hadoop HDFS
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 3.2.0
            Reporter: Daniel Templeton


The {{hdfs fsck}} command shows something like:

{noformat}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{noformat}

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.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: hdfs-dev-unsubscribe@hadoop.apache.org
For additional commands, e-mail: hdfs-dev-help@hadoop.apache.org