From 4c96c9ad15355e3d90a64fb8a4a5b2c628ba09cb Mon Sep 17 00:00:00 2001 From: =?utf8?q?Jan=20Posp=C3=AD=C5=A1il?= Date: Mon, 15 Mar 2010 08:17:02 +0000 Subject: [PATCH] added info about the log4c configuration --- org.glite.lb.doc/src/LBAG-Installation.tex | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) 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} -- 1.8.2.3