From: Jan Pospíšil <honik@ntc.zcu.cz>
Date: Mon, 15 Mar 2010 08:17:02 +0000 (+0000)
Subject: added info about the log4c configuration
X-Git-Tag: merge_20_2_dst~6
X-Git-Url: http://scientific.zcu.cz/git/?a=commitdiff_plain;h=4c96c9ad15355e3d90a64fb8a4a5b2c628ba09cb;p=jra1mw.git

added info about the log4c configuration
---

diff --git a/org.glite.lb.doc/src/LBAG-Installation.tex b/org.glite.lb.doc/src/LBAG-Installation.tex
index 050a865..6283db9 100644
--- a/org.glite.lb.doc/src/LBAG-Installation.tex
+++ b/org.glite.lb.doc/src/LBAG-Installation.tex
@@ -76,6 +76,7 @@ glite-jobid-api-c & gLite jobId C API library \\
 % pro beh LB neni triba
 % glite-jp-common & JP common files \\ 
 glite-lbjp-common-db & database access layer \\
+glite-lbjp-common-log & glite common logging format implementation \\
 glite-lbjp-common-maildir & persistent request spool management \\
 glite-lbjp-common-server-bones & multi-process server building library \\
 glite-lbjp-common-trio & extended printf implementation \\
@@ -87,7 +88,26 @@ where all \verb'glite-lbjp-common-*' packages are common both to \LB and
 Job Provenance (\JP).
 
 \subsection{Common logging format}
-\TODO{once implemented, describe the log4crc configuration}
+\LB service follows the \textbf{gLite common logging recommendations v1.1}:
+\begin{center}
+\url{https://twiki.cern.ch/twiki/pub/EGEE/EGEEgLite/logging.html}. 
+\end{center}
+
+The implementation is done in the \texttt{glite-lbjp-common-log} package and it 
+uses \texttt{log4c} (\url{http://log4c.sourceforge.net})
+and its configuration file \texttt{log4crc}. Two examples are provided
+\begin{itemize}
+\item \texttt{log4crc.example-production} - this file is now being installed to
+\texttt{\$GLITE\_LOCATION/etc/glite-lb-log4crc} and startup scripts
+use it by setting the \texttt{LOG4C\_RCPATH} environment variable,
+\item \texttt{log4crc.example-debugging} - this file may be useful to copy to
+\texttt{~/.log4crc} (or by setting the \texttt{LOG4C\_RCPATH} environment variable
+to this file) to obtain detailed debugging output.
+\end{itemize}
+One can debug only specific parts of the LB system, for example
+by uncommenting \texttt{LB.SERVER.DB} cathegory in the \texttt{log4crc} file,
+one gets only the debugging info related to the underlying database subsystem calls.
+
 
 \subsection{\LB server}