servicemix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ge...@apache.org
Subject svn commit: r1479164 [14/21] - in /servicemix/site/production/docs/5.0.x: ./ activemq/ activiti/ camel/ camel/deployment/ commands/ developers-guide/ images/ karaf/ quickstart/ quickstart/images/ scripts/ scripts/themes/ scripts/themes/apple/ scripts/t...
Date Sat, 04 May 2013 19:46:03 GMT
Added: servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin-validate.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin-validate.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin-validate.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin-validate.html Sat May  4 19:45:49 2013
@@ -0,0 +1,108 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <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
 ;    <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.3.0<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>&#x
 000A;	        <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.3.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>config.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>
+        </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/5.0.x/developers-guide/features-maven-plugin.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/features-maven-plugin.html Sat May  4 19:45:49 2013
@@ -0,0 +1,108 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <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 hre
 f="features-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><tr><td class="confluenceTd"> {{</td><td class="confluenceTd">features:create-kar</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.3.0<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>
+        </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/5.0.x/developers-guide/github-contributions.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/github-contributions.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/github-contributions.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/github-contributions.html Sat May  4 19:45:49 2013
@@ -0,0 +1,142 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <h1 id="GithubContributions">Github Contributions</h1><p>Some people prefer to make contributions to karaf source via github. If you are one of them, this is for you!</p><h2 id="Introduction">Introduction</h2><p>Apache Karaf is available as a periodically replicated mirror on: <a href="https://github.com/apache/karaf">https://github.com/apache/karaf</a> </p><h2 id="SuggestedWorkflow">Suggested Workflow</h2><ol><li><p>make a fork of karaf repo github mirror</p></li><li><p>do all your new work on your own karaf fork</p></li><li><p>when ready, file a jira issue <a href="https://issues.apache.org/jira/browse/KARAF">https://issues.apache.org/jira/browse/KARAF</a>, attach the link to your github pull request, and ask for a review</p></li><li><p>one of karaf committers will discuss your pull request on github; and at some point your pull request will be accepted </p></li><li><p>when your pull request is accepted, squash it into a single commit and attach single 
 patch file to the original jira, with ASF grant check box selected  </p></li><li><p>now pray to your favorite ASF committer to really accept the patch :-)</p></li><li><p>when your patch is committed to the svn, and you can verify it in the latest karaf snapshot, close your pull request on github </p></li></ol><h2 id="LicenseReminder">License Reminder</h2><p>in order for your contributions to be accepted:</p><ul><li><p>all files must contain ASL license grant header</p></li></ul><ul><li><p>you must select ASF grant check box when attaching patch to the jira</p></li></ul><h2 id="HowtoGenerateaOneFilePatchViaThrowAwayBranch">How to Generate a One-File-Patch Via Throw-Away Branch</h2><p>here is one way to generate squash of your commits:</p><p><a href="http://stackoverflow.com/questions/616556/how-do-you-squash-commits-into-one-patch-with-git-format-patch">http://stackoverflow.com/questions/616556/how-do-you-squash-commits-into-one-patch-with-git-format-patch</a></p><pre>
+
+#
+# 'archon' referers to karaf mirror
+# 'origin' referers to your own fork
+#
+
+# attach karaf mirror as remote, if not done yet
+git remote add archon https://github.com/apache/karaf
+
+# fetch latest karaf mirror
+git fetch archon 
+
+# ensure you are on your fork trunk
+git checkout origin/trunk
+
+# kill previous patch delivery, if you had one
+git branch -D delivery
+
+# make new delivery throw-away branch, based on latest karaf mirror
+git branch delivery archon/trunk
+
+# use it
+git checkout delivery
+
+# squash all your local development into a single commit
+git merge --squash trunk
+
+# commit it to the delivery branch
+git commit -m "delivery"
+
+# generate a patch file against the mirror
+git format-patch archon/trunk
+
+</pre><p>root of your karaf source now contains a file named "0001-delivery.patch.txt" (please attach the .txt ending;this will allow commiters to open your patch directly in the browser and give it a short look there) which you should attach to your karaf jira, and ask to commit to the svn trunk</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/5.0.x/developers-guide/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/index.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/index.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/index.html Sat May  4 19:45:49 2013
@@ -0,0 +1,108 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <h1 id="DevelopersGuide">Developers Guide</h1><ul><li><p><a href="archetypes.html">Maven Archetypes</a></p></li><li><p><a href="branding-console.html">Branding the Console</a></p></li><li><p><a href="extending-console.html">Extending the Console</a></p></li><li><p><a href="custom-distribution.html">Custom Distribution</a></p></li><li><p><a href="security-framework.html">Security Framework</a></p></li><li><p><a href="features-maven-plugin.html">Using the features-maven-plugin</a></p></li><li><p><a href="debugging.html">Troubleshooting, Debugging, Profiling, and Monitoring</a></p></li><li><p><a href="developer-commands.html">Developer Commands</a></p></li><li><p><a href="connect-console.html">Programmatically connect to the console</a></p></li><li><p><a href="writing-tests.html">Writing integration tests</a></p></li><li><p><a href="creating-bundles.html">Creating bundles</a></p></li><li><p><a href="shell-syntax.html">Shell syntax</a></p></li><li><p><a href=
 "github-contributions.html">Github Contributions</a></p></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

