How do I enable DEBUG logging for category org.apache.catalina in the Tomcat distribution?
Adding the following category in $NUXEO_HOME/lib/log4j.xml does not seem to enable DEBUG logging for “org.apache.catalina” within the Tomcat Nuxeo Distribution. Does this category require special configuration?
Hello,
$NUXEO_HOME/conf/logging.properties
has no effect; you can safely remove it.
The point is Tomcat uses java.util.logging whereas Nuxeo uses Log4J.
Nuxeo provides a bridge for redirecting java.util.logging to Apache Commons Logging (compliant with Log4J) with a default threshold set at INFO level. You can customize it by adding into nuxeo.conf
:
JAVA_OPTS=$JAVA_OPTS -Dorg.nuxeo.runtime.redirectJUL.threshold=DEBUG
Edit: the right corresponding JUL value for Log4J DEBUG level is
JAVA_OPTS=$JAVA_OPTS -Dorg.nuxeo.runtime.redirectJUL.threshold=CONFIG
But that redirection is only available after Nuxeo Framework initialization whereas most of the startup logs from org.apache.catalina happen before (when the redirection is not yet active).
So, if you want to see Catalina messages, you must also:
- go on Tomcat 6 download page, then “Quick Navigation”, “Browse”, “bin”, “extras”
- download
tomcat-juli-adapters.jar
into$NUXEO_HOME/lib/
- download
tomcat-juli.jar
into$NUXEO_HOME/bin/
(replace the existing one)
At this point, the Log4J configuration will also apply on logs sent to java.util.logging; the category you added will work.
You may be interested by NXP-7014.
Note the Nuxeo bridge will ignore FINER and FINEST which are too much verbose, FINE is mapped with TRACE and CONFIG with DEBUG.