Uploaded image for project: 'Hadoop HDFS'
  1. Hadoop HDFS
  2. HDFS-3723

All commands should support meaningful --help

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 2.0.0-alpha
    • 2.0.2-alpha
    • scripts, tools
    • None

    Description

      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.

      [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)
      

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

      Attachments

        1. HDFS-3723.patch
          22 kB
          Jing Zhao
        2. HDFS-3723.patch
          24 kB
          Jing Zhao
        3. HDFS-3723.001.patch
          34 kB
          Jing Zhao
        4. HDFS-3723.001.patch
          35 kB
          Jing Zhao
        5. HDFS-3723.002.patch
          39 kB
          Jing Zhao
        6. HDFS-3723.003.patch
          41 kB
          Jing Zhao
        7. HDFS-3723.patch
          35 kB
          Suresh Srinivas

        Issue Links

          Activity

            People

              jingzhao Jing Zhao
              esammer Eric Sammer
              Votes:
              0 Vote for this issue
              Watchers:
              10 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: