You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@uima.apache.org by bu...@apache.org on 2015/02/06 15:17:29 UTC

svn commit: r1657818 - in /uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli: ducc-services.tex ducc-submit.tex

Author: burn
Date: Fri Feb  6 14:17:29 2015
New Revision: 1657818

URL: http://svn.apache.org/r1657818
Log:
UIMA-4219 - add new options (flow controller & exception handler args) & deprecate/change process_dd

Modified:
    uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-services.tex
    uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-submit.tex

Modified: uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-services.tex
URL: http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-services.tex?rev=1657818&r1=1657817&r2=1657818&view=diff
==============================================================================
--- uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-services.tex (original)
+++ uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-services.tex Fri Feb  6 14:17:29 2015
@@ -221,7 +221,7 @@
         machines DUCC, sub-directory and file names are generated by DUCC and may 
         not be directly specified. 
 
-      \item[$--$process\_DD {[DD descriptor]}] 
+      \item[$--$process\_descriptor\_DD {[DD descriptor]}] 
         This specifies the UIMA Deployment Descriptor for \hyperref[sec:services.types]{UIMA-AS services}.
 
       \item[$--$process\_debug {[host:port]}]        
@@ -265,7 +265,7 @@
 
       \item[$--$service\_ping\_arguments {[argument-string]}] This is any arbitrary string
         that is passed to the {\em init()} method of the service pinger.  The contents of
-        the string is entirely a function of the specifici service.  If not specified,
+        the string is entirely a function of the specific service.  If not specified,
         a {\em null} is passed in.
 
         Note: When used as a CLI option, the string must usually be

Modified: uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-submit.tex
URL: http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-submit.tex?rev=1657818&r1=1657817&r2=1657818&view=diff
==============================================================================
--- uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-submit.tex (original)
+++ uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/cli/ducc-submit.tex Fri Feb  6 14:17:29 2015
@@ -115,6 +115,20 @@
              handler is provided.
            \end{sloppypar}
            
+           \item[$--$driver\_exception\_handler\_arguments {[argument-string]}] This is a string
+             containing arguments for the exception handler.  The contents of
+             the string is entirely a function of the specified handler.  If not specified,
+             a {\em null} is passed in.
+
+             Note: When used as a CLI option, the string must usually be
+             quoted to protect it from the shell, if it contains blanks.
+
+             The built-in default exception handler supports an argument string of the following form
+             (with NO embedded blanks):
+\begin{verbatim}
+     max_job_errors=15,max_process_errors=3,max_cas_timeouts=2
+\end{verbatim}
+
            \item[$--$driver\_jvm\_args {[list]} ]
 
              This specifies extra JVM arguments to be provided to the Job Driver process. It is a blank-delimited 
@@ -171,20 +185,6 @@ ducc.submit.environment.propagated
              machines, sub-directory and file names are generated by DUCC and may 
              not be directly specified. 
 
-           \begin{sloppypar}
-           \item[$--$process\_DD {[DD descriptor]}  ]
-
-             This specifies a UIMA Deployment Descriptor for the job processes for DD-style jobs. 
-             This is mutually exclusive with $--$process\_descriptor\_AE, $--$process\_descriptor\_CM, 
-             and $--$process\_descriptor\_CC. This 
-             descriptor is a resource that is searched for in the filesystem or Java classpath as described 
-             in the ~\hyperref[par:cli.submit.notes]{notes below}.
-             For example:
-             \begin{verbatim}
---process_DD /home/billy/resource/DD_foo.xml 
-             \end{verbatim}
-           \end{sloppypar}
-
            \item[$--$process\_debug {[debug-port]}] Append JVM debug flags to the JVM
              arguments to start the Job Process in remote debug mode.  The remote process will start
              its debugger and attempt to contact the debugger (usually Eclipse) on the specified
@@ -206,7 +206,7 @@ ducc.submit.environment.propagated
              This specifies the Analysis Engine descriptor to be deployed in the Job Processes. This 
              descriptor is a resource that is searched for in the filesystem or Java classpath as described 
              in the ~\hyperref[par:cli.submit.notes]{notes below}.
-             It is mutually exclusive with $--$process\_DD For example: 
+             It is mutually exclusive with $--$process\_descriptor\_DD For example: 
              \begin{verbatim}
 --process_descriptor_AE /home/billy/resource/AE_foo.xml 
              \end{verbatim}
@@ -226,7 +226,7 @@ ducc.submit.environment.propagated
              This specifies the CAS Consumer descriptor to be deployed in the Job Processes. This 
              descriptor is a resource that is searched for in the filesystem or Java classpath as described 
              in the ~\hyperref[par:cli.submit.notes]{notes below}.
-             It is mutually exclusive with $--$process\_DD For example: 
+             It is mutually exclusive with $--$process\_descriptor\_DD For example: 
              \begin{verbatim}
 --process_descriptor_CC /home/billy/resourceCCE_foo.xml 
              \end{verbatim}
@@ -245,7 +245,7 @@ ducc.submit.environment.propagated
              This specifies the CAS Multiplier descriptor to be deployed in the Job Processes. This 
              descriptor is a resource that is searched for in the filesystem or Java classpath as described 
              in the ~\hyperref[par:cli.submit.notes]{notes below}.
-             It is mutually exclusive with $--$process\_DD For example: 
+             It is mutually exclusive with $--$process\_descriptor\_DD For example: 
              \begin{verbatim}             
 --process_descriptor_CM /home/billy/resource/CM_foo.xml 
              \end{verbatim}
@@ -259,6 +259,37 @@ ducc.submit.environment.propagated
 \end{verbatim}
            \end{sloppypar}
            
+           \item[$--$process\_descriptor\_DD {[descriptor]}  ]
+
+             This specifies a UIMA Deployment Descriptor for the job processes for DD-style jobs. 
+             This is mutually exclusive with $--$process\_descriptor\_AE, $--$process\_descriptor\_CM, 
+             and $--$process\_descriptor\_CC. This 
+             descriptor is a resource that is searched for in the filesystem or Java classpath as described 
+             in the ~\hyperref[par:cli.submit.notes]{notes below}.
+             For example:
+             \begin{verbatim}
+--process_descriptor_DD /home/billy/resource/DD_foo.xml 
+             \end{verbatim}
+
+           \item[$--$process\_descriptor\_FC {[descriptor]}  ]
+
+             This specifies the Flow Controller descriptor to be deployed in the Job Processes. This 
+             descriptor is a resource that is searched for in the filesystem or Java classpath as described 
+             in the ~\hyperref[par:cli.submit.notes]{notes below}.
+             For example: 
+             \begin{verbatim}
+--process\_descriptor\_FC /home/billy/flow\_foo.xml 
+             \end{verbatim}
+
+           \begin{sloppypar}             
+           \item[$--$process\_descriptor\_FC\_overrides {[list]}  ]
+
+             This specifies FC overrides. It is a whitespace-delimited list of name/value pairs. Example: 
+             \begin{verbatim}
+--process\_descriptor\_FC\_overrides name1=value1 name2=value2 
+             \end{verbatim}
+           \end{sloppypar}             
+           
            \item[$--$process\_failures\_limit {[integer]} ]
 
              This specifies the maximum number of individual Job Process (JP) failures allowed