You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by ge...@apache.org on 2012/09/21 21:46:06 UTC

svn commit: r1388647 [21/28] - in /servicemix/site/production/docs/4.4.x: ./ activemq/ architecture/ camel/ camel/deployment/ commands/ images/ jbi/ jbi/components/ jbi/intro/ karaf/ karaf/developers-guide/ karaf/users-guide/ nmr/ quickstart/ quickstar...

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/extending-console.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/extending-console.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/extending-console.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/extending-console.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,168 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h1 id="Extendingtheconsole">Extending the console</h1><p>This chapter will guide you through the steps needed to extend the console and create a new shell.  <br/>We will leverage Maven, Blueprint and OSGi, so you will need some knowledge of those products.</p><p>You may also find some information about the console at <a href="http://felix.apache.org/site/rfc-147-overview.html">http://felix.apache.org/site/rfc-147-overview.html</a>.</p><h2 id="Createtheprojectusingmaven">Create the project using maven</h2><p>We first need to create a project using Maven.  Let's leverage Maven archetypes for that.</p><h3 id="Commandline">Command line</h3><p>Using the command line, we can create our project:</p><pre>
+mvn archetype:create \
+  -DarchetypeArtifactId=maven-archetype-quickstart \
+  -DgroupId=org.apache.karaf.shell.samples \
+  -DartifactId=shell-sample-commands \
+  -Dversion=1.0-SNAPSHOT
+</pre><p>This generate the main <tt>pom.xml</tt> and some additional packages.</p><h3 id="Interactiveshell">Interactive shell</h3><p>You can also use the interactive mode for creating the skeleton project:</p><pre>
+mvn archetype:generate
+</pre><p>Use the following values when prompted:</p><pre>
+Choose a number:  (1/2/3/4/5/6/7/.../32/33/34/35/36) 15: : 15
+Define value for groupId: : org.apache.karaf.shell.samples
+Define value for artifactId: : shell-sample-commands
+Define value for version:  1.0-SNAPSHOT: : 
+Define value for package: : org.apache.karaf.shell.samples
+</pre><h3 id="Manualcreation">Manual creation</h3><p>Alternatively, you can simply create the directory <tt>shell-sample-commands</tt> and create the <tt>pom.xml</tt> file inside it:</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project</span> <span class="na">xmlns=</span><span class="s">&quot;http://maven.apache.org/POM/4.0.0&quot;</span> <span class="na">xmlns:xsi=</span><span class="s">&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span> <span class="na">xsi:schemaLocation=</span><span class="s">&quot;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd&quot;</span><span class="nt">&gt;</span>&#x000A;&#x000A;  <span class="nt">&lt;modelVersion&gt;</span>4.0.0<span class="nt">&lt;/modelVersion&gt;</span>&#x000A;&#x000A;  <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.shell.samples<span class="nt">&lt;/groupId&gt;</span>&#x000A;  <span class="nt">&lt;artifactId&gt;</span>shell-sample-commands<span class="nt">
 &lt;artifactId&gt;</span>&#x000A;  <span class="nt">&lt;packaging&gt;</span>bundle<span class="nt">&lt;/packaging&gt;</span>&#x000A;  <span class="nt">&lt;version&gt;</span>1.0-SNAPSHOT<span class="nt">&lt;/version&gt;</span>&#x000A;  <span class="nt">&lt;name&gt;</span>shell-sample-commmands<span class="nt">&lt;/name&gt;</span>&#x000A;&#x000A;&#x000A;  <span class="nt">&lt;dependencies&gt;</span>&#x000A;    <span class="nt">&lt;dependency&gt;</span>&#x000A;      <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.shell<span class="nt">&lt;/groupId&gt;</span>&#x000A;      <span class="nt">&lt;artifactId&gt;</span>org.apache.karaf.shell.console<span class="nt">&lt;/artifactId&gt;</span>&#x000A;      <span class="nt">&lt;version&gt;</span>2.2.4<span class="nt">&lt;/version&gt;</span>&#x000A;    <span class="nt">&lt;/dependency&gt;</span>&#x000A;    <span class="nt">&lt;dependency&gt;</span>&#x000A;      <span class="nt">&lt;groupId&gt;</span>junit<span class="nt">&lt;/grou
 pId&gt;</span>&#x000A;      <span class="nt">&lt;artifactId&gt;</span>junit<span class="nt">&lt;/artifactId&gt;</span>&#x000A;      <span class="nt">&lt;version&gt;</span>3.8.1<span class="nt">&lt;/version&gt;</span>&#x000A;      <span class="nt">&lt;scope&gt;</span>test<span class="nt">&lt;/scope&gt;</span>&#x000A;    <span class="nt">&lt;/dependency&gt;</span>&#x000A;  <span class="nt">&lt;/dependencies&gt;</span>&#x000A;&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.felix<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>maven-bundle-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.3.4<span class="nt">&lt;/version&gt;</span>&#x000A;        <span class="nt">&lt;configuration&gt;</span>&#x000A;          <s
 pan class="nt">&lt;instructions&gt;</span>&#x000A;            <span class="nt">&lt;Import-Package&gt;</span>&#x000A;              org.apache.felix.service.command,&#x000A;              org.apache.felix.gogo.commands,&#x000A;              org.apache.karaf.shell.console,&#x000A;              *&#x000A;            <span class="nt">&lt;/Import-Package&gt;</span>&#x000A;          <span class="nt">&lt;/instructions&gt;</span>&#x000A;        <span class="nt">&lt;/configuration&gt;</span>&#x000A;      <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>&#x000A;&#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h2 id="ConfiguringforJava5">Configuring for Java 5</h2><p>We are using annotations to define commands, so we need to ensure Maven will actually use JDK 1.5 to compile the jar.<br/>Just add the following snippet after the <tt>dependencies</tt> section.</p><div c
 lass="syntax"><div class="highlight"><pre><span class="nt">&lt;build&gt;</span>&#x000A;  <span class="nt">&lt;plugins&gt;</span>&#x000A;    <span class="nt">&lt;plugin&gt;</span>&#x000A;      <span class="nt">&lt;groupId&gt;</span>org.apache.maven.plugins<span class="nt">&lt;/groupId&gt;</span>&#x000A;      <span class="nt">&lt;artifactId&gt;</span>maven-compiler-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;      <span class="nt">&lt;configuration&gt;</span>&#x000A;        <span class="nt">&lt;target&gt;</span>1.5<span class="nt">&lt;/target&gt;</span>&#x000A;        <span class="nt">&lt;source&gt;</span>1.5<span class="nt">&lt;/source&gt;</span>&#x000A;      <span class="nt">&lt;/configuration&gt;</span>&#x000A;    <span class="nt">&lt;/plugin&gt;</span>&#x000A;  <span class="nt">&lt;/plugins&gt;</span>&#x000A;<span class="nt">&lt;/build&gt;</span>&#x000A;</pre></div>&#x000A;</div><h2 id="LoadingtheprojectinyourIDE">Loading the project in your IDE</h2><p>We can 
 use Maven to generate the needed files for your IDE:</p><p>Inside the project, run the following command</p><pre>
