Repository: hadoop Updated Branches: refs/heads/HDFS-EC 82c57eff9 -> 9953e9214
HDFS-7326. Add documentation for hdfs debug commands (Vijay Bhat via Colin P. McCabe) Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/0fd8ea16 Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/0fd8ea16 Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/0fd8ea16 Branch: refs/heads/HDFS-EC Commit: 0fd8ea169dba10d564784edaf3e637549b756f24 Parents: 6ee81a7 Author: Colin Patrick Mccabe <[email protected]> Authored: Mon Jan 12 12:16:36 2015 -0800 Committer: Zhe Zhang <[email protected]> Committed: Tue Jan 13 07:33:16 2015 -0800 ---------------------------------------------------------------------- hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt | 3 ++ .../src/site/apt/HDFSCommands.apt.vm | 43 ++++++++++++++++++++ 2 files changed, 46 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hadoop/blob/0fd8ea16/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt ---------------------------------------------------------------------- diff --git a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt index 1a5a22b..f83ac65 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt +++ b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt @@ -490,6 +490,9 @@ Release 2.7.0 - UNRELEASED HDFS-7323. Move the get/setStoragePolicy commands out from dfsadmin. (jing9 via yliu) + HDFS-7326: Add documentation for hdfs debug commands (Vijay Bhat via Colin + P. McCabe) + OPTIMIZATIONS HDFS-7454. Reduce memory footprint for AclEntries in NameNode. http://git-wip-us.apache.org/repos/asf/hadoop/blob/0fd8ea16/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HDFSCommands.apt.vm ---------------------------------------------------------------------- diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HDFSCommands.apt.vm b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HDFSCommands.apt.vm index 281221d..4cf31ac 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HDFSCommands.apt.vm +++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/HDFSCommands.apt.vm @@ -464,3 +464,46 @@ HDFS Commands Guide | -geteditsize | Prints the number of uncheckpointed transactions on | the NameNode. *----------------------+------------------------------------------------------+ + +* Debug Commands + + Useful commands to help administrators debug HDFS issues, like validating + block files and calling recoverLease. + +** <<<verify>>> + + Verify HDFS metadata and block files. If a block file is specified, we + will verify that the checksums in the metadata file match the block + file. + + Usage: <<<hdfs dfs verify [-meta <metadata-file>] [-block <block-file>]>>> + +*------------------------+----------------------------------------------------+ +|| COMMAND_OPTION | Description +*------------------------+----------------------------------------------------+ +| -meta <metadata-file> | Absolute path for the metadata file on the local file +| | system of the data node. +*------------------------+----------------------------------------------------+ +| -block <block-file> | Optional parameter to specify the absolute path for +| | the block file on the local file system of the data +| | node. +*------------------------+----------------------------------------------------+ + + + +** <<<recoverLease>>> + + Recover the lease on the specified path. The path must reside on an + HDFS filesystem. The default number of retries is 1. + + Usage: <<<hdfs dfs recoverLease [-path <path>] [-retries <num-retries>]>>> + +*-------------------------------+--------------------------------------------+ +|| COMMAND_OPTION || Description +*-------------------------------+---------------------------------------------+ +| [-path <path>] | HDFS path for which to recover the lease. +*-------------------------------+---------------------------------------------+ +| [-retries <num-retries>] | Number of times the client will retry calling +| | recoverLease. The default number of retries +| | is 1. +*-------------------------------+---------------------------------------------+
