MAPREDUCE-5945. Update the description of GenericOptionsParser -jt option (Akira AJISAKA via aw)

This commit is contained in:
Allen Wittenauer 2014-09-26 14:25:49 -07:00
parent b40f433cf8
commit c7c8e388a9
4 changed files with 19 additions and 16 deletions

View File

@ -49,9 +49,9 @@
* <code>GenericOptionsParser</code> is a utility to parse command line
* arguments generic to the Hadoop framework.
*
* <code>GenericOptionsParser</code> recognizes several standarad command
* <code>GenericOptionsParser</code> recognizes several standard command
* line arguments, enabling applications to easily specify a namenode, a
* jobtracker, additional configuration resources etc.
* ResourceManager, additional configuration resources etc.
*
* <h4 id="GenericOptions">Generic Options</h4>
*
@ -60,7 +60,7 @@
* -conf &lt;configuration file&gt; specify a configuration file
* -D &lt;property=value&gt; use value for given property
* -fs &lt;local|namenode:port&gt; specify a namenode
* -jt &lt;local|jobtracker:port&gt; specify a job tracker
* -jt &lt;local|resourcemanager:port&gt; specify a ResourceManager
* -files &lt;comma separated list of files&gt; specify comma separated
* files to be copied to the map reduce cluster
* -libjars &lt;comma separated list of jars&gt; specify comma separated
@ -90,13 +90,13 @@
*
* $ bin/hadoop dfs -conf core-site.xml -conf hdfs-site.xml -ls /data
* list /data directory in dfs with multiple conf files specified.
*
* $ bin/hadoop job -D mapred.job.tracker=darwin:50020 -submit job.xml
* submit a job to job tracker darwin:50020
*
* $ bin/hadoop job -jt darwin:50020 -submit job.xml
* submit a job to job tracker darwin:50020
*
*
* $ bin/hadoop job -D yarn.resourcemanager.address=darwin:8032 -submit job.xml
* submit a job to ResourceManager darwin:8032
*
* $ bin/hadoop job -jt darwin:8032 -submit job.xml
* submit a job to ResourceManager darwin:8032
*
* $ bin/hadoop job -jt local -submit job.xml
* submit a job to local runner
*
@ -213,9 +213,9 @@ private static Options buildGeneralOptions(Options opts) {
.hasArg()
.withDescription("specify a namenode")
.create("fs");
Option jt = OptionBuilder.withArgName("local|jobtracker:port")
Option jt = OptionBuilder.withArgName("local|resourcemanager:port")
.hasArg()
.withDescription("specify a job tracker")
.withDescription("specify a ResourceManager")
.create("jt");
Option oconf = OptionBuilder.withArgName("configuration file")
.hasArg()
@ -408,7 +408,7 @@ private String validateFiles(String files, Configuration conf)
else {
// check if the file exists in this file system
// we need to recreate this filesystem object to copy
// these files to the file system jobtracker is running
// these files to the file system ResourceManager is running
// on.
FileSystem fs = path.getFileSystem(conf);
if (!fs.exists(path)) {
@ -502,7 +502,7 @@ public static void printGenericCommandUsage(PrintStream out) {
out.println("-conf <configuration file> specify an application configuration file");
out.println("-D <property=value> use value for given property");
out.println("-fs <local|namenode:port> specify a namenode");
out.println("-jt <local|jobtracker:port> specify a job tracker");
out.println("-jt <local|resourcemanager:port> specify a ResourceManager");
out.println("-files <comma separated list of files> " +
"specify comma separated files to be copied to the map reduce cluster");
out.println("-libjars <comma separated list of jars> " +

View File

@ -56,7 +56,7 @@ Generic Options
*------------------------------------------------+-----------------------------+
|<<<-D \<property\>=\<value\> >>> | Use value for given property.
*------------------------------------------------+-----------------------------+
|<<<-jt \<local\> or \<jobtracker:port\> >>> | Specify a job tracker.
|<<<-jt \<local\> or \<resourcemanager:port\>>>> | Specify a ResourceManager.
| Applies only to job.
*------------------------------------------------+-----------------------------+
|<<<-files \<comma separated list of files\> >>> | Specify comma separated files

View File

@ -387,6 +387,9 @@ Release 2.6.0 - UNRELEASED
MAPREDUCE-5796. Use current version of the archive name in
DistributedCacheDeploy document (Akira AJISAKA via aw)
MAPREDUCE-5945. Update the description of GenericOptionsParser -jt
option (Akira AJISAKA via aw)
Release 2.5.1 - 2014-09-05
INCOMPATIBLE CHANGES

View File

@ -308,7 +308,7 @@ public void testSubmitter() throws Exception {
assertTrue(out.toString().contains(
"-fs <local|namenode:port> specify a namenode"));
assertTrue(out.toString().contains(
"-jt <local|jobtracker:port> specify a job tracker"));
"-jt <local|ResourceManager:port> specify a ResourceManager"));
assertTrue(out
.toString()
.contains(