Author: chetanm
Date: Fri Mar 7 06:50:27 2014
New Revision: 1575195
URL: http://svn.apache.org/r1575195
Log:
Adding FAQ
Modified:
sling/site/trunk/content/documentation/development/logging.mdtext
Modified: sling/site/trunk/content/documentation/development/logging.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/development/logging.mdtext?rev=1575195&r1=1575194&r2=1575195&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/development/logging.mdtext (original)
+++ sling/site/trunk/content/documentation/development/logging.mdtext Fri Mar
7 06:50:27 2014
@@ -290,12 +290,10 @@ The bundle also support [SLF4JBridgeHand
This allows for routing logging messages from JUL to the Logbback appenders.
1. Set the `org.apache.sling.commons.log.julenabled` framework property to
true.
-2. Set the [LevelChangePropagator][8] in LogbackConfig:
- :::xml
- <configuration>
- <contextListener
class="ch.qos.logback.classic.jul.LevelChangePropagator"/>
- </configuration>
+
+If `org.apache.sling.commons.log.julenabled` is found to be true then
[LevelChangePropagator][8] would be
+registered automatically with Logback
### <a name="config-override"></a>Configuring OSGi appenders in the Logback
Config
@@ -375,6 +373,26 @@ The Slf4j API bundle 1.7.x is binary com
This setup allows your bundles to make use of the var args feature while
making logging calls, but the bundles
can still be deployed on older systems which provide only the 1.6.4 version of
the slf4j api.
+## FAQ
+
+##### Q. Can Sling Commons Log bundle be used in non Sling environments
+
+This bundle does not depend on any other Sling bundle and can be easily used
in any OSGi framework.
+To get complete log support working you need to deploy following bundles
+
+* Slf4j-Api - org.slf4j:slf4j-api
+* Jcl over Slf4j - org.slf4j:jcl-over-slf4j
+* Log4j over Slf4j - org.slf4j:log4j-over-slf4j
+* Sling Log Service -
org.apache.sling:org.apache.sling.commons.logservice:1.0.2
+* Sling Commons Log - org.apache.sling:org.apache.sling.commons.log:4.0.0 or
above
+
+##### Q. How to start Sling with an external logback.xml file
+
+You need to specify the location of logback.xml via
`org.apache.sling.commons.log.configurationFile`
+
+ java -jar org.apache.sling.launchpad-XXX-standalone.jar
-Dorg.apache.sling.commons.log.configurationFile=/path/to/logback
+
+
## WebConsole Plugin
The Web Console Plugin supports the following features:
