aries-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r945665 - in /websites/staging/aries/trunk/content: ./ modules/subsystems.html
Date Mon, 30 Mar 2015 15:09:50 GMT
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>



Mime
View raw message