Mailing-List: contact hdfs-dev-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Reply-To: hdfs-dev@hadoop.apache.org
Date: Wed, 25 Jul 2012 16:33:35 +0000 (UTC)
From: "E. Sammer (JIRA)" <jira@apache.org>
To: hdfs-dev@hadoop.apache.org
Message-ID: <1138733421.101775.1343234015342.JavaMail.jiratomcat@issues-vm>
Subject: [jira] [Created] (HDFS-3723) All commands should support meaningful
 --help
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

E. Sammer created HDFS-3723:
-------------------------------

             Summary: All commands should support meaningful --help
                 Key: HDFS-3723
                 URL: https://issues.apache.org/jira/browse/HDFS-3723
             Project: Hadoop HDFS
          Issue Type: Improvement
          Components: scripts, tools
    Affects Versions: 2.0.0-alpha
            Reporter: E. Sammer


Some (sub)commands support -help or -h options for detailed help while others do not. Ideally, all commands should support meaningful help that works regardless of current state or configuration.

For example, hdfs zkfc --help (or -h or -help) is not very useful. Option checking should occur before state / configuration checking.
{code}

[esammer@hadoop-fed01 ~]# hdfs zkfc --help
Exception in thread "main" org.apache.hadoop.HadoopIllegalArgumentException: HA is not enabled for this namenode.
        at org.apache.hadoop.hdfs.tools.DFSZKFailoverController.setConf(DFSZKFailoverController.java:122)
        at org.apache.hadoop.util.ToolRunner.run(ToolRunner.java:66)
        at org.apache.hadoop.util.ToolRunner.run(ToolRunner.java:84)
        at org.apache.hadoop.hdfs.tools.DFSZKFailoverController.main(DFSZKFailoverController.java:168)
{code}

This would go a long way toward better usability for ops staff.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira