tomee-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jgallim...@apache.org
Subject [tomee-site-generator] branch master updated: Adding information on running with log4j2
Date Tue, 09 Jul 2019 13:59:29 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-site-generator.git


The following commit(s) were added to refs/heads/master by this push:
     new 9b71323  Adding information on running with log4j2
9b71323 is described below

commit 9b7132336910891dcb4d643d53bc8bc53b50e791
Author: Jonathan Gallimore <jon@jrg.me.uk>
AuthorDate: Tue Jul 9 13:58:40 2019 +0000

    Adding information on running with log4j2
---
 src/main/jbake/content/log4j2.md | 67 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/src/main/jbake/content/log4j2.md b/src/main/jbake/content/log4j2.md
new file mode 100644
index 0000000..fde2757
--- /dev/null
+++ b/src/main/jbake/content/log4j2.md
@@ -0,0 +1,67 @@
+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 XXXXXX 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>
+```
+
+
+


Mime
View raw message