+mvn eclipse:eclipse
+</pre><p>or</p><pre>
+mvn idea:idea
+</pre><p>The project files for your IDE should now be created.  Just open the IDE and load the project.</p><h2 id="Creatingabasiccommandclass">Creating a basic command class</h2><p>We can now create the command class <tt>HelloShellCommand.java</tt></p><div class="syntax"><div class="highlight"><pre><span class="kn">package</span> <span class="n">org</span><span class="o">.</span><span class="na">apache</span><span class="o">.</span><span class="na">karaf</span><span class="o">.</span><span class="na">shell</span><span class="o">.</span><span class="na">samples</span><span class="o">;</span>&#x000A;&#x000A;<span class="kn">import</span> <span class="nn">org.apache.felix.gogo.commands.Command</span><span class="o">;</span>&#x000A;<span class="kn">import</span> <span class="nn">org.apache.karaf.shell.console.OsgiCommandSupport</span><span class="o">;</span>&#x000A;&#x000A;<span class="nd">@Command</span><span class="o">(</span><span class="n">scope</span> <span class="o">=</spa
 n> <span class="s">&quot;test&quot;</span><span class="o">,</span> <span class="n">name</span> <span class="o">=</span> <span class="s">&quot;hello&quot;</span><span class="o">,</span> <span class="n">description</span><span class="o">=</span><span class="s">&quot;Says hello&quot;</span><span class="o">)</span>&#x000A;<span class="kd">public</span> <span class="kd">class</span> <span class="nc">HelloShellCommand</span> <span class="kd">extends</span> <span class="n">OsgiCommandSupport</span> <span class="o">{</span>&#x000A;&#x000A;    <span class="nd">@Override</span>&#x000A;    <span class="kd">protected</span> <span class="n">Object</span> <span class="nf">doExecute</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>&#x000A;        <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">&
 quot;Executing Hello command&quot;</span><span class="o">);</span>&#x000A;        <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>&#x000A;    <span class="o">}</span>&#x000A;<span class="o">}</span>&#x000A;</pre></div>&#x000A;</div><h2 id="Creatingtheassociatedblueprintconfigurationfiles">Creating the associated blueprint configuration files</h2><p>The blueprint configuration file will be used to create the command and register it in the OSGi registry, which is the way to make the command available to Karaf console.  This blueprint file must be located in the <tt>OSGI-INF/blueprint/</tt> directory inside the bundle.</p><p>If you don't have the <tt>src/main/resources</tt> directory yet, create it.</p><pre>
+mkdir src/main/resources
+</pre><p>Then, re-generate the IDE project files and reload it so that this folder is now recognized as a source folder.</p><p>Inside this directory, create the <tt>OSGI-INF/blueprint/</tt> directory and put the following file inside (the name of this file has no impact at all):</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;blueprint</span> <span class="na">xmlns=</span><span class="s">&quot;http://www.osgi.org/xmlns/blueprint/v1.0.0&quot;</span><span class="nt">&gt;</span>&#x000A;&#x000A;    <span class="nt">&lt;command-bundle</span> <span class="na">xmlns=</span><span class="s">&quot;http://karaf.apache.org/xmlns/shell/v1.0.0&quot;</span><span class="nt">&gt;</span>&#x000A;        <span class="nt">&lt;command</span> <span class="na">name=</span><span class="s">&quot;test/hello&quot;</span><span class="nt">&gt;</span>&#x000A;            <span class="nt">&lt;action</span> <span class="na">class=</span><span class="s">&quot;org.apache.karaf.shell.sam
 ples.HelloShellCommand&quot;</span><span class="nt">/&gt;</span>&#x000A;        <span class="nt">&lt;/command&gt;</span>&#x000A;    <span class="nt">&lt;/command-bundle&gt;</span>&#x000A;&#x000A;<span class="nt">&lt;/blueprint&gt;</span>&#x000A;</pre></div>&#x000A;</div><h2 id="Compilingthejar">Compiling the jar</h2><p>Let's try to build the jar.  Remove the test classes and sample classes if you used the artifact, then from the command line, run:</p><pre>
