Repository: hadoop Updated Branches: refs/heads/trunk f45163191 -> b78b4a153
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/b78b4a15 Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/b78b4a15 Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/b78b4a15 Branch: refs/heads/trunk Commit: b78b4a1536b6d47a37ff7c309857a628a864c957 Parents: f451631 Author: Colin Patrick Mccabe <[email protected]> Authored: Mon Jan 12 12:16:36 2015 -0800 Committer: Colin Patrick Mccabe <[email protected]> Committed: Mon Jan 12 12:16:36 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/b78b4a15/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/b78b4a15/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. +*-------------------------------+---------------------------------------------+
