Author: buildbot
Date: Wed Mar 4 10:56:07 2015
New Revision: 942249
Log:
Staging update by buildbot for felix
Modified:
websites/staging/felix/trunk/content/ (props changed)
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Mar 4 10:56:07 2015
@@ -1 +1 @@
-1663926
+1663931
Modified:
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
==============================================================================
---
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
(original)
+++
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
Wed Mar 4 10:56:07 2015
@@ -71,22 +71,25 @@
<h1 id="introduction">Introduction</h1>
<p>The shell bundle for the dependency manager extends the gogo shell with one
new command called "dm". This command can be used to get insight in the actual
components and services in a running OSGi framework.</p>
<p>Typing help <code>help dm</code> in the gogo shell gives an overview of the
available command options.</p>
-<p><code>dm - List dependency manager components
- scope: dependencymanager
- flags:
- compact, cp Displays components using a compact form
- nodeps, nd Hides component dependencies
- notavail, na Only displays unavailable components
- stats, stat, st Displays components statistics
- wtf Detects where are the root failures
- options:
- bundleIds, bid, bi, b <List of bundle ids or bundle symbolic names
to display (comma separated)> [optional]
- componentIds, cid, ci <List of component identifiers to display
(comma separated)> [optional]
- components, c <Regex(s) used to filter on component implementation
class names (comma separated), can be negated using "!" prefix> [optional]
- services, s <OSGi filter used to filter some service properties>
[optional]
- top <Max number of top components to display (0=all)> This
command displays components callbacks (init/start) times> [optional]
- parameters:
- CommandSession</code></p>
+<div class="codehilite"><pre><span class="n">dm</span> <span
class="o">-</span> <span class="n">List</span> <span
class="n">dependency</span> <span class="n">manager</span> <span
class="n">components</span>
+ <span class="n">scope</span><span class="p">:</span> <span
class="n">dependencymanager</span>
+ <span class="n">flags</span><span class="p">:</span>
+ <span class="n">compact</span><span class="p">,</span> <span
class="n">cp</span> <span class="n">Displays</span> <span
class="n">components</span> <span class="n">using</span> <span
class="n">a</span> <span class="n">compact</span> <span class="n">form</span>
+ <span class="n">nodeps</span><span class="p">,</span> <span
class="n">nd</span> <span class="n">Hides</span> <span
class="n">component</span> <span class="n">dependencies</span>
+ <span class="n">notavail</span><span class="p">,</span> <span
class="n">na</span> <span class="n">Only</span> <span
class="n">displays</span> <span class="n">unavailable</span> <span
class="n">components</span>
+ <span class="n">stats</span><span class="p">,</span> <span
class="n">stat</span><span class="p">,</span> <span class="n">st</span> <span
class="n">Displays</span> <span class="n">components</span> <span
class="n">statistics</span>
+ <span class="n">wtf</span> <span class="n">Detects</span> <span
class="n">where</span> <span class="n">are</span> <span class="n">the</span>
<span class="n">root</span> <span class="n">failures</span>
+ <span class="n">options</span><span class="p">:</span>
+ <span class="n">bundleIds</span><span class="p">,</span> <span
class="n">bid</span><span class="p">,</span> <span class="n">bi</span><span
class="p">,</span> <span class="n">b</span> <span class="o"><</span><span
class="n">List</span> <span class="n">of</span> <span class="n">bundle</span>
<span class="n">ids</span> <span class="n">or</span> <span
class="n">bundle</span> <span class="n">symbolic</span> <span
class="n">names</span> <span class="n">to</span> <span class="n">display</span>
<span class="p">(</span><span class="n">comma</span> <span
class="n">separated</span><span class="p">)</span><span class="o">></span>
<span class="p">[</span><span class="n">optional</span><span class="p">]</span>
+ <span class="n">componentIds</span><span class="p">,</span> <span
class="n">cid</span><span class="p">,</span> <span class="n">ci</span> <span
class="o"><</span><span class="n">List</span> <span class="n">of</span>
<span class="n">component</span> <span class="n">identifiers</span> <span
class="n">to</span> <span class="n">display</span> <span
class="p">(</span><span class="n">comma</span> <span
class="n">separated</span><span class="p">)</span><span class="o">></span>
<span class="p">[</span><span class="n">optional</span><span class="p">]</span>
+ <span class="n">components</span><span class="p">,</span> <span
class="n">c</span> <span class="o"><</span><span
class="n">Regex</span><span class="p">(</span><span class="n">s</span><span
class="p">)</span> <span class="n">used</span> <span class="n">to</span> <span
class="n">filter</span> <span class="n">on</span> <span
class="n">component</span> <span class="n">implementation</span> <span
class="n">class</span> <span class="n">names</span> <span
class="p">(</span><span class="n">comma</span> <span
class="n">separated</span><span class="p">),</span> <span class="n">can</span>
<span class="n">be</span> <span class="n">negated</span> <span
class="n">using</span> "!" <span class="n">prefix</span><span
class="o">></span> <span class="p">[</span><span
class="n">optional</span><span class="p">]</span>
+ <span class="n">services</span><span class="p">,</span> <span
class="n">s</span> <span class="o"><</span><span class="n">OSGi</span>
<span class="n">filter</span> <span class="n">used</span> <span
class="n">to</span> <span class="n">filter</span> <span class="n">some</span>
<span class="n">service</span> <span class="k">properties</span><span
class="o">></span> <span class="p">[</span><span
class="n">optional</span><span class="p">]</span>
+ <span class="n">top</span> <span class="o"><</span><span
class="n">Max</span> <span class="n">number</span> <span class="n">of</span>
<span class="n">top</span> <span class="n">components</span> <span
class="n">to</span> <span class="n">display</span> <span
class="p">(</span>0<span class="p">=</span><span class="n">all</span><span
class="p">)</span><span class="o">></span> <span class="n">This</span> <span
class="n">command</span> <span class="n">displays</span> <span
class="n">components</span> <span class="n">callbacks</span> <span
class="p">(</span><span class="n">init</span><span class="o">/</span><span
class="n">start</span><span class="p">)</span> <span
class="n">times</span><span class="o">></span> <span class="p">[</span><span
class="n">optional</span><span class="p">]</span>
+ <span class="n">parameters</span><span class="p">:</span>
+ <span class="n">CommandSession</span>
+</pre></div>
+
+
<h1 id="usage-examples">Usage examples</h1>
<p>Below are some examples for typical usage of the dependency manager shell
commands. The examples are based on a simple component model with a dashboard
which has a required dependency on four probes (temperature, humidity,
radiation, pressure). The radiation probe requires a Sensor service but this
sensor is not available.</p>
<p><strong>List all dependency manager components</strong></p>
@@ -135,7 +138,7 @@ All components are listed including the
```</p>
<p>wtf gives the root cause for components not being registered and therefore
their services not being available. In a typical application components have
dependencies on services implemented by components that have dependencies on
services etcetera. This transitivity means that an entire chain of components
could be unregistered due to a (few) root dependencies not being satisified.
wtf is about discovering those dependencies.</p>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1663924 by marrs on Wed, 4 Mar 2015 10:39:19 +0000
+ Rev. 1663931 by marrs on Wed, 4 Mar 2015 10:55:52 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache
Felix project
