hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Thomas Graves (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-9514) Hadoop CLI's have inconsistent usages
Date Fri, 26 Apr 2013 13:56:15 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-9514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13642856#comment-13642856
] 

Thomas Graves commented on HADOOP-9514:
---------------------------------------

It would be nice if we could make the usage across the commands consistent.  Its nice to have
a GenericOptionsParser but we either need to pull out the things that aren't truly generic
across the commands or better yet have a way for different commands to specify which apply
and perhaps add to it so that the usage comes out nicely to differentiate subcommands from
generic options.    We also need to remove the general usage of "bin/hadoop command [genericOptions]
[commandOptions]"

Note that this came about from discussion on YARN-126.

Note that even within subcommands of particular CLI's are inconsistent. For example with yarn:
$ yarn rmadmin
Usage: java RMAdmin
           [-refreshQueues]
           [-refreshNodes]
           [-refreshUserToGroupsMappings]
           [-refreshSuperUserGroupsConfiguration]
           [-refreshAdminAcls]
           [-refreshServiceAcl]
           [-getGroups [username]]
           [-help [cmd]]

$yarn application
usage: application
 -kill <arg>     Kills the application.
 -list           Lists all the Applications from RM.
 -status <arg>   Prints the status of the application.


Another examples is hdfs dfsadmin and then look at hdfs fsck (which happens to be printing
generic usage options twice on trunk/branch-2)

                
> Hadoop CLI's have inconsistent usages
> -------------------------------------
>
>                 Key: HADOOP-9514
>                 URL: https://issues.apache.org/jira/browse/HADOOP-9514
>             Project: Hadoop Common
>          Issue Type: Bug
>          Components: scripts
>    Affects Versions: 3.0.0, 2.0.4-alpha
>            Reporter: Thomas Graves
>              Labels: usability
>
> Many of the hadoop command line interfaces (yarn/mapred/hdfs/hadoop) and subcommands
have inconsistent usages, in many cases have options that don't apply (-archives/-files/-jt),
and due to the usage of GenericOptionsParser print the usage as "bin/hadoop command [genericOptions]
[commandOptions]" even though you were running yarn or hdfs commands.
> This makes for a bad user experience and its confusing as to what options are really
available and how to use them.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message