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 <[email protected]>
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