+mvn install
+</pre><p>The end of the maven output should look like:</p><pre>
+[INFO] ------------------------------------------------------------------------
+[INFO] BUILD SUCCESSFUL
+[INFO] ------------------------------------------------------------------------
+</pre><h2 id="TestinKaraf">Test in Karaf</h2><p>Launch a Karaf instance and run the following command to install the newly created bundle:</p><pre>
+karaf@root> osgi:install -s mvn:org.apache.karaf.shell.samples/shell-sample-commands/1.0-SNAPSHOT
+</pre><p>Let's try running the command:</p><pre>
+karaf@root> test:hello
+Executing Hello command
+</pre><h1 id="Commandcompleter">Command completer</h1><p>A completer allows you to automatically complete a command argument using &lt;tab>. A completer is simply a bean which is injected to a command.</p><p>Of course to be able to complete it, the command should require an argument.</p><h2 id="Commandargument">Command argument</h2><p>We add an argument to the HelloCommand:</p><pre>
+package org.apache.karaf.shell.samples;
+
+import org.apache.felix.gogo.commands.Command;
+import org.apache.felix.gogo.commands.Argument;
+import org.apache.karaf.shell.console.OsgiCommandSupport;
+
+@Command(scope = "test", name = "hello", description="Says hello")
+public class HelloShellCommand extends OsgiCommandSupport {
+
+    @Argument(index = 0, name = "arg", description = "The command argument", required = false, multiValued = false)
+    String arg = null;
+
+    @Override
+    protected Object doExecute() throws Exception {
+        System.out.println("Executing Hello command");
+        return null;
+    }
+}
+</pre><p>The Blueprint configuration file is the same as previously.</p><h2 id="Completerbean">Completer bean</h2><p>A completer is a bean which implements the Completer interface:</p><pre>
+package org.apache.karaf.shell.samples;
+
+import org.apache.karaf.shell.console.completer.StringsCompleter;
+import org.apache.karaf.shell.console.Completer;
+
+/**
+ * &lt;p>
+ * A very simple completer.
+ * &lt;/p>
+ */
+public class SimpleCompleter implements Completer {
+
+ /**
+  * @param buffer the beginning string typed by the user
+  * @param cursor the position of the cursor
+  * @param candidates the list of completions proposed to the user
+  */
+ public int complete(String buffer, int cursor, List candidates) {
+    StringsCompleter delegate = new StringsCompleter();
+    delegate.getStrings().add("one");
+    delegate.getStrings().add("two");
+    delegate.getStrings().add("three");
+    return delegate.complete(buffer, cursor, candidates);
+ }
+
+}
+</pre><h2 id="Blueprintconfigurationfile">Blueprint configuration file</h2><p>Using Blueprint, you can "inject" the completer linked to your command. The same completer could be used for several commands and a command can have several completers:</p><pre>
+&lt;blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
+
+    &lt;command-bundle xmlns="http://karaf.apache.org/xmlns/shell/v1.0.0">
+        &lt;command name="test/hello">
+            &lt;action class="org.apache.karaf.shell.samples.HelloShellCommand"/>
+        &lt;/command>
+        &lt;completers>
+          &lt;ref component-id="simpleCompleter"/>
+          &lt;null/>
+        &lt;/completers>
+    &lt;/command-bundle>
+
+    &lt;bean id="simpleCompleter" class="org.apache.karaf.shell.samples.SimpleCompleter"/>
+
+&lt;/blueprint>
+</pre><h2 id="TestinKaraf2">Test in Karaf</h2><p>Launch a Karaf instance and run the following command to install the newly created bundle:</p><pre>
+karaf@root> osgi:install -s mvn:org.apache.karaf.shell.samples/shell-sample-commands/1.0-SNAPSHOT
+</pre><p>Let's try running the command:</p><pre>
+karaf@root> test:hello &lt;tab>
+ one    two    three
+</pre>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-add.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-add.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-add.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-add.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h2 id="Goalfeaturesaddfeaturestorepo">Goal <tt>features:add-features-to-repo</tt></h2><p>The <tt>features:add-features-to-repo</tt> goal adds all the required bundles for a given set of features into directory.  You can use this goal to create a <tt>/system</tt> directory for building your own Karaf-based distribution.</p><p>By default, the Karaf core features descriptors (standard and enterprise) are automatically included in the descriptors set.</p><h3 id="Example">Example</h3><p>The example below copies the bundles for the <tt>spring</tt> and <tt>war</tt> features defined in the Karaf features XML descriptor into the <tt>target/features-repo</tt> directory.</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.k
 araf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.2.4<span class="nt">&lt;/version&gt;</span>&#x000A;&#x000A;        <span class="nt">&lt;executions&gt;</span>&#x000A;          <span class="nt">&lt;execution&gt;</span>&#x000A;            <span class="nt">&lt;id&gt;</span>add-features-to-repo<span class="nt">&lt;/id&gt;</span>&#x000A;            <span class="nt">&lt;phase&gt;</span>generate-resources<span class="nt">&lt;/phase&gt;</span>&#x000A;            <span class="nt">&lt;goals&gt;</span>&#x000A;              <span class="nt">&lt;goal&gt;</span>add-features-to-repo<span class="nt">&lt;/goal&gt;</span>&#x000A;            <span class="nt">&lt;/goals&gt;</span>&#x000A;            <span class="nt">&lt;configuration&gt;</span>&#x000A;              <span class="nt">&lt;descriptors&gt;</span>&#x000A;
                 <span class="nt">&lt;descriptor&gt;</span>mvn:my.groupid/my.artifactid/1.0.0/xml/features<span class="nt">&lt;/descriptor&gt;</span>&#x000A;              <span class="nt">&lt;/descriptors&gt;</span>&#x000A;              <span class="nt">&lt;features&gt;</span>&#x000A;                <span class="nt">&lt;feature&gt;</span>spring<span class="nt">&lt;/feature&gt;</span>&#x000A;                <span class="nt">&lt;feature&gt;</span>war<span class="nt">&lt;/feature&gt;</span>&#x000A;                <span class="nt">&lt;feature&gt;</span>my<span class="nt">&lt;/feature&gt;</span>&#x000A;              <span class="nt">&lt;/features&gt;</span>&#x000A;              <span class="nt">&lt;repository&gt;</span>target/features-repo<span class="nt">&lt;/repository&gt;</span>&#x000A;            <span class="nt">&lt;/configuration&gt;</span>&#x000A;          <span class="nt">&lt;/execution&gt;</span>&#x000A;        <span class="nt">&lt;/executions&gt;</span>&#x000A;      <spa
 n class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>descriptors</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features XML descriptors where the features are defined <br/> NB: Karaf core features descriptors (standard and enterprise) are automatically added in this list </td></tr><tr><td class="confluenceTd"> <tt>features</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features that bundles should be copied to the repository directory </td></tr><tr><td class="confluenceTd"> <tt
 >repository</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the bundles will be copied by the plugin goal </td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Target Karaf version to use to resolve the Karaf core features descriptors (standard and enterprise) </td></tr></table></div>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-generate.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-generate.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-generate.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-generate.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h2 id="Goalfeaturesgenerate">Goal <tt>features:generate</tt></h2><p>The <tt>features:generate</tt> goal generates a features XML file for every bundle listed in the project's dependencies.  In order to satisfy the required imports in these bundles, the plugin will add bundles:</p><ul style="list-style: square"><li>bundles provided by Apache Karaf</li><li>a explicit list of bundles</li><li>bundles discovered in the POM's transitive dependencies</li></ul><p>Afterwards, the generated file will be attached to the build as an additional build artifact (by default as <tt>group:artifact:version:xml:features</tt>).</p><h3 id="Example">Example</h3><p>The example below generates one feature that installs bundle <tt>mvn:org.apache:bundle1:1.0</tt> in a features XML file called <tt>target/features.xml</tt>.  It will find bundle in Apache Karaf 2.2.4, the transitive dependencies for this POM and the bundles listed in <tt>src/main/resources/bundles.properties</tt>. </p><div c
 lass="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;dependencies&gt;</span>&#x000A;    <span class="nt">&lt;dependency&gt;</span>&#x000A;      <span class="nt">&lt;groupId&gt;</span>org.apache<span class="nt">&lt;/groupId&gt;</span>&#x000A;      <span class="nt">&lt;artifactId&gt;</span>bundle1<span class="nt">&lt;/artifactId&gt;</span>&#x000A;      <span class="nt">&lt;version&gt;</span>1.0<span class="nt">&lt;/version&gt;</span>&#x000A;    <span class="nt">&lt;/dependency&gt;</span>&#x000A;  <span class="nt">&lt;/dependencies&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;<
 /span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.2.4<span class="nt">&lt;/version&gt;</span>&#x000A;          <span class="nt">&lt;executions&gt;</span>&#x000A;            <span class="nt">&lt;execution&gt;</span>&#x000A;              <span class="nt">&lt;id&gt;</span>generate<span class="nt">&lt;/id&gt;</span>&#x000A;              <span class="nt">&lt;phase&gt;</span>generate-resources<span class="nt">&lt;/phase&gt;</span>&#x000A;              <span class="nt">&lt;goals&gt;</span>&#x000A;                <span class="nt">&lt;goal&gt;</span>generate<span class="nt">&lt;/goal&gt;</span>&#x000A;              <span class="nt">&lt;/goals&gt;</span>&#x000A;              <span class="nt">&lt;configuration&gt;</span>&#x000A;                <span class="nt">&lt;bundles&gt;</span>src/main/resources/bundles.properties<span class="nt">&lt;/bundles&gt;</span>&#x000A;                <span class="nt">&lt;kernelVersion&gt;</span>2.2.4<span class="nt">&lt;/kernelVersion&gt;</sp
 an>&#x000A;                <span class="nt">&lt;outputFile&gt;</span>target/features.xml<span class="nt">&lt;/outputFile&gt;</span>&#x000A;              <span class="nt">&lt;/configuration&gt;</span>&#x000A;            <span class="nt">&lt;/execution&gt;</span>&#x000A;          <span class="nt">&lt;/executions&gt;</span>&#x000A;        <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>outputFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Name of the features XML file that is being generated <br/> Default value: <tt>/x1/asf/k
 araf-2.2.x/target/checkout/manual/target/classes/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactType</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact type for attaching the generated file to the project <br/> Default value: {{xml}) </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactClassifier</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact classifier for attaching the generated file to the project <br/> Default value: <tt>features</tt> </td></tr><tr><td class="confluenceTd"> <tt>kernelVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The version of Karaf that is used to determine system bundles and default provided features </td></tr><tr><td class="confluenceTd"> <tt>bundles</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> A properties file that contains a list of bun
 dles that will be used to generate the features.xml file </td></tr></table></div>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-validate.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-validate.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-validate.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin-validate.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h2 id="Goalfeaturesvalidate">Goal <tt>features:validate</tt></h2><p>The <tt>features:validate</tt> goal validates a features XML descriptor by checking if all the required imports for the bundles defined in the features can be matched to a provided export.</p><p>By default, the plugin tries to add the Karaf standard features (standard and enterprise) in the repositories set.<br/>It means that it's not necessary to explicitly define the Karaf features descriptor in the repository section of your features descriptor.</p><h3 id="Example">Example</h3><p>The example below validates the features defined in the <tt>target/features.xml</tt> by checking all the imports and exports.  It reads the definition for the packages that are exported by the system bundle from the <tt>src/main/resources/config.properties</tt> file.</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <sp
 an class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.2.4<span class="nt">&lt;/version&gt;</span>&#x000A;          <span class="nt">&lt;executions&gt;</span>&#x000A;            <span class="nt">&lt;execution&gt;</span>&#x000A;              <span class="nt">&lt;id&gt;</span>validate<span class="nt">&lt;/id&gt;</span>&#x000A;              <span class="nt">&lt;phase&gt;</span>process-resources<span class="nt">&lt;/phase&gt;</span>&#x000A;              <span class="nt">&lt;goals&gt;</span>&#x000A;                <span class="nt">&lt;goal&gt;</span>validate<span class="nt">&lt;/goal&gt;</span>&#x000A;              <span class="nt">&lt;/goals&gt;</span>&#
 x000A;              <span class="nt">&lt;configuration&gt;</span>&#x000A;                <span class="nt">&lt;file&gt;</span>target/features.xml<span class="nt">&lt;/file&gt;</span>&#x000A;                <span class="nt">&lt;karafConfig&gt;</span>src/main/resources/config.properties<span class="nt">&lt;/karafConfig&gt;</span>&#x000A;              <span class="nt">&lt;/configuration&gt;</span>&#x000A;            <span class="nt">&lt;/execution&gt;</span>&#x000A;          <span class="nt">&lt;/executions&gt;</span>&#x000A;          <span class="nt">&lt;dependencies&gt;</span>&#x000A;            <span class="nt">&lt;dependency&gt;</span>&#x000A;              <span class="nt">&lt;groupId&gt;</span>org.slf4j<span class="nt">&lt;/groupId&gt;</span>&#x000A;              <span class="nt">&lt;artifactId&gt;</span>slf4j-simple<span class="nt">&lt;/artifactId&gt;</span>&#x000A;              <span class="nt">&lt;version&gt;</span>1.4.3<span class="nt">&lt;/version&gt;</span>&#x000A;	  
       <span class="nt">&lt;/dependency&gt;</span>&#x000A;          <span class="nt">&lt;/dependencies&gt;</span>&#x000A;        <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>file</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML descriptor file to validate. <br/> Default value: <tt>/x1/asf/karaf-2.2.x/target/checkout/manual/target/classes/features.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>karafConfig</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The Karaf <tt>conf
 ig.properties</tt> file to use during the validation process <br/> Default value: <tt>config.properties</tt> </td></tr><tr><td class="confluenceTd"> <tt>jreVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The JRE version that is used during the validation process <br/> Default value: {{jre-1.5}) </td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The target Karaf version used to get the Karaf core features (standard and enterprise) <br/> Default value is the version of the plugin </td></tr><tr><td class="confluenceTd"> <tt>repositories</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> Additional features XML descriptors that will be used during the validation process </td></tr></table></div>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/features-maven-plugin.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h1 id="Usingthefeaturesmavenplugin">Using the features-maven-plugin</h1><p>The <tt>features-maven-plugin</tt> provides several goals to help you create and validate features XML descriptors as well as leverage your features to create a custom Karaf distribution.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Goal </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-add.html">features:add-features-to-repo</a></tt> </td><td class="confluenceTd"> Copies all the bundles required for a given set of features into a directory <br/> (e.g. for creating your own Karaf-based distribution) </td></tr><tr><td class="confluenceTd"> <tt>features:generate-features-file</tt> </td><td class="confluenceTd"> Deprecated - use <tt><a href="features-maven-plugin-generate.html">features:generate-features-xml</a></tt> instead </td></tr><tr><td class="confluenceTd"> <tt><a href="featu
 res-maven-plugin-generate.html">features:generate-features-xml</a></tt> </td><td class="confluenceTd"> Generates a features XML descriptor for a set of bundles </td></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-validate.html">features:validate</a></tt> </td><td class="confluenceTd"> Validate a features XML descriptor by checking if all the required imports can be matched to exports </td></tr></table></div><h2 id="Configurethefeaturesmavenplugin">Configure the features-maven-plugin</h2><p>In order to use the <tt>features-maven-plugin</tt>, you have to define the plugin in your project's <tt>pom.xml</tt> file:</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&
 gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.2.4<span class="nt">&lt;/version&gt;</span>&#x000A;&#x000A;        <span class="nt">&lt;executions&gt;</span>&#x000A;          <span class="c">&lt;!-- add execution definitions here --&gt;</span>&#x000A;        <span class="nt">&lt;/executions&gt;</span>&#x000A;      <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/index.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/index.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/index.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h1 id="DevelopersGuide">Developers Guide</h1><ul><li><a href="branding-console.html">Branding the Console</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="features-maven-plugin.html">Using the features-maven-plugin</a></li><li><a href="debugging.html">Troubleshooting, Debugging, Profiling, and Monitoring</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li></ul>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/shell-syntax.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/shell-syntax.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/shell-syntax.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/shell-syntax.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,149 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h1 id="Shellsyntax">Shell syntax</h1><h2 id="Easytouseinteractivelynounnecessarysyntax">Easy to use interactively - no unnecessary syntax</h2><pre>
