Author: buildbot
Date: Fri Jan 8 16:46:14 2016
New Revision: 977310
Log:
Staging update by buildbot for sling
Modified:
websites/staging/sling/trunk/content/ (props changed)
websites/staging/sling/trunk/content/documentation/bundles/file-installer-provider.html
Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Jan 8 16:46:14 2016
@@ -1 +1 @@
-1723667
+1723756
Modified:
websites/staging/sling/trunk/content/documentation/bundles/file-installer-provider.html
==============================================================================
---
websites/staging/sling/trunk/content/documentation/bundles/file-installer-provider.html
(original)
+++
websites/staging/sling/trunk/content/documentation/bundles/file-installer-provider.html
Fri Jan 8 16:46:14 2016
@@ -129,7 +129,7 @@ h2:hover > .headerlink, h3:hover > .head
<tr>
<td><code>sling.fileinstall.dir</code></td>
<td></td>
-<td>The name/path of the directories to watch. Several directories can be
specified by using a comma separated list.</td>
+<td>The name/path of the directories to watch. Several directories can be
specified by using a comma separated list. Each directory might have
arbitrarily many sub directories (even nested ones) which may contain the
artifacts</td>
</tr>
<tr>
<td><code>sling.fileinstall.interval</code></td>
@@ -146,19 +146,20 @@ h2:hover > .headerlink, h3:hover > .head
<h2 id="bundles">Bundles<a class="headerlink" href="#bundles" title="Permanent
link">¶</a></h2>
<p>Bundles are supported by the OSGi installer. If a bundle jar is added to a
scanned directory, this bundle is installed. If the file is updated/changed,
the bundle is updated. If the file is removed, the bundle gets removed.
Of course, these are the simple rules. The actual action depends by the
overall state of the system and is controlled by the OSGi installer. For
example if already the same bundle with a higher version is installed, when a
bundle is dropped into the install folder, the OSGi installer will perform no
operation.</p>
-<p>Start levels are supported as well by creating a directory with the name of
the start level within the scan directory and putting the bundles within this
directory. For example, if the 'install' folder is scanned, the bundle
'install/3/mybundle.jar' will be installed with start level 3. Without such a
directory the default start level is used.</p>
+<p>Start levels are supported as well by creating a directory with the name of
the start level within the scan directory and putting the bundles within this
directory. For example, if the <code>install</code> folder is scanned, the
bundle <code>install/3/mybundle.jar</code> will be installed with start level
3. Without such a directory the default start level is used.</p>
<h2 id="configurations">Configurations<a class="headerlink"
href="#configurations" title="Permanent link">¶</a></h2>
<p>Configurations are handled by the <a
href="/documentation/bundles/configuration-installer-factory.html">Configuration
Installer Factory</a>. The different formats are described there.</p>
<h2 id="custom-artifacts">Custom Artifacts<a class="headerlink"
href="#custom-artifacts" title="Permanent link">¶</a></h2>
<p>Custom artifacts are handled by the OSGi installer depending on the
installed plugins. Have a look at the OSGi installer and it's plugins for more
information.</p>
<h2 id="runmode-support">Runmode Support<a class="headerlink"
href="#runmode-support" title="Permanent link">¶</a></h2>
-<p>The file installer supports run modes for installing artifacts. Within the
scanned directory, a folder named with the run mode will only provisioning
these artifacts if the respective run mode is active. If an artifact is
associated with several run modes, the name of the directory contains all of
them separated by a dot, for example <em>a1.dev</em>.</p>
+<p>The file installer supports run modes for installing artifacts (added with
(SLING-4478)[https://issues.apache.org/jira/browse/SLING-4478]). Within the
scanned directory, a folder prefixed with "install." and followed by one or
more run modes (separated by ".") will only be considered if all the respective
run modes are active. For example artifacts below a folder named
<code>install.a1.dev</code> are only taken into account if the run modes
<code>a1</code> and <code>dev</code> are both active. </p>
+<p>You can even combine start level and run mode support. Just pay attention
that the run mode foldername must be set on a direct child folder of
<code>sling.fileinstall.dir</code> while the start level must be set directly
on the parent folder of the artifact you want to install. E.g.
<code><sling.fileinstall.dir>/install.a1.dev/3/mybundle.jar</code> will
only be considered if both run modes <code>a1</code> and <code>dev</code> are
set. If this is the case then the according artifact will be installed in start
level 3.</p>
<h1 id="project-info">Project Info<a class="headerlink" href="#project-info"
title="Permanent link">¶</a></h1>
<ul>
<li>File installer provider (<a
href="http://svn.apache.org/repos/asf/sling/trunk/installer/providers/file">org.apache.sling.installer.provider.file</a>)</li>
</ul>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1648494 by cziegeler on Tue, 30 Dec 2014 09:45:30 +0000
+ Rev. 1723756 by kwin on Fri, 8 Jan 2016 16:45:58 +0000
</div>
<div class="trademarkFooter">
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache
Sling project