svn commit: r1775314 - in /uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook: part2/job-logs.tex part4/system-logs.tex

[bu...@apache.org]

Author: burn
Date: Tue Dec 20 16:10:20 2016
New Revision: 1775314

URL: http://svn.apache.org/viewvc?rev=1775314&view=rev
Log:
UIMA-5183 Describe node-specific log4j configuration file; modify job logs description

Modified:
    uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/job-logs.tex
    uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/system-logs.tex

Modified: uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/job-logs.tex
URL: http://svn.apache.org/viewvc/uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/job-logs.tex?rev=1775314&r1=1775313&r2=1775314&view=diff
==============================================================================
--- uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/job-logs.tex (original)
+++ uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/job-logs.tex Tue Dec 20 16:10:20 2016
@@ -24,14 +24,11 @@
 \chapter{Job Logs}
 \label{chap:job-logs}
 
-\begin{sloppypar}
-\paragraph{Overview}The DUCC logs are managed by Apache log4j.  The DUCC log4j configuration file is found in
+The "user logs" are the Job Driver (JD) and Job Process (JP) logs. There is one JP log for each process 
+of a job.  These hold the redirected stdout and stderr messages from user code as well as some DUCC-generated
+messages.  These DUCC messages are managed by Apache log4j using the configuration file 
 \duccruntime/resources/log4j.xml. It is not in the scope of this document to describe log4j or its
 configuration mechanism. Details on log4j can be found at \url{http://logging.apache.org/log4j}.
-\end{sloppypar}
-
-The "user logs" are the Job Driver (JD) and Job Process (JP) logs. There is one log for each process 
-of a job.
 
 \paragraph{Contents of the Log Directory} A number of other useful files are written to the log directory: 
 

Modified: uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/system-logs.tex
URL: http://svn.apache.org/viewvc/uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/system-logs.tex?rev=1775314&r1=1775313&r2=1775314&view=diff
==============================================================================
--- uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/system-logs.tex (original)
+++ uima/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/system-logs.tex Tue Dec 20 16:10:20 2016
@@ -22,14 +22,21 @@
     This chapter provides an overview of the DUCC process logs and how to interpret the
     entries therein.
 
-    Each of the DUCC ``head node'' processes writes a detailed log of its operation to
+    Each of the DUCC ``head node'' processes and agent processes writes a detailed log of its operation to
     the directory \ducchome/logs.  The logs are managed by Apache log4j.  All logs are
-    managed by a single log4j configuration file
+    usually managed by a single log4j configuration file
 \begin{verbatim}
         $DUCC_HOME/resources/log4j.xml
 \end{verbatim}
+    If an agent does not have write access to the \ducchome directory it may be given a
+    node-specific configuration file which can direct the log files to a locally writable
+    directory.  e.g. when starting an agent on node abc123.domain.whatever the DUCC logger will use
+    the following configuration file if it exists
+\begin{verbatim}
+        $DUCC_HOME/resources/abc123-log4j.xml
+\end{verbatim}
 
-    The DUCC logger is configured to check for updates to the log4j.xml
+    The DUCC logger is configured to check for updates to the log4j
     configuration file and automatically update without the need to restart any of
     the DUCC processes.  The update may take up to 60 seconds to take effect.