Return-Path: X-Original-To: apmail-hadoop-common-commits-archive@www.apache.org Delivered-To: apmail-hadoop-common-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id EF9DC17C9A for ; Mon, 12 Jan 2015 20:17:16 +0000 (UTC) Received: (qmail 20068 invoked by uid 500); 12 Jan 2015 20:17:18 -0000 Delivered-To: apmail-hadoop-common-commits-archive@hadoop.apache.org Received: (qmail 19991 invoked by uid 500); 12 Jan 2015 20:17:18 -0000 Mailing-List: contact common-commits-help@hadoop.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: common-dev@hadoop.apache.org Delivered-To: mailing list common-commits@hadoop.apache.org Received: (qmail 19982 invoked by uid 99); 12 Jan 2015 20:17:18 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 Jan 2015 20:17:18 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id BCB97A0239A; Mon, 12 Jan 2015 20:17:17 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: cmccabe@apache.org To: common-commits@hadoop.apache.org Message-Id: <47918998463a4b01bad19dd7c1699c98@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: hadoop git commit: HDFS-7326. Add documentation for hdfs debug commands (Vijay Bhat via Colin P. McCabe) Date: Mon, 12 Jan 2015 20:17:17 +0000 (UTC) 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 Authored: Mon Jan 12 12:16:36 2015 -0800 Committer: Colin Patrick Mccabe 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 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: <<] [-block ]>>> + +*------------------------+----------------------------------------------------+ +|| COMMAND_OPTION | Description +*------------------------+----------------------------------------------------+ +| -meta | Absolute path for the metadata file on the local file +| | system of the data node. +*------------------------+----------------------------------------------------+ +| -block | Optional parameter to specify the absolute path for +| | the block file on the local file system of the data +| | node. +*------------------------+----------------------------------------------------+ + + + +** <<>> + + Recover the lease on the specified path. The path must reside on an + HDFS filesystem. The default number of retries is 1. + + Usage: <<] [-retries ]>>> + +*-------------------------------+--------------------------------------------+ +|| COMMAND_OPTION || Description +*-------------------------------+---------------------------------------------+ +| [-path ] | HDFS path for which to recover the lease. +*-------------------------------+---------------------------------------------+ +| [-retries ] | Number of times the client will retry calling +| | recoverLease. The default number of retries +| | is 1. +*-------------------------------+---------------------------------------------+