Added: servicemix/site/production/docs/5.0.x/developers-guide/shell-syntax.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/shell-syntax.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/shell-syntax.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/shell-syntax.html Sat May  4 19:45:49 2013
@@ -0,0 +1,187 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <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>
+        </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/5.0.x/developers-guide/toc.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/toc.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/toc.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/toc.html Sat May  4 19:45:49 2013
@@ -0,0 +1,132 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <ul>
+  <li id="karaf-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="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

Added: servicemix/site/production/docs/5.0.x/developers-guide/writing-tests.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/developers-guide/writing-tests.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/developers-guide/writing-tests.html (added)
+++ servicemix/site/production/docs/5.0.x/developers-guide/writing-tests.html Sat May  4 19:45:49 2013
@@ -0,0 +1,108 @@
+
+<!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-developers-guide">
+    <a href="#">Developer's Guide</a>
+    <ul>
+      <li id="extending-console">
+        <a href="extending-console.html">Extending Console</a>
+      </li>
+      <li id="writing-tests">
+        <a href="writing-tests.html">Tests with Pax Exam</a>
+      </li>
+      <li id="debugging">
+        <a href="debugging.html">Debug Karaf</a>
+      </li>
+      <li id="creating-bundles">
+        <a href="creating-bundles.html">Creating bundles</a>
+      </li>
+      <li id="connect-console">
+        <a href="connect-console.html">Connect to the console</a>
+      </li>
+      <li id="shell-syntax">
+        <a href="shell-syntax.html">Console shell syntax</a>
+      </li>
+    </ul>
+  </li>
+</ul>
+        </div>
+        <div id="body">
+                    <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><sp
 an 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
 ">)</span>&#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>
+        </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/5.0.x/images/ASF-logo.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/ASF-logo.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/ASF-logo.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/logodesign.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/logodesign.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/logodesign.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/new-logo.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/new-logo.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/new-logo.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/samplelog.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/samplelog.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/samplelog.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/samplelogactivemq.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/samplelogactivemq.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/samplelogactivemq.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/smx-overview.dia
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/smx-overview.dia?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/smx-overview.dia
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/smx-overview.png
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/smx-overview.png?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/smx-overview.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/images/smx4-start.gif
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/images/smx4-start.gif?rev=1479164&view=auto
==============================================================================
Binary file - no diff available.