+// simple command
+karaf@root> echo hello world
+hello world
+
+// session variables
+karaf@root> msg = "hello world"
+hello world
+karaf@root> echo $msg
+hello world
+
+// execution quotes () - similar to bash backquotes
+karaf@root> (bundle 1) location
+mvn:org.ops4j.pax.url/pax-url-mvn/1.1.3
+</pre><h2 id="Listmapspipesandclosures">List, maps, pipes and closures</h2><pre>
+// lists - []
+karaf@root> list = [1 2 a b]
+1
+2
+a
+b
+
+karaf@root> map = [Jan=1 Feb=2 Mar=3]
+Jan                 1
+Feb                 2
+Mar                 3
+
+// pipes
+karaf@root> bundles | grep felix
+000000 ACT org.apache.felix.framework-3.0.2
+000005 ACT org.apache.felix.configadmin-1.2.4
+000006 ACT org.apache.felix.fileinstall-3.0.2
+
+// closures - {}
+karaf@root> echo2 = { echo xxx $args yyy }
+org.apache.felix.gogo.runtime.shell.Closure@2ffb36c2
+karaf@root> echo2 hello world
+xxx hello world yyy
+</pre><h2 id="LeveragesexistingJavacapabilitiesviareflection">Leverages existing Java capabilities, via reflection</h2><pre>
+// exception handling - console shows summary, but full context available
+karaf@root> start xxx
+Error executing command osgi:start: unable to convert argument ids with value '[xxx]' to type java.util.List&lt;java.lang.Long>
+karaf@root> $karaf.lastException printStackTrace
+org.apache.felix.gogo.commands.CommandException: Unable to convert argument ids with value '[xxx]' to type java.util.List&lt;java.lang.Long>
+	at org.apache.felix.gogo.commands.basic.DefaultActionPreparator.prepare(DefaultActionPreparator.java:347)
+	at org.apache.felix.gogo.commands.basic.AbstractCommand.execute(AbstractCommand.java:34)
+	at org.apache.felix.gogo.runtime.shell.CommandProxy.execute(CommandProxy.java:50)
+	at org.apache.felix.gogo.runtime.shell.Closure.execute(Closure.java:229)
+	at org.apache.felix.gogo.runtime.shell.Closure.executeStatement(Closure.java:162)
+	at org.apache.felix.gogo.runtime.shell.Pipe.run(Pipe.java:101)
+	at org.apache.felix.gogo.runtime.shell.Closure.execute(Closure.java:79)
+	at org.apache.felix.gogo.runtime.shell.CommandSessionImpl.execute(CommandSessionImpl.java:71)
+	at org.apache.karaf.shell.console.jline.Console.run(Console.java:169)
+	at java.lang.Thread.run(Thread.java:637)
+Caused by: java.lang.Exception: Unable to convert from [xxx] to java.util.List&lt;java.lang.Long>(error converting collection entry)
+	at org.apache.aries.blueprint.container.AggregateConverter.convertToCollection(AggregateConverter.java:318)
+	at org.apache.aries.blueprint.container.AggregateConverter.convert(AggregateConverter.java:159)
+	at org.apache.karaf.shell.console.commands.BlueprintCommand$BlueprintActionPreparator.convert(BlueprintCommand.java:73)
+	at org.apache.felix.gogo.commands.basic.DefaultActionPreparator.prepare(DefaultActionPreparator.java:344)
+	... 9 more
+Caused by: java.lang.NumberFormatException: For input string: "xxx"
+	at java.lang.NumberFormatException.forInputString(NumberFormatException.java:48)
+	at java.lang.Long.parseLong(Long.java:410)
+	at java.lang.Long.valueOf(Long.java:525)
+	at org.apache.aries.blueprint.container.AggregateConverter.convertFromString(AggregateConverter.java:261)
+	at org.apache.aries.blueprint.container.AggregateConverter.convert(AggregateConverter.java:151)
+	at org.apache.aries.blueprint.container.AggregateConverter.convertToCollection(AggregateConverter.java:316)
+	... 12 more
+
+// add all public methods on java.lang.System as commands:
+karaf@root> addcommand system (loadClass java.lang.System)
+karaf@root> system:getproperty karaf.name
+root
+
+// create new objects
+karaf@root> map = (new java.util.HashMap)
+karaf@root> $map put 0 0
+karaf@root> $map
+0                   0
+</pre>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/writing-tests.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/writing-tests.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/writing-tests.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/writing-tests.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,70 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../../images/logodesign.png" height="80"/><img border="0" height="80" src="../../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <h1 id="Writingintegrationtests">Writing integration tests</h1><p>We recommend using <a href="http://team.ops4j.org/wiki/display/paxexam/Pax+Exam">PAX Exam</a> to write integration tests when developing<br/>applications using Karaf.</p><p>Karaf provides an helper library to help writing such integration tests.</p><div class="syntax"><div class="highlight"><pre>   <span class="nd">@Configuration</span>&#x000A;   <span class="kd">public</span> <span class="kd">static</span> <span class="n">Option</span><span class="o">[]</span> <span class="nf">configuration</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span><span class="o">{</span>&#x000A;       <span class="k">return</span> <span class="nf">combine</span><span class="o">(</span>&#x000A;           <span class="c1">// Default karaf environment</span>&#x000A;           <span class="n">Helper</span><span class="o">.</span><span class="na">getDefaultOptions</span><span class
 ="o">(),</span>&#x000A;           <span class="c1">// Test on both equinox and felix</span>&#x000A;           <span class="n">equinox</span><span class="o">(),</span> <span class="n">felix</span><span class="o">()</span>&#x000A;       <span class="o">);</span>&#x000A;   <span class="o">}</span>&#x000A;</pre></div>&#x000A;</div><p>If you need to provision a few features in addition to the default Karaf environment, you can do so by adding the following code:</p><div class="syntax"><div class="highlight"><pre>           <span class="n">scanFeatures</span><span class="o">(</span>&#x000A;                  <span class="n">maven</span><span class="o">().</span><span class="na">groupId</span><span class="o">(</span><span class="s">&quot;org.apache.felix.karaf&quot;</span><span class="o">)</span>&#x000A;                         <span class="o">.</span><span class="na">artifactId</span><span class="o">(</span><span class="s">&quot;apache-felix-karaf&quot;</span><span class="o">)</spa
 n>&#x000A;                         <span class="o">.</span><span class="na">type</span><span class="o">(</span><span class="s">&quot;xml&quot;</span><span class="o">).</span><span class="na">classifier</span><span class="o">(</span><span class="s">&quot;features&quot;</span><span class="o">)</span>&#x000A;                         <span class="o">.</span><span class="na">versionAsInProject</span><span class="o">(),</span>&#x000A;                  <span class="s">&quot;obr&quot;</span><span class="o">,</span> <span class="s">&quot;wrapper&quot;</span>&#x000A;           <span class="o">),</span>&#x000A;</pre></div>&#x000A;</div>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/index.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/index.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/index.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,156 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../images/logodesign.png" height="80"/><img border="0" height="80" src="../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <ul>
