added README about the configuration

diff --git a/org.glite.lbjp-common.log/Makefile b/org.glite.lbjp-common.log/Makefile
index 5c2c8e8..5001755 100644 (file)
--- a/org.glite.lbjp-common.log/Makefile
+++ b/org.glite.lbjp-common.log/Makefile
@@ -66,6 +66,7 @@ install: compile
        ${INSTALL} -m 644 ${top_srcdir}/src/log.h ${PREFIX}/include/${globalprefix}/${lbutilsprefix} 
        mkdir -p ${PREFIX}/share/doc/${package}-${version}
        ${INSTALL} -m 644 ${top_srcdir}/LICENSE ${PREFIX}/share/doc/${package}-${version}
+       ${INSTALL} -m 644 ${top_srcdir}/README ${PREFIX}/share/doc/${package}-${version}
        mkdir -p ${PREFIX}/etc
        ${INSTALL} -m 644 ${top_srcdir}/src/log4crc.* ${PREFIX}/share/doc/${package}-${version}
        ${INSTALL} -m 644 ${top_srcdir}/src/log4crc.example-production ${PREFIX}/etc/glite-lb-log4crc

diff --git a/org.glite.lbjp-common.log/README b/org.glite.lbjp-common.log/README
new file mode 100644 (file)
index 0000000..f59a7bd
--- /dev/null
+++ b/org.glite.lbjp-common.log/README
@@ -0,0 +1,19 @@
+This package implements the glite common logging formats
+with respect to the gLite common logging recommendations v1.1:
+
+https://twiki.cern.ch/twiki/pub/EGEE/EGEEgLite/logging.html
+
+The implementation uses log4c (http://log4c.sourceforge.net) 
+and its configuration file log4crc. Two examples are provided
+
+- log4crc.example-production - this file is now being installed to 
+$GLITE_LOCATION/etc/glite-lb-log4crc and startup scripts 
+use it by setting the LOG4C_RCPATH environment variable
+
+- log4crc.example-debugging - this file may be useful to copy to
+~/.log4crc (or by setting the LOG4C_RCPATH environment variable
+to this file) to obtain detailed debugging output
+
+One can debug only specific parts of the LB system, for example
+by uncommenting LB.SERVER.DB cathegory one gets only the debugging 
+info related to the underlying database subsystem calls.