incubator-sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r854607 - in /websites/staging/sling/trunk/content: ./ documentation/the-sling-engine/the-sling-launchpad.html
Date Fri, 15 Mar 2013 10:27:47 GMT
Author: buildbot
Date: Fri Mar 15 10:27:47 2013
New Revision: 854607

Log:
Staging update by buildbot for sling

Modified:
    websites/staging/sling/trunk/content/   (props changed)
    websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html

Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 15 10:27:47 2013
@@ -1 +1 @@
-1453826
+1456864

Modified: websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html
(original)
+++ websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html
Fri Mar 15 10:27:47 2013
@@ -91,6 +91,7 @@
 <li><a href="#sling-home">Sling Home</a></li>
 <li><a href="#command-line-options">Command Line Options</a><ul>
 <li><a href="#control-port">Control Port</a></li>
+<li><a href="#shutdown-hook">Shutdown Hook</a></li>
 </ul>
 </li>
 <li><a href="#servlet-parameters">Servlet Parameters</a></li>
@@ -187,6 +188,11 @@
 <td>Sets the property <code>n</code> to the value <code>v</code>.
This option can be added repeatedly setting additional properties. Any property set in this
manner overwrites same named properties in the <code>sling.properties</code> file.
(since Sling Launchpad 2.4.0)</td>
 </tr>
 <tr>
+<td><code>-n</code></td>
+<td>--</td>
+<td>Don't install the shutdown hook. See <a href="#shutdown-hook">Shutdown Hook</a>
below. (since Sling Launchpad 2.5.2)</td>
+</tr>
+<tr>
 <td><code>-h</code></td>
 <td>--</td>
 <td>Prints a simple usage message listing all available command line options.</td>
@@ -211,6 +217,14 @@
 <p>Suggestions:
 <em> Do not allow the control port to be opened on an externally visible interface.
Using the localhost/127.0.0.1 is just sufficient.
 </em> Make sure only legitimate users have access to the installation folder of Sling
(<code>${sling.home}</code>).</p>
+<h3 id="shutdown-hook">Shutdown Hook</h3>
+<p>By default the Sling Launchpad standalone application installs a Shutdown Hook with
the Java Runtime to make sure the framework is properly
+terminated in case of a Java termination. In some situations or setups you want to control
shutdown of Sling yourselves, so Sling supports a command
+line option <code>-n</code> to prevent the installation of a shutdown hook.</p>
+<p>Apart from the command line option, the <code>sling.shutdown.hook</code>
system property is also supported: If this property is set to <code>true</code>
or is not set at all
+the shutdown hook is installed as expected. If the property is set to anything other than
<code>true</code>, e.g. <code>false</code>, the shutdown hook is not
installed.</p>
+<p>If you are embedding the Sling Launchpad application's <code>Main</code>
class, the <code>sling.shutdown.hook</code> property can also be set as a member
of the <code>props</code> map
+handed to the <code>Main</code> constructor.</p>
 <h2 id="servlet-parameters">Servlet Parameters</h2>
 <p>The Web Application does not require specific servlet parameters. Those which are
specified are used to overwrite any properties with the same name from the <code>sling.properties</code>
file. One exception to this rule is the <code>sling.home</code> parameter, which
is used to set the value of the <code>sling.home</code> property. If no parameter
with this name is defined the Sling home directory is derived from the context path at which
the Sling Web Application is registered.</p>
 <p>The <code>sling.home</code> folders for Sling Web Applications without
the <code>sling.home</code> servlet parameter are all located in the <code>sling</code>
folder in the current working directory as reported by the <code>user.dir</code>
system property. The name of the actual directory is derived from the Web Application Context
Path by replacing all slash characters <code>/</code> by underscore characters
<code>_</code>. For the root context a single underscore character <code>_</code>
is used.</p>
@@ -337,7 +351,7 @@
 </ul>
 <p>That's it. The resulting artifact may be directly used to launch the Standalone
Java Application or may directly be deployed into any Servlet API 2.4 (or later) compliant
servlet container.</p>
       <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
-        Rev. 1366516 by fmeschbe on Fri, 27 Jul 2012 19:54:11 +0000
+        Rev. 1456864 by fmeschbe on Fri, 15 Mar 2013 10:27:37 +0000
       </div>
       <div class="trademarkFooter"> 
         Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project



Mime
View raw message