Repository: hadoop Updated Branches: refs/heads/branch-2 7c4e5ff66 -> e4bb94b0b
HDFS-7326. Add documentation for hdfs debug commands (Vijay Bhat via Colin P. McCabe) (cherry picked from commit b78b4a1536b6d47a37ff7c309857a628a864c957) Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/e4bb94b0 Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/e4bb94b0 Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/e4bb94b0 Branch: refs/heads/branch-2 Commit: e4bb94b0b8baaa1c593e2f50057979327fad6e69 Parents: 7c4e5ff 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:17:37 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/e4bb94b0/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 fdd0c01..d5c6313 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt +++ b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt @@ -233,6 +233,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/e4bb94b0/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 93e9ca2..17a0d62 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 @@ -461,3 +461,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. +*-------------------------------+---------------------------------------------+