Propchange: servicemix/site/production/docs/5.0.x/images/smx4-start.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: servicemix/site/production/docs/5.0.x/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/index.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/index.html (added)
+++ servicemix/site/production/docs/5.0.x/index.html Sat May  4 19:45:49 2013
@@ -0,0 +1,182 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Apache ServiceMix Documentation - Home</title>
+
+  <link href="theme/master.css" rel="stylesheet" type="text/css" />
+  <link href="theme/pygmentize.css" rel="stylesheet" type="text/css" />
+      <link href="theme/picker.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="bookpicker">
+
+<div class="left">
+  <a href="quickstart/index.html">
+    <h2>Quickstart Guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>If you're new to Apache ServiceMix, this document will guide you in your first steps in Apache ServiceMix.</p>
+      <div class="pdf">
+      <a href="quickstart/quickstart.pdf" class="pdf">PDF document</a>
+    </div>
+  </div>
+
+<div class="left">
+  <a href="user/index.html">
+    <h2>User Guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Apache ServiceMix contains a lot of different components and it embeds a lot of other Apache projects.  This user guide will help you select and configure the right components when building your own solution.</p>
+</div>
+
+
+<div class="left">
+  <a href="activemq/index.html">
+    <h2>ActiveMQ Guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Apache ServiceMix embeds Apache ActiveMQ to provide a JMS message broker that you can interact with from your Camel routes, providing support for message persistence, clustering, failover, ...</p>
+</div>
+
+<div class="left">
+  <a href="camel/index.html">
+    <h2>Camel Guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Apache Camel is a core component of Apache ServiceMix.  This guide will show you how to build and deploy Camel routes for Apache ServiceMix.</p>
+      <div class="pdf">
+      <a href="camel/camel-guide.pdf" class="pdf">PDF document</a>
+    </div>
+  </div>
+
+<div class="left">
+  <a href="activiti/index.html">
+    <h2>Activiti Guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Apache ServiceMix embeds Activiti to provide a light-weight workflow and Business Process Management (BPM) Platform targeted at business people, developers and system admins, ...</p>
+</div>
+
+<div class="left">
+  <a href="commands/index.html">
+    <h2>Command Reference</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Help pages for all the available commands in the Apache ServiceMix console.</p>
+</div>
+
+<div class="left">
+  <a href="users-guide/index.html">
+    <h2>Karaf User guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Apache ServiceMix uses Apache Karaf as the underlying OSGi server runtime. This manual explains about the features and functionality provided by Karaf.</p>
+</div>
+
+<div class="left">
+  <a href="developers-guide/index.html">
+    <h2>Karaf Developer guide</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>The Apache Karaf Developer Guide gives you some information about developing with and for the OSGi server runtime.</p>
+</div>
+
+
+<div class="left">
+  <a href="commercial.html">
+    <h2>Commercial Guides</h2>
+  </a>
+</div>
+
+<div class="right">
+  <p>Documentation from commercial providers and books you can buy.</p>
+</div>
+</div>
+
+<div class="clearing"></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/5.0.x/karaf/index.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/karaf/index.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/karaf/index.html (added)
+++ servicemix/site/production/docs/5.0.x/karaf/index.html Sat May  4 19:45:49 2013
@@ -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="ServiceMix5.0.0SNAPSHOTDocumentation">ServiceMix 5.0.0-SNAPSHOT Documentation</h1><p>ServiceMix 5.0.0-SNAPSHOT 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/5.0.x/karaf/toc.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/karaf/toc.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/karaf/toc.html (added)
+++ servicemix/site/production/docs/5.0.x/karaf/toc.html Sat May  4 19:45:49 2013
@@ -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

