svn commit: r1464676 - in /oozie/trunk: docs/src/site/twiki/DG_CommandLineTool.twiki release-log.txt

[ha...@apache.org]

Author: harsh
Date: Thu Apr  4 18:52:09 2013
New Revision: 1464676

URL: http://svn.apache.org/r1464676
Log:
OOZIE-1288 Improve docs around -D arguments support in the Oozie CLI's pig subcommand (harsh)

Modified:
    oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki
    oozie/trunk/release-log.txt

Modified: oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki
URL: http://svn.apache.org/viewvc/oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki?rev=1464676&r1=1464675&r2=1464676&view=diff
==============================================================================
--- oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki (original)
+++ oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki Thu Apr  4 18:52:09 2013
@@ -844,10 +844,16 @@ name. Multiple values must be specified 
 
 ---+++ Submitting a pig job through HTTP
 
+Syntax:
+
+<verbatim>
+$ oozie pig -file PIG-SCRIPT -config OOZIE-CONFIG [-X [-Dkey=value opts for Launcher/Job configuration] [Other opts to pass to Pig]]
+</verbatim>
+
 Example:
 
 <verbatim>
-$ oozie pig -oozie http://localhost:11000/oozie -file pigScriptFile -config job.properties -X -param_file params
+$ oozie pig -oozie http://localhost:11000/oozie -file pigScriptFile -config job.properties -X -Dmapred.job.queue.name=UserQueue -param_file params
 .
 job: 14-20090525161321-oozie-joe-W
 .
@@ -859,7 +865,7 @@ oozie.libpath=hdfs://localhost:8020/user
 </verbatim>
 
 The parameters for the job must be provided in a Java Properties file (.properties). jobtracker, namenode, libpath must be
-specified in this file. pigScriptFile is a local file. All jar files (including pig jar file) and all other files needed by the pig job (e.g., parameter file in above example) need to be uploaded onto HDFS under libpath beforehand. The workflow.xml will be created in Oozie server internally. Users can get the workflow.xml from console or command line(-definition). Everything after -X will be pass through parameters to pig.
+specified in this file. pigScriptFile is a local file. All jar files (including pig jar file) and all other files needed by the pig job (e.g., parameter file in above example) need to be uploaded onto HDFS under libpath beforehand. The workflow.xml will be created in Oozie server internally. Users can get the workflow.xml from console or command line(-definition). Everything after -X (optional) will be considered as configurable parameters for the generated workflow. The -D options passed after the -X will be defined into the generated workflow's <code><configuration> elements</code> (and make it to the Pig's used configuration) while the rest of the opts will be passed as-is to the invoked Pig program.
 
 The job will be created and run right away.
 

Modified: oozie/trunk/release-log.txt
URL: http://svn.apache.org/viewvc/oozie/trunk/release-log.txt?rev=1464676&r1=1464675&r2=1464676&view=diff
==============================================================================
--- oozie/trunk/release-log.txt (original)
+++ oozie/trunk/release-log.txt Thu Apr  4 18:52:09 2013
@@ -1,5 +1,6 @@
 -- Oozie 4.1.0 release (trunk - unreleased)
 
+OOZIE-1288 Improve docs around -D arguments support in the Oozie CLI's pig subcommand (harsh)
 OOZIE-1291 TestHadoopAccessorService.testGetMRDelegationTokenRenewer fails against Yarn (rkanter)
 OOZIE-1278 oozie example datelist-java-main has job property typo and has no lib directory for examples.jar (bowenzhangusa via rkanter)
 OOZIE-1264 The "parent" property of a subworkflow should be the ID of the parent workflow (rkanter)