tomee-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jgallim...@apache.org
Subject [tomee] branch master updated: Adding log4j2 doc
Date Tue, 09 Jul 2019 14:30:38 GMT
This is an automated email from the ASF dual-hosted git repository.

jgallimore pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tomee.git


The following commit(s) were added to refs/heads/master by this push:
     new 68ae283  Adding log4j2 doc
     new 3c5fed7  Merge branch 'master' of https://github.com/jgallimore/tomee
68ae283 is described below

commit 68ae28312528cbc7b008372b43a0e24a418bed25
Author: Jonathan Gallimore <jon@jrg.me.uk>
AuthorDate: Tue Jul 9 15:27:02 2019 +0100

    Adding log4j2 doc
---
 docs/admin/configuration/log4j2.adoc | 70 ++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/docs/admin/configuration/log4j2.adoc b/docs/admin/configuration/log4j2.adoc
new file mode 100644
index 0000000..a341665
--- /dev/null
+++ b/docs/admin/configuration/log4j2.adoc
@@ -0,0 +1,70 @@
+= Log4j2 Configuration
+:jbake-date: 2019-07-09
+:jbake-type: page
+:jbake-status: published
+:jbake-tomeepdf:
+
+Title: Log4j2 with TomEE
+
+Out of the box, TomEE is uses a Java-Util-Logging (JUL) based logging system, which is configured
using conf/logging.properties.
+
+Occassionally, users may wish to swap over to using Log4j2. These instructions detail how
to do this with the latest TomEE versions.
+These instructions have been tested with TomEE 7.x and TomEE 8 SNAPSHOT (master) on July
9th, 2019.
+
+== Setup
+
+You'll need to obtain the following jars: log4j-core, log4j-api and log4j-jul. These instructions
were tested with the 2.12.0 versions:
+
+https://repo1.maven.org/maven2/org/apache/logging/log4j/log4j-core/2.12.0/log4j-core-2.12.0.jar
+https://repo1.maven.org/maven2/org/apache/logging/log4j/log4j-api/2.12.0/log4j-api-2.12.0.jar
+https://repo1.maven.org/maven2/org/apache/logging/log4j/log4j-jul/2.12.0/log4j-jul-2.12.0.jar
+
+Add these to the TomEE bin directory. Add the following to setenv.sh on *nix:
+
+```
+    JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
+    LOGGING_CONFIG="-DnoOp"
+    LOGGING_MANAGER="-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
+    CLASSPATH=".:$CATALINA_BASE/bin:$CATALINA_BASE/bin/log4j-core-2.12.0.jar:$CATALINA_BASE/bin/log4j-api-2.12.0.jar:$CATALINA_BASE/bin/log4j-jul-2.12.0.jar"
+```
+
+or add the following to setenv.bat on Windows:
+
+```
+    @echo off
+    set "JAVA_OPTS=%JAVA_OPTS% -Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
+    set LOGGING_CONFIG=-DnoOpp
+    set LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
+    set "CLASSPATH=.;%CATALINA_BASE%\bin;%CATALINA_BASE%\bin\log4j-core-2.12.0.jar;%CATALINA_BASE%\bin\log4j-api-2.12.0.jar;%CATALINA_BASE%\bin\log4j-jul-2.12.0.jar"
+```
+
+Take care to match the jar filenames if you have downloaded jars for a slightly different
version of log4j2.
+
+== Configuration
+
+Add your log4j2.xml config in the `bin` directory.  Here's a simple config you can use to
help you get started:
+
+```
+    <?xml version="1.0" encoding="UTF-8" ?>
+    <Configuration status="warn" name="catalina" packages="">
+        <Appenders>
+            <Console name="console" target="SYSTEM_OUT">
+                <PatternLayout pattern="%d %p %c{1.} [%t] %m%n" />
+            </Console>
+            <File name="catalina" fileName="${sys:catalina.base}/logs/catalina.log">
+                <PatternLayout>
+                    <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
+                </PatternLayout>
+            </File>
+            <Async name="Async">
+                <AppenderRef ref="catalina" />
+            </Async>
+        </Appenders>
+        <Loggers>
+            <Root level="info">
+                <AppenderRef ref="Async" />
+                <AppenderRef ref="console" />
+            </Root>
+        </Loggers>
+    </Configuration>
+```
\ No newline at end of file


Mime
View raw message