Author: buildbot
Date: Fri Mar 7 06:50:40 2014
New Revision: 900399
Log:
Staging update by buildbot for sling
Modified:
websites/staging/sling/trunk/content/ (props changed)
websites/staging/sling/trunk/content/documentation/development/logging.html
Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 7 06:50:40 2014
@@ -1 +1 @@
-1575190
+1575195
Modified:
websites/staging/sling/trunk/content/documentation/development/logging.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/development/logging.html
(original)
+++ websites/staging/sling/trunk/content/documentation/development/logging.html
Fri Mar 7 06:50:40 2014
@@ -121,6 +121,11 @@ This document is for the new (November 2
</ul>
</li>
<li><a href="#using-slf4j-api-17">Using Slf4j API 1.7</a></li>
+<li><a href="#faq">FAQ</a><ul>
+<li><a
href="#q-can-sling-commons-log-bundle-be-used-in-non-sling-environments">Q. Can
Sling Commons Log bundle be used in non Sling environments</a></li>
+<li><a href="#q-how-to-start-sling-with-an-external-logbackxml-file">Q. How to
start Sling with an external logback.xml file</a></li>
+</ul>
+</li>
<li><a href="#webconsole-plugin">WebConsole Plugin</a></li>
</ul>
</div>
@@ -482,16 +487,9 @@ action entry:</p>
This allows for routing logging messages from JUL to the Logbback
appenders.</p>
<ol>
<li>Set the <code>org.apache.sling.commons.log.julenabled</code> framework
property to true.</li>
-<li>
-<p>Set the <a
href="http://logback.qos.ch/manual/configuration.html#LevelChangePropagator";>LevelChangePropagator</a>
in LogbackConfig:</p>
-<div class="codehilite"><pre><span class="nt"><configuration></span>
- <span class="nt"><contextListener</span> <span
class="na">class=</span><span
class="s">"ch.qos.logback.classic.jul.LevelChangePropagator"</span><span
class="nt">/></span>
-<span class="nt"></configuration></span>
-</pre></div>
-
-
-</li>
</ol>
+<p>If <code>org.apache.sling.commons.log.julenabled</code> is found to be true
then <a
href="http://logback.qos.ch/manual/configuration.html#LevelChangePropagator";>LevelChangePropagator</a>
would be
+registered automatically with Logback </p>
<h3 id="wzxhzdk13wzxhzdk14configuring-osgi-appenders-in-the-logback-config"><a
name="config-override"></a>Configuring OSGi appenders in the Logback Config</h3>
<p>So far Sling used to configure the appenders based on OSGi config. This
provides a very limited
set of configuration options. To make use of other Logback features you can
override the OSGi config
@@ -570,6 +568,23 @@ of the API jar, follow the below steps.
<p>The Slf4j API bundle 1.7.x is binary compatible with 1.6.x.</p>
<p>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.</p>
+<h2 id="faq">FAQ</h2>
+<h5 id="q-can-sling-commons-log-bundle-be-used-in-non-sling-environments">Q.
Can Sling Commons Log bundle be used in non Sling environments</h5>
+<p>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</p>
+<ul>
+<li>Slf4j-Api - org.slf4j:slf4j-api</li>
+<li>Jcl over Slf4j - org.slf4j:jcl-over-slf4j</li>
+<li>Log4j over Slf4j - org.slf4j:log4j-over-slf4j </li>
+<li>Sling Log Service -
org.apache.sling:org.apache.sling.commons.logservice:1.0.2</li>
+<li>Sling Commons Log - org.apache.sling:org.apache.sling.commons.log:4.0.0 or
above</li>
+</ul>
+<h5 id="q-how-to-start-sling-with-an-external-logbackxml-file">Q. How to start
Sling with an external logback.xml file</h5>
+<p>You need to specify the location of logback.xml via
<code>org.apache.sling.commons.log.configurationFile</code></p>
+<div class="codehilite"><pre> <span class="n">java</span> <span
class="o">-</span><span class="n">jar</span> <span class="n">org</span><span
class="p">.</span><span class="n">apache</span><span class="p">.</span><span
class="n">sling</span><span class="p">.</span><span
class="n">launchpad</span><span class="o">-</span><span
class="n">XXX</span><span class="o">-</span><span
class="n">standalone</span><span class="p">.</span><span class="n">jar</span>
<span class="o">-</span><span class="n">Dorg</span><span
class="p">.</span><span class="n">apache</span><span class="p">.</span><span
class="n">sling</span><span class="p">.</span><span
class="n">commons</span><span class="p">.</span><span
class="nb">log</span><span class="p">.</span><span
class="n">configurationFile</span><span class="p">=</span><span
class="o">/</span><span class="n">path</span><span class="o">/</span><span
class="n">to</span><span class="o">/</span><span class="n">logback</span>
+</pre></div>
+
+
<h2 id="webconsole-plugin">WebConsole Plugin</h2>
<p>The Web Console Plugin supports the following features:</p>
<ul>
@@ -581,7 +596,7 @@ can still be deployed on older systems w
</ul>
<p><img src="sling-log-support.png" /></p>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1546613 by chetanm on Fri, 29 Nov 2013 17:18:02 +0000
+ Rev. 1575195 by chetanm on Fri, 7 Mar 2014 06:50:27 +0000
</div>
<div class="trademarkFooter">
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache
Sling project