+  <li id="karaf-users-guide">
+    <a href="#">User's Guide</a>
+    <ul>
+      <li id="karaf-installation">
+        <a href="users-guide/installation.html">Installation</a>
+      </li>
+      <li id="karaf-directory-structure">
+        <a href="users-guide/directory-structure.html">Directory structure</a>
+      </li>
+      <li id="karaf-starting-and-stopping">
+        <a href="users-guide/start-stop.html">Starting and stopping Karaf</a>
+      </li>
+      <li id="using-console">
+        <a href="users-guide/using-console.html">Using the console</a>
+      </li>
+      <li id="web-console">
+        <a href="users-guide/web-console.html">Web console</a>
+      </li>
+      <li id="remote-console">
+        <a href="users-guide/remote-console.html">Remote console</a>
+      </li>
+      <li id="child-instances">
+        <a href="users-guide/child-instances.html">Child instances</a>
+      </li>
+      <li id="security">
+        <a href="users-guide/security.html">Security</a>
+      </li>
+      <li id="failover">
+        <a href="users-guide/failover.html">Failover deployments</a>
+      </li>
+      <li id="logging-system">
+        <a href="users-guide/logging-system.html">Logging system</a>
+      </li>
+      <li id="installing-features">
+        <a href="users-guide/installing-features.html">Installing additional features</a>
+      </li>
+      <li id="deployer">
+        <a href="users-guide/deployer.html">Deployer</a>
+      </li>
+      <li id="configuration">
+        <a href="users-guide/configuration.html">Configuration</a>
+      </li>
+      <li id="provisioning">
+        <a href="users-guide/provisioning.html">Provisioning</a>
+      </li>
+    </ul>
+  </li>
+  <li id="karaf-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="developers-guide/extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="developers-guide/writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="developers-guide/debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="developers-guide/creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="developers-guide/connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="developers-guide/shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+        <div id="body">
+                    <h1 id="ServiceMix4.4.2Documentation">ServiceMix 4.4.2 Documentation</h1><p>ServiceMix 4.4.2 uses Apache Karaf.  </p>
+        </div>
+      
+          </div>
+    <div id="siteFooter">
+      &copy; 2008-2012 The Apache Software Foundation - <a href="http://servicemix.apache.org/site/privacy-policy.html">Privacy Policy</a>
+      <br/>
+      Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+    </div>
+  </div>
+</body>
+</html>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/toc.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/toc.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/toc.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/toc.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,228 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - </title>
+
+  <link href="../theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+  
+  <script type="text/javascript" src="../scripts/jquery.js"></script>
+  <script type="text/javascript" src="../scripts/jquery.cookie.js"></script>
+  <script type="text/javascript" src="../scripts/jquery.jstree.js"></script>
+
+  <script>
+    $(document).ready(function(){
+	  $("#nav").jstree({
+		"themes": {
+		  "theme": "apple", "dots": false
+		},
+		"plugins" : [ "themes", "html_data", "cookies", "themes" ]
+  	  });
+    });
+  </script>
+  <script type="text/javascript">
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-398545-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>
+</head>
+<body>
+  <div id="page">
+    <div id="siteHeader">
+      <table width="100%">
+      <tr valign="middle">
+        <td align="left">
+            <a href="http://servicemix.apache.org/" title="An open source ESB">
+            <img border="0" src="../images/logodesign.png" height="80"/><img border="0" height="80" src="../images/new-logo.png" />
+            </a>
+          </td>
+          <td align="right">
+            <a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+              <img border="0" height="60" src="../images/ASF-logo.png">
+            </a>
+            <ul class="siteNav">
+              <li><a href="../index.html" title="Overview">Guides Overview</a></li>
+              <li><a href="../contribute.html" title="Contributing?">Contributing?</a></li>
+              <li>
+                <form action="http://www.google.com/search" method="get" style="font-size: 10px;">
+                  <input name="ie" type="hidden" value="UTF-8"></input>
+                  <input name="oe" type="hidden" value="UTF-8"></input>
+                  <input maxlength="255" name="q" size="15" type="text" value=""></input>
+                  <input name="btnG" type="submit" value="Search"></input>
+                  <input name="domains" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                  <input name="sitesearch" type="hidden" value="servicemix.apache.org/docs/4.4.x"></input>
+                </form>
+              </li>
+            </ul>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="content">
+              <div id="nav">
+            <ul>
+  <li id="karaf-users-guide">
+    <a href="#">User's Guide</a>
+    <ul>
+      <li id="karaf-installation">
+        <a href="users-guide/installation.html">Installation</a>
+      </li>
+      <li id="karaf-directory-structure">
+        <a href="users-guide/directory-structure.html">Directory structure</a>
+      </li>
+      <li id="karaf-starting-and-stopping">
+        <a href="users-guide/start-stop.html">Starting and stopping Karaf</a>
+      </li>
+      <li id="using-console">
+        <a href="users-guide/using-console.html">Using the console</a>
+      </li>
+      <li id="web-console">
+        <a href="users-guide/web-console.html">Web console</a>
+      </li>
+      <li id="remote-console">
+        <a href="users-guide/remote-console.html">Remote console</a>
+      </li>
+      <li id="child-instances">
+        <a href="users-guide/child-instances.html">Child instances</a>
+      </li>
+      <li id="security">
+        <a href="users-guide/security.html">Security</a>
+      </li>
+      <li id="failover">
+        <a href="users-guide/failover.html">Failover deployments</a>
+      </li>
+      <li id="logging-system">
+        <a href="users-guide/logging-system.html">Logging system</a>
+      </li>
+      <li id="installing-features">
+        <a href="users-guide/installing-features.html">Installing additional features</a>
+      </li>
+      <li id="deployer">
+        <a href="users-guide/deployer.html">Deployer</a>
+      </li>
+      <li id="configuration">
+        <a href="users-guide/configuration.html">Configuration</a>
+      </li>
+      <li id="provisioning">
+        <a href="users-guide/provisioning.html">Provisioning</a>
+      </li>
+    </ul>
+  </li>
+  <li id="karaf-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="developers-guide/extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="developers-guide/writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="developers-guide/debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="developers-guide/creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="developers-guide/connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="developers-guide/shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+        <div id="body">
+                    <ul>
+  <li id="karaf-users-guide">
+    <a href="#">User's Guide</a>
+    <ul>
+      <li id="karaf-installation">
+        <a href="users-guide/installation.html">Installation</a>
+      </li>
+      <li id="karaf-directory-structure">
+        <a href="users-guide/directory-structure.html">Directory structure</a>
+      </li>
+      <li id="karaf-starting-and-stopping">
+        <a href="users-guide/start-stop.html">Starting and stopping Karaf</a>
+      </li>
+      <li id="using-console">
+        <a href="users-guide/using-console.html">Using the console</a>
+      </li>
+      <li id="web-console">
+        <a href="users-guide/web-console.html">Web console</a>
+      </li>
+      <li id="remote-console">
+        <a href="users-guide/remote-console.html">Remote console</a>
+      </li>
+      <li id="child-instances">
+        <a href="users-guide/child-instances.html">Child instances</a>
+      </li>
+      <li id="security">
+        <a href="users-guide/security.html">Security</a>
+      </li>
+      <li id="failover">
+        <a href="users-guide/failover.html">Failover deployments</a>
+      </li>
+      <li id="logging-system">
+        <a href="users-guide/logging-system.html">Logging system</a>
+      </li>
+      <li id="installing-features">
+        <a href="users-guide/installing-features.html">Installing additional features</a>
+      </li>
+      <li id="deployer">
+        <a href="users-guide/deployer.html">Deployer</a>
+      </li>
+      <li id="configuration">
+        <a href="users-guide/configuration.html">Configuration</a>
+      </li>
+      <li id="provisioning">
+        <a href="users-guide/provisioning.html">Provisioning</a>
+      </li>
+    </ul>
+  </li>
+  <li id="karaf-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="developers-guide/extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="developers-guide/writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="developers-guide/debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="developers-guide/creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="developers-guide/connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="developers-guide/shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+
+        </div>
+      
+          </div>
+    <div id="siteFooter">
+      &copy; 2008-2012 The Apache Software Foundation - <a href="http://servicemix.apache.org/site/privacy-policy.html">Privacy Policy</a>
+      <br/>
+      Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+    </div>
+  </div>
+</body>
+</html>
\ No newline at end of file