Added: servicemix/site/production/docs/5.0.x/quickstart/activemq.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/5.0.x/quickstart/activemq.html?rev=1479164&view=auto
==============================================================================
--- servicemix/site/production/docs/5.0.x/quickstart/activemq.html (added)
+++ servicemix/site/production/docs/5.0.x/quickstart/activemq.html Sat May  4 19:45:49 2013
@@ -0,0 +1,103 @@
+
+<!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="introduction">
+        <a href="index.html">Introduction</a>
+    </li>
+    <li id="basic-commands">
+        <a href="installation.html">Installing Apache ServiceMix</a>
+    </li>
+    <li id="features">
+        <a href="console.html">Console shell</a>
+    </li>
+    <li id="camel">
+        <a href="camel.html">Routing with Camel</a>
+    </li>
+    <li id="activemq">
+        <a href="activemq.html">Adding ActiveMQ to the 'Mix</a>
+    </li>
+    <li id="features">
+        <a href="features.html">Optional features</a>
+    </li>
+</ul>
+        </div>
+        <div id="body">
+                    <h1 id="AddingActiveMQtotheMix">Adding ActiveMQ to the 'Mix</h1><p>Out-of-the-box, every Apache ServiceMix instance comes with an embedded ActiveMQ JMS broker.  This makes it easy to communicate between Camel routes using persistent messages on the same machine, but it will also enable you to distribute your routes over multiple instances afterwards for clustering or load-balancing.</p><h2 id="Ourscenario">Our scenario</h2><p>In this scenario, we also want to move files between directories.  Instead of logging the move directly, we are going to send an event JMS message onto a queue.  Afterwards, we will create a second Camel route to receive the events and log them.</p><h2 id="Movingfilesandsendingeventmessages">Moving files and sending event messages</h2><p>The first Blueprint XML file we'll create contains a Camel route that moves the files from <tt>activemq/input</tt> to the <tt>activemq/output</tt> directory.  Afterwards, it will generate an event me
 ssage and send that to an ActiveMQ queue called <tt>events</tt>.</p><div class="syntax"><div class="highlight"><pre><span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</span>&#x000A;<span class="nt">&lt;blueprint</span>&#x000A;    <span class="na">xmlns=</span><span class="s">&quot;http://www.osgi.org/xmlns/blueprint/v1.0.0&quot;</span>&#x000A;    <span class="na">xmlns:xsi=</span><span class="s">&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span>&#x000A;    <span class="na">xsi:schemaLocation=</span><span class="s">&quot;</span>&#x000A;<span class="s">      http://www.osgi.org/xmlns/blueprint/v1.0.0</span>&#x000A;<span class="s">      http://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd&quot;</span><span class="nt">&gt;</span>&#x000A;&#x000A;    <span class="nt">&lt;camelContext</span> <span class="na">xmlns=</span><span class="s">&quot;http://camel.apache.org/schema/blueprint&quot;</span><span class="nt">&gt;</span>&#x000A;      <
 span class="nt">&lt;route&gt;</span>&#x000A;        <span class="nt">&lt;from</span> <span class="na">uri=</span><span class="s">&quot;file:activemq/input&quot;</span><span class="nt">/&gt;</span>&#x000A;        <span class="nt">&lt;to</span> <span class="na">uri=</span><span class="s">&quot;file:activemq/output&quot;</span><span class="nt">/&gt;</span>&#x000A;&#x000A;        <span class="nt">&lt;setBody&gt;</span>&#x000A;          <span class="nt">&lt;simple&gt;</span>&#x000A;            FileMovedEvent(file: ${file:name}, timestamp: ${date:now:hh:MM:ss.SSS})&#x000A;          <span class="nt">&lt;/simple&gt;</span>&#x000A;        <span class="nt">&lt;/setBody&gt;</span>&#x000A;        <span class="nt">&lt;to</span> <span class="na">uri=</span><span class="s">&quot;activemq://events&quot;</span> <span class="nt">/&gt;</span>&#x000A;      <span class="nt">&lt;/route&gt;</span>&#x000A;    <span class="nt">&lt;/camelContext&gt;</span>&#x000A;<span class="nt">&lt;/blueprint&gt;</
 span>&#x000A;</pre></div>&#x000A;</div><p>Save this file in ServiceMix' <tt>deploy</tt> folder and use <tt>osgi:list</tt> to check on the bundle status as you did with the simple Camel example.  You should now be able to put files in the <tt>activemq/input</tt> directory and see them being moved to <tt>activemq/output</tt>.</p><h2 id="Receivingtheeventmessages">Receiving the event messages</h2><p>After deploying the first XML file, you're obviously not seeing any events being logged yet.  The event messages are sent to an ActiveMQ queue, but there's nobody to receive the events yet.  Let's change that now by creating a second Blueprint XML file.</p><div class="syntax"><div class="highlight"><pre><span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</span>&#x000A;<span class="nt">&lt;blueprint</span>&#x000A;    <span class="na">xmlns=</span><span class="s">&quot;http://www.osgi.org/xmlns/blueprint/v1.0.0&quot;</span>&#x000A;    <span class="na">xml
 ns:xsi=</span><span class="s">&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span>&#x000A;    <span class="na">xsi:schemaLocation=</span><span class="s">&quot;</span>&#x000A;<span class="s">      http://www.osgi.org/xmlns/blueprint/v1.0.0</span>&#x000A;<span class="s">      http://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd&quot;</span><span class="nt">&gt;</span>&#x000A;&#x000A;    <span class="nt">&lt;camelContext</span> <span class="na">xmlns=</span><span class="s">&quot;http://camel.apache.org/schema/blueprint&quot;</span><span class="nt">&gt;</span>&#x000A;      <span class="nt">&lt;route&gt;</span>&#x000A;        <span class="nt">&lt;from</span> <span class="na">uri=</span><span class="s">&quot;activemq://events&quot;</span><span class="nt">/&gt;</span>&#x000A;        <span class="nt">&lt;to</span> <span class="na">uri=</span><span class="s">&quot;log:events&quot;</span><span class="nt">/&gt;</span>&#x000A;      <span class="nt">&lt;/route&gt;</span>&#x00
 0A;    <span class="nt">&lt;/camelContext&gt;</span>&#x000A;<span class="nt">&lt;/blueprint&gt;</span>&#x000A;</pre></div>&#x000A;</div><p>As soon as this second file has been deployed, you'll start seeing the event messages in your <tt>log:display</tt> output.</p><h2 id="Usingtheshelltomanagetheroutes">Using the shell to manage the routes</h2><p>You can now start and stop both routes from the command shell.  The important thing to note here is that you can stop the event handler route while files are being processed.  As soon as you restart that bundle afterwards, you'll receive the events from all files that have been moved while the route was not running.</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



Mime
View raw message