tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r810960 - /tomcat/tc6.0.x/trunk/webapps/docs/logging.xml
Date Thu, 03 Sep 2009 14:15:09 GMT
Author: markt
Date: Thu Sep  3 14:15:09 2009
New Revision: 810960

URL: http://svn.apache.org/viewvc?rev=810960&view=rev
Log:
Port latest tweaks

Modified:
    tomcat/tc6.0.x/trunk/webapps/docs/logging.xml

Modified: tomcat/tc6.0.x/trunk/webapps/docs/logging.xml
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/logging.xml?rev=810960&r1=810959&r2=810960&view=diff
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/logging.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/logging.xml Thu Sep  3 14:15:09 2009
@@ -32,7 +32,7 @@
 
   <section name="Introduction">
     <p>
-      Tomcat 6.0 uses 
+      Tomcat uses 
       <a href="http://commons.apache.org/logging">Commons Logging</a>
       throughout its internal code allowing the 
       developer to choose a logging configuration that suits their needs, e.g
@@ -80,10 +80,9 @@
     assigning them to loggers.
   </p>
   <p>
-    JULI is enabled by default in Tomcat 6.0, and supports per classloader
-    configuration, in addition to the regular global java.util.logging
-    configuration. This means that logging can be configured at the following
-    layers:
+    JULI is enabled by default, and supports per classloader configuration, in
+    addition to the regular global java.util.logging configuration. This means
+    that logging can be configured at the following layers:
     <ul>
       <li>In the JDK's logging.properties file. Check your JAVA_HOME environment
       setting to see which JDK Tomcat is using. The file will be in 
@@ -136,8 +135,10 @@
   <p>
     Example logging.properties file to be placed in $CATALINA_BASE/conf:
     <source>
-handlers = 1catalina.org.apache.juli.FileHandler, 2localhost.org.apache.juli.FileHandler,
\
-           3manager.org.apache.juli.FileHandler, 4admin.org.apache.juli.FileHandler, \
+handlers = 1catalina.org.apache.juli.FileHandler, \
+           2localhost.org.apache.juli.FileHandler, \
+           3manager.org.apache.juli.FileHandler, \
+           4admin.org.apache.juli.FileHandler, \
            java.util.logging.ConsoleHandler
 
 .handlers = 1catalina.org.apache.juli.FileHandler, java.util.logging.ConsoleHandler
@@ -227,13 +228,13 @@
         <li>Create a file called log4j.properties with the following content 
             and save it into $CATALINA_HOME/lib.
           <source>
-            log4j.rootLogger=INFO, R <br />
-            log4j.appender.R=org.apache.log4j.RollingFileAppender <br />
-            log4j.appender.R.File=${catalina.home}/logs/tomcat.log <br />
-            log4j.appender.R.MaxFileSize=10MB <br />
-            log4j.appender.R.MaxBackupIndex=10 <br />
-            log4j.appender.R.layout=org.apache.log4j.PatternLayout <br />
-            log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
+log4j.rootLogger=INFO, R <br />
+log4j.appender.R=org.apache.log4j.RollingFileAppender <br />
+log4j.appender.R.File=${catalina.base}/logs/tomcat.log <br />
+log4j.appender.R.MaxFileSize=10MB <br />
+log4j.appender.R.MaxBackupIndex=10 <br />
+log4j.appender.R.layout=org.apache.log4j.PatternLayout <br />
+log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n
           </source>
         </li>
 
@@ -250,6 +251,8 @@
         <li>Place <code>output/extras/tomcat-juli-adapters.jar</code> in

             $CATALINA_HOME/lib.</li>
 
+        <li>Delete <code>$CATALINA_BASE/conf/logging.properties</code>
to
+            prevent java.util.logging generating zero length log files.</li>
         <li>Start Tomcat</li>
       </ol>
     </p>
@@ -264,7 +267,7 @@
         
     <p>
       You can (and should) be more picky about which packages to include 
-      in the logging. Tomcat 6 defines loggers by Engine and Host names.
+      in the logging. Tomcat defines loggers by Engine and Host names.
       For example, for a more detailed Catalina localhost log, add this to the
       end of the log4j.properties above. Note that there are known issues with 
       using this naming convention (with square brackets) in log4j XML based
@@ -272,9 +275,9 @@
       described until a future version of log4j allows this convention.
       
       <source>
-        log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost]=DEBUG<br
/>
-        log4j.logger.org.apache.catalina.core=DEBUG<br />
-        log4j.logger.org.apache.catalina.session=DEBUG<br />
+log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost]=DEBUG<br />
+log4j.logger.org.apache.catalina.core=DEBUG<br />
+log4j.logger.org.apache.catalina.session=DEBUG<br />
       </source>
 
       Be warned a level of DEBUG will produce megabytes of logging and slow



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message