Author: buildbot
Date: Mon Mar 30 15:09:49 2015
New Revision: 945665
Log:
Staging update by buildbot for aries
Modified:
websites/staging/aries/trunk/content/ (props changed)
websites/staging/aries/trunk/content/modules/subsystems.html
Propchange: websites/staging/aries/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Mar 30 15:09:49 2015
@@ -1 +1 @@
-1670100
+1670122
Modified: websites/staging/aries/trunk/content/modules/subsystems.html
==============================================================================
--- websites/staging/aries/trunk/content/modules/subsystems.html (original)
+++ websites/staging/aries/trunk/content/modules/subsystems.html Mon Mar 30
15:09:49 2015
@@ -279,7 +279,82 @@
<td height="100%" width="100%">
<!-- Content -->
<div class="wiki-content"><h1 id="osgi-subsystems">OSGi
Subsystems</h1>
-<p>TODO add text.</p></div>
+<h2 id="introduction">Introduction</h2>
+<p>Apache Aries Subsystems is the Reference Implementation of the OSGi
Subsystems Specification, chapter 134 of the
+<a href="http://www.osgi.org/Specifications/HomePage"; title="OSGi Enterprise
specifications">OSGi Enterprise specifications</a>. </p>
+<h2 id="getting-started">Getting started</h2>
+<p>This section shows the bundles to install to get the Subsystems
implementation running in your favourite OSGi Framework.</p>
+<p>The Aries Subsystem implementation uses the OSGi Coordination service, the
OSGi
+Resolver service, the OSGi Repository service and integrates with the OSGi
Configuration Admin service. Additional
+dependencies are the Aries Util bundle, the Equinox Region bundle and SLF4J
for logging.</p>
+<p>The following are downloadable links (from Maven central) that
+provide all the required components to get subsystems up and running with
Apache
+Felix. Note that the Felix distribution comes with and OSGi Repository
implementation
+so this does not need to be added.</p>
+<ul>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/aries/subsystem/org.apache.aries.subsystem.api/1.1.0/org.apache.aries.subsystem.api-1.1.0.jar";>org.apache.aries.subsystem.api</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/aries/subsystem/org.apache.aries.subsystem.core/1.2.0/org.apache.aries.subsystem.core-1.2.0.jar";>org.apache.aries.subsystem.core</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/aries/org.apache.aries.util/1.1.0/org.apache.aries.util-1.1.0.jar";>org.apache.aries.util</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.configadmin/1.8.2/org.apache.felix.configadmin-1.8.2.jar";>org.apache.felix.configadmin</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.coordinator/1.0.0/org.apache.felix.coordinator-1.0.0.jar";>org.apache.felix.coordinator</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/apache/felix/org.apache.felix.resolver/1.0.0/org.apache.felix.resolver-1.0.0.jar";>org.apache.felix.resolver</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/eclipse/equinox/org.eclipse.equinox.region/1.1.0.v20120522-1841/org.eclipse.equinox.region-1.1.0.v20120522-1841.jar";>org.eclipse.equinox.region</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/slf4j/slf4j-api/1.7.12/slf4j-api-1.7.12.jar";>slf4j-api</a></li>
+<li><a
href="http://repo1.maven.org/maven2/org/slf4j/slf4j-simple/1.7.12/slf4j-simple-1.7.12.jar";>slf4j-simple</a>
(or another slf4j binding)</li>
+</ul>
+<p>After installing and starting all these components the Felix runtime looks
like this:</p>
+<div class="codehilite"><pre><span class="n">g</span>! <span
class="n">lb</span>
+<span class="n">START</span> <span class="n">LEVEL</span> 1
+ <span class="n">ID</span><span class="o">|</span><span
class="n">State</span> <span class="o">|</span><span
class="n">Level</span><span class="o">|</span><span class="n">Name</span>
+ 0<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 0<span class="o">|</span><span class="n">System</span>
<span class="n">Bundle</span> <span class="p">(</span>4<span
class="p">.</span>6<span class="p">.</span>1<span class="p">)</span>
+ 1<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Bundle</span> <span
class="n">Repository</span> <span class="p">(</span>2<span
class="p">.</span>0<span class="p">.</span>2<span class="p">)</span>
+ 2<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Gogo</span> <span
class="n">Command</span> <span class="p">(</span>0<span
class="p">.</span>14<span class="p">.</span>0<span class="p">)</span>
+ 3<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Gogo</span> <span
class="n">Runtime</span> <span class="p">(</span>0<span
class="p">.</span>12<span class="p">.</span>1<span class="p">)</span>
+ 4<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Gogo</span> <span
class="n">Shell</span> <span class="p">(</span>0<span class="p">.</span>10<span
class="p">.</span>0<span class="p">)</span>
+ 5<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Aries</span> <span class="n">Subsystem</span> <span
class="n">API</span> <span class="p">(</span>1<span class="p">.</span>1<span
class="p">.</span>0<span class="p">)</span>
+ 6<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Aries</span> <span class="n">Subsystem</span> <span
class="n">Core</span> <span class="p">(</span>1<span class="p">.</span>2<span
class="p">.</span>0<span class="p">)</span>
+ 7<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Aries</span> <span class="n">Util</span> <span
class="p">(</span>1<span class="p">.</span>1<span class="p">.</span>0<span
class="p">)</span>
+ 8<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Configuration</span> <span
class="n">Admin</span> <span class="n">Service</span> <span
class="p">(</span>1<span class="p">.</span>8<span class="p">.</span>2<span
class="p">)</span>
+ 9<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Coordinator</span> <span
class="n">Service</span> <span class="p">(</span>1<span
class="p">.</span>0<span class="p">.</span>0<span class="p">)</span>
+ 10<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Apache</span>
<span class="n">Felix</span> <span class="n">Resolver</span> <span
class="p">(</span>1<span class="p">.</span>0<span class="p">.</span>0<span
class="p">)</span>
+ 11<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">Region</span>
<span class="n">Digraph</span> <span class="p">(</span>1<span
class="p">.</span>1<span class="p">.</span>0<span class="p">.</span><span
class="n">v20120522</span><span class="o">-</span>1841<span class="p">)</span>
+ 12<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span
class="n">slf4j</span><span class="o">-</span><span class="n">api</span> <span
class="p">(</span>1<span class="p">.</span>7<span class="p">.</span>12<span
class="p">)</span>
+ 13<span class="o">|</span><span class="n">Resolved</span> <span
class="o">|</span> 1<span class="o">|</span><span
class="n">slf4j</span><span class="o">-</span><span class="n">simple</span>
<span class="p">(</span>1<span class="p">.</span>7<span
class="p">.</span>12<span class="p">)</span>
+ 14<span class="o">|</span><span class="n">Active</span> <span
class="o">|</span> 1<span class="o">|</span><span class="n">org</span><span
class="p">.</span><span class="n">osgi</span><span class="p">.</span><span
class="n">service</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span
class="n">region</span><span class="p">.</span><span
class="n">context</span><span class="p">.</span>0 <span
class="p">(</span>1<span class="p">.</span>0<span class="p">.</span>0<span
class="p">)</span>
+</pre></div>
+
+
+<p>The slf4j-simple bundle is a fragment, so it can not be started.
+You can see that the Subsystems implementation operational as it created a
synthesized
+bundle (14) to represent the root context. The subsystems implementation
sometimes
+synthesizes a bundle to represent a subsystem. Whether or not this happens
depends on
+the isolation model of a subsystem.</p>
+<p>You can also see that the Subsystem service for the root subsystem has been
registered
+by looking at the services registered by the Subsystem Core bundle (6):</p>
+<div class="codehilite"><pre><span class="n">g</span>! <span
class="n">inspect</span> <span class="n">cap</span> <span
class="n">service</span> 6
+<span class="n">org</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span
class="n">aries</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span class="n">core</span>
<span class="p">[</span>6<span class="p">]</span> <span
class="n">provides</span><span class="p">:</span>
+<span class="o">---------------------------------------------</span>
+<span class="n">service</span><span class="p">;</span> <span
class="n">org</span><span class="p">.</span><span class="n">osgi</span><span
class="p">.</span><span class="n">service</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span
class="n">Subsystem</span><span class="p">,</span> <span
class="n">org</span><span class="p">.</span><span class="n">apache</span><span
class="p">.</span><span class="n">aries</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span
class="n">AriesSubsystem</span> <span class="n">with</span> <span
class="k">properties</span><span class="p">:</span>
+ <span class="n">org</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span
class="n">aries</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span
class="n">service</span><span class="p">.</span><span class="n">regions</span>
<span class="p">=</span> <span class="p">[</span><span
class="n">org</span><span class="p">.</span><span class="n">eclipse</span><span
class="p">.</span><span class="n">equinox</span><span class="p">.</span><span
class="n">region</span><span class="p">.</span><span
class="n">kernel</span><span class="p">]</span>
+ <span class="n">subsystem</span><span class="p">.</span><span
class="n">id</span> <span class="p">=</span> 0
+ <span class="n">subsystem</span><span class="p">.</span><span
class="n">state</span> <span class="p">=</span> <span class="n">ACTIVE</span>
+ <span class="n">subsystem</span><span class="p">.</span><span
class="n">symbolicName</span> <span class="p">=</span> <span
class="n">org</span><span class="p">.</span><span class="n">osgi</span><span
class="p">.</span><span class="n">service</span><span class="p">.</span><span
class="n">subsystem</span><span class="p">.</span><span class="n">root</span>
+ <span class="n">subsystem</span><span class="p">.</span><span
class="n">type</span> <span class="p">=</span> <span class="n">osgi</span><span
class="p">.</span><span class="n">subsystem</span><span class="p">.</span><span
class="n">application</span>
+ <span class="n">subsystem</span><span class="p">.</span><span
class="n">version</span> <span class="p">=</span> 1<span
class="p">.</span>0<span class="p">.</span>0
+ <span class="p">...</span> <span class="n">other</span> <span
class="k">properties</span> <span class="n">and</span> <span
class="n">services</span>
+</pre></div>
+
+
+<p>Each installed subsystem is represented by a serparate service.</p>
+<h2 id="tools">Tools</h2>
+<ul>
+<li>Aries Gogo Command</li>
+<li>esa-ant-task</li>
+<li>eas-maven-plugin
+TODO elaborate</li>
+</ul>
+<h2 id="development">Development</h2>
+<p>The Aries Subsystems code base can be found at the following location: <a
href="https://svn.apache.org/repos/asf/aries/trunk/subsystem";>https://svn.apache.org/repos/asf/aries/trunk/subsystem</a></p></div>
<!-- Content -->
</td>
</tr>
