servicemix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ge...@apache.org
Subject svn commit: r1388647 [20/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...
Date Fri, 21 Sep 2012 19:46:06 GMT
Added: servicemix/site/production/docs/4.4.x/jbi/jbi-guide.pdf.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/jbi/jbi-guide.pdf.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/jbi/jbi-guide.pdf.html (added)
+++ servicemix/site/production/docs/4.4.x/jbi/jbi-guide.pdf.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,22 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+  <link href="../theme/print.css" rel="Stylesheet" type="text/css" />
+  <link href="../theme/pygmentize.css" rel="stylesheet" type="text/css" />
+
+  <title>JBI User's Guide</title>
+</head>
+<body>
+  <div id="titlepage">
+    <div id="title">JBI User's Guide</div>
+    <div id="subtitle">
+      Apache ServiceMix <br/>
+      Version 4.4.2
+    </div>
+  </div>
+  <div id="main">

[... 6 lines stripped ...]
Added: servicemix/site/production/docs/4.4.x/jbi/toc.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/jbi/toc.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/jbi/toc.html (added)
+++ servicemix/site/production/docs/4.4.x/jbi/toc.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,175 @@
+
+<!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="jbi-introduction">
+        <a href="#">Introducing JBI</a>
+        <ul>
+            <li id="jbi-what-is-jbi">
+                <a href="intro/what-is-jbi.html">What is JBI?</a>
+            </li>
+            <li id="jbi-meps">
+                <a href="intro/meps.html">JBI MEPs</a>
+            </li>
+            <li id="jbi-api">
+                <a href="intro/api.html">JBI API</a>
+            </li>
+        </ul>
+    </li>
+    <li id="jbi-components">
+        <a href="components/index.html">JBI Components</a>
+        <ul>
+            <li id="servicemix-bean"><a href="components/servicemix-bean.html">servicemix-bean</a></li>
+            <li id="servicemix-camel"><a href="components/servicemix-camel.html">servicemix-camel</a></li>
+            <li id="servicemix-cxf-bc"><a href="components/servicemix-cxf-bc.html">servicemix-cxf-bc</a></li>
+            <li id="servicemix-cxf-se"><a href="components/servicemix-cxf-se.html">servicemix-cxf-se</a></li>
+            <li id="servicemix-drools"><a href="components/servicemix-drools.html">servicemix-drools</a></li>
+            <li id="servicemix-eip"><a href="components/servicemix-eip.html">servicemix-eip</a></li>
+            <li id="servicemix-exec"><a href="components/servicemix-exec.html">servicemix-exec</a></li>
+            <li id="servicemix-file"><a href="components/servicemix-file.html">servicemix-file</a></li>
+            <li id="servicemix-ftp"><a href="components/servicemix-ftp.html">servicemix-ftp</a></li>
+            <li id="servicemix-http"><a href="components/servicemix-http.html">servicemix-http</a></li>
+            <li id="servicemix-jms"><a href="components/servicemix-jms.html">servicemix-jms</a></li>
+            <li id="servicemix-mail"><a href="components/servicemix-mail.html">servicemix-mail</a></li>
+            <li id="servicemix-osworkflow"><a href="components/servicemix-osworkflow.html">servicemix-osworkflow</a></li>
+            <li id="servicemix-quartz"><a href="components/servicemix-quartz.html">servicemix-quartz</a></li>
+            <li id="servicemix-saxon"><a href="components/servicemix-saxon.html">servicemix-saxon</a></li>
+            <li id="servicemix-scripting"><a href="components/servicemix-scripting.html">servicemix-scripting</a></li>
+            <li id="servicemix-snmp"><a href="components/servicemix-snmp.html">servicemix-snmp</a></li>
+            <li id="servicemix-validation"><a href="components/servicemix-validation.html">servicemix-validation</a></li>
+            <li id="servicemix-vfs"><a href="components/servicemix-vfs.html">servicemix-vfs</a></li>
+            <li id="servicemix-wsn2005"><a href="components/servicemix-wsn2005.html">servicemix-wsn2005</a></li>
+            <li id="servicemix-xmpp"><a href="components/servicemix-xmpp.html">servicemix-xmpp</a></li>
+        </ul>
+    </li>
+</ul>
+
+        </div>
+        <div id="body">
+                    <div class="note">
+            <h1>JBI Support deprecated in Apache ServiceMix 4</h1>
+            <p>JBI 1.0 support is available in Apache ServiceMix 4 to allow existing users to migrate more easily to this latest version - if you're a new user, you should consider JBI deprecated and not use it for your project.
+            Take a look at our <a href="../users-guide/getting-started/technology-selection.html"</a>technology selection guidelines</a> for more information.</p>
+          </div>
+                    
+<ul>
+    <li id="jbi-introduction">
+        <a href="#">Introducing JBI</a>
+        <ul>
+            <li id="jbi-what-is-jbi">
+                <a href="intro/what-is-jbi.html">What is JBI?</a>
+            </li>
+            <li id="jbi-meps">
+                <a href="intro/meps.html">JBI MEPs</a>
+            </li>
+            <li id="jbi-api">
+                <a href="intro/api.html">JBI API</a>
+            </li>
+        </ul>
+    </li>
+    <li id="jbi-components">
+        <a href="components/index.html">JBI Components</a>
+        <ul>
+            <li id="servicemix-bean"><a href="components/servicemix-bean.html">servicemix-bean</a></li>
+            <li id="servicemix-camel"><a href="components/servicemix-camel.html">servicemix-camel</a></li>
+            <li id="servicemix-cxf-bc"><a href="components/servicemix-cxf-bc.html">servicemix-cxf-bc</a></li>
+            <li id="servicemix-cxf-se"><a href="components/servicemix-cxf-se.html">servicemix-cxf-se</a></li>
+            <li id="servicemix-drools"><a href="components/servicemix-drools.html">servicemix-drools</a></li>
+            <li id="servicemix-eip"><a href="components/servicemix-eip.html">servicemix-eip</a></li>
+            <li id="servicemix-exec"><a href="components/servicemix-exec.html">servicemix-exec</a></li>
+            <li id="servicemix-file"><a href="components/servicemix-file.html">servicemix-file</a></li>
+            <li id="servicemix-ftp"><a href="components/servicemix-ftp.html">servicemix-ftp</a></li>
+            <li id="servicemix-http"><a href="components/servicemix-http.html">servicemix-http</a></li>
+            <li id="servicemix-jms"><a href="components/servicemix-jms.html">servicemix-jms</a></li>
+            <li id="servicemix-mail"><a href="components/servicemix-mail.html">servicemix-mail</a></li>
+            <li id="servicemix-osworkflow"><a href="components/servicemix-osworkflow.html">servicemix-osworkflow</a></li>
+            <li id="servicemix-quartz"><a href="components/servicemix-quartz.html">servicemix-quartz</a></li>
+            <li id="servicemix-saxon"><a href="components/servicemix-saxon.html">servicemix-saxon</a></li>
+            <li id="servicemix-scripting"><a href="components/servicemix-scripting.html">servicemix-scripting</a></li>
+            <li id="servicemix-snmp"><a href="components/servicemix-snmp.html">servicemix-snmp</a></li>
+            <li id="servicemix-validation"><a href="components/servicemix-validation.html">servicemix-validation</a></li>
+            <li id="servicemix-vfs"><a href="components/servicemix-vfs.html">servicemix-vfs</a></li>
+            <li id="servicemix-wsn2005"><a href="components/servicemix-wsn2005.html">servicemix-wsn2005</a></li>
+            <li id="servicemix-xmpp"><a href="components/servicemix-xmpp.html">servicemix-xmpp</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/4.4.x/karaf/developers-guide/branding-console.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/branding-console.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/branding-console.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/branding-console.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,129 @@
+
+<!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="BrandingtheConsole">Branding the Console</h1><p>This chapter will show you how to customize the user interface of the Karaf console, making  <br/>changes such as a new welcome message and console prompt.  This is what we refer to as "branding" Karaf.</p><h2 id="Createyourbrandingbundle">Create your branding bundle</h2><p>At startup, Karaf is looking for a bundle which exports the <tt>org.apache.karaf.branding</tt> package containing a <tt>branding.properties</tt><br/>file.</p><p>So you need to create a very simple bundle containing just a <tt>org/apache/karaf/branding/branding.properties</tt> file.</p><p>The Maven POM of your branding bundle should look like this:</p><pre>
+&lt;?xml version="1.0" encoding="UTF-8"?>
+&lt;project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+    &lt;modelVersion>4.0.0&lt;/modelVersion>
+
+    &lt;groupId>your.group.id&lt;/groupId>
+    &lt;artifactId>your.branding.artifact.id&lt;/artifactId>
+    &lt;version>1.0-SNAPSHOT&lt;/version>
+    &lt;packaging>bundle&lt;/packaging>
+    &lt;name>Your Branding Bundle Name&lt;/name>
+
+    &lt;build>
+        &lt;plugins>
+            &lt;plugin>
+                &lt;groupId>org.apache.felix&lt;/groupId>
+                &lt;artifactId>maven-bundle-plugin&lt;/artifactId>
+                &lt;version>2.2&lt;/version>
+                &lt;extensions>true&lt;/extensions>
+                &lt;configuration>
+                    &lt;instructions>
+                        &lt;Bundle-SymbolicName>manual&lt;/bundle-SymbolicName>
+                        &lt;Import-Package>*&lt;/Import-Package>
+                        &lt;Private-Package>!*&lt;/Private-Package>
+                        &lt;Export-Package>
+                            org.apache.karaf.branding
+                        &lt;/Export-Package>
+                        &lt;Spring-Context>*;public-context:=false&lt;/Spring-Context>
+                    &lt;/instructions>
+                &lt;/configuration>
+            &lt;/plugin>
+        &lt;/plugins>
+    &lt;/build>
+
+&lt;/project>
+</pre><p>Now, add a <tt>src/main/resources/org/apache/karaf/branding/branding.properties</tt> similar to:</p><p>{</p><pre>}
+welcome = \
+\u001B[36m        __ __                  ____      \u001B[0m\r\n\
+\u001B[36m       / //_/____ __________ _/ __/      \u001B[0m\r\n\
+\u001B[36m      / ,&lt;  / __ `/ ___/ __ `/ /_        \u001B[0m\r\n\
+\u001B[36m     / /| |/ /_/ / /  / /_/ / __/        \u001B[0m\r\n\
+\u001B[36m    /_/ |_|\\__,_/_/   \\__,_/_/         \u001B[0m\r\n\
+\r\n\
+\u001B[1m  Apache Karaf\u001B[0m (2.2.4)\r\n\
+\r\n\
+Hit '\u001B[1m&lt;tab>\u001B[0m' for a list of available commands\r\n\
+   and '\u001B[1m[cmd] --help\u001B[0m' for help on a specific command.\r\n\
+Hit '\u001B[1m&lt;ctrl-d>\u001B[0m' or '\u001B[1mosgi:shutdown\u001B[0m' to shutdown Karaf.\r\n
+
+prompt = \u001B[1m${USER}@${APPLICATION}\u001B[0m>
+{
+</pre><p>}</p><p>As you can see, the <tt>branding.properties</tt> contains two properties:</p><ul><li>welcome is the welcome message displayed when you start Karaf.</li><li>prompt is the string used to display the console prompt. This string supports variables:<ul><li>$} defines the user name of the prompt. Caveat &#8211; the user name is presently static and hardcoded to "karaf",<p>however you can override here with your own static user name.</p></li><li>${{APPLICATION}} defines the Karaf instance name.</li></ul></li></ul><p>As you can see, both strings support ASCII escaped format. For instance \u001B[1m switches the foreground to bold and \u001B[0m<br/>switches it back to normal.</p><p>Some examples of customized prompts:</p><pre>
+# Define a user with fancy colors
+prompt = \u001B[36mmy-karaf-user\u001B[0m\u001B[1m@\u001B[0m\u001B[34m${APPLICATION}\u001B[0m>
+</pre><pre>
+# Static sober prompt
+prompt = my-user@my-karaf>
+</pre><h2 id="ConfiguringKaraftousethebrandingbundle">Configuring Karaf to use the branding bundle</h2><p>In order for Karaf to pick up the branding jar please edit the <br/>$KARAF_HOME/etc/custom.properties file to include the following: </p><p>  org.osgi.framework.system.packages.extra = \ <br/>    org.apache.karaf.branding;</p><h2 id="Installingthebrandingbundle">Installing the branding bundle</h2><p>Build your branding bundle:</p><pre>
+mvn install
+</pre><p>and simply drop the generated jar file into the Karaf lib directory.</p><p>Start Karaf and you will see your branded Karaf console.</p>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/connect-console.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/connect-console.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/connect-console.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/connect-console.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="Programmaticallyconnecttotheconsole">Programmatically connect to the console</h1><p>A connection to the Karaf console can also be done programmatically.<br/>The following code is a simplified version of the code from the client library.</p><div class="syntax"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">org.apache.sshd.ClientChannel</span><span class="o">;</span>&#x000A;<span class="kn">import</span> <span class="nn">org.apache.sshd.ClientSession</span><span class="o">;</span>&#x000A;<span class="kn">import</span> <span class="nn">org.apache.sshd.SshClient</span><span class="o">;</span>&#x000A;<span class="kn">import</span> <span class="nn">org.apache.sshd.client.future.ConnectFuture</span><span class="o">;</span>&#x000A;&#x000A;<span class="kd">public</span> <span class="kd">class</span> <span class="nc">Main</span> <span class="o">{</span>&#x000A;&#x000A;    <span class="kd">public</span> <span class="kd">static</span> <sp
 an class="kt">void</span> <span class="nf">main</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>&#x000A;        <span class="n">String</span> <span class="n">host</span> <span class="o">=</span> <span class="s">&quot;localhost&quot;</span><span class="o">;</span>&#x000A;        <span class="kt">int</span> <span class="n">port</span> <span class="o">=</span> <span class="mi">8101</span><span class="o">;</span>&#x000A;        <span class="n">String</span> <span class="n">user</span> <span class="o">=</span> <span class="s">&quot;karaf&quot;</span><span class="o">;</span>&#x000A;        <span class="n">String</span> <span class="n">password</span> <span class="o">=</span> <span class="s">&quot;karaf&quot;</span><span class="o">;</span>&#x000A;&#x000A;        <span class="n">SshClient</span> <span class="
 n">client</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>&#x000A;        <span class="k">try</span> <span class="o">{</span>&#x000A;            <span class="n">client</span> <span class="o">=</span> <span class="n">SshClient</span><span class="o">.</span><span class="na">setUpDefaultClient</span><span class="o">();</span>&#x000A;            <span class="n">client</span><span class="o">.</span><span class="na">start</span><span class="o">();</span>&#x000A;            <span class="n">ConnectFuture</span> <span class="n">future</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">connect</span><span class="o">(</span><span class="n">host</span><span class="o">,</span> <span class="n">port</span><span class="o">);</span>&#x000A;            <span class="n">future</span><span class="o">.</span><span class="na">await</span><span class="o">();</span>&#x000A;            <span class="n">ClientSession
 </span> <span class="n">session</span> <span class="o">=</span> <span class="n">future</span><span class="o">.</span><span class="na">getSession</span><span class="o">();</span>&#x000A;            <span class="n">session</span><span class="o">.</span><span class="na">authPassword</span><span class="o">(</span><span class="n">user</span><span class="o">,</span> <span class="n">password</span><span class="o">);</span>&#x000A;            <span class="n">ClientChannel</span> <span class="n">channel</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="na">createChannel</span><span class="o">(</span><span class="s">&quot;shell&quot;</span><span class="o">);</span>&#x000A;            <span class="n">channel</span><span class="o">.</span><span class="na">setIn</span><span class="o">(</span><span class="n">System</span><span class="o">.</span><span class="na">in</span><span class="o">);</span>&#x000A;            <span class="n">channel</s
 pan><span class="o">.</span><span class="na">setOut</span><span class="o">(</span><span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">);</span>&#x000A;            <span class="n">channel</span><span class="o">.</span><span class="na">setErr</span><span class="o">(</span><span class="n">System</span><span class="o">.</span><span class="na">err</span><span class="o">);</span>&#x000A;            <span class="n">channel</span><span class="o">.</span><span class="na">open</span><span class="o">();</span>&#x000A;            <span class="n">channel</span><span class="o">.</span><span class="na">waitFor</span><span class="o">(</span><span class="n">ClientChannel</span><span class="o">.</span><span class="na">CLOSED</span><span class="o">,</span> <span class="mi">0</span><span class="o">);</span>&#x000A;        <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Throwable</span> <span class="n">t</s
 pan><span class="o">)</span> <span class="o">{</span>&#x000A;            <span class="n">t</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>&#x000A;            <span class="n">System</span><span class="o">.</span><span class="na">exit</span><span class="o">(</span><span class="mi">1</span><span class="o">);</span>&#x000A;        <span class="o">}</span> <span class="k">finally</span> <span class="o">{</span>&#x000A;            <span class="k">try</span> <span class="o">{</span>&#x000A;                <span class="n">client</span><span class="o">.</span><span class="na">stop</span><span class="o">();</span>&#x000A;            <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Throwable</span> <span class="n">t</span><span class="o">)</span> <span class="o">{</span> <span class="o">}</span>&#x000A;        <span class="o">}</span>&#x000A;        <span class="n">System</span><span class="o">
 .</span><span class="na">exit</span><span class="o">(</span><span class="mi">0</span><span class="o">);</span>&#x000A;    <span class="o">}</span>&#x000A;&#x000A;<span class="o">}</span>&#x000A;</pre></div>&#x000A;</div><p>You can find a more complete example at the <a href="http://svn.apache.org/repos/asf/karaf/trunk/client/src/main/java/org/apache/karaf/client/Main.java">following location</a>.</p>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/creating-bundles.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/creating-bundles.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/creating-bundles.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/creating-bundles.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,210 @@
+
+<!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="Addextendedinformationtobundles">Add extended information to bundles</h1><p>Karaf supports a OSGI-INF/bundle.info file in a bundle.</p><p>This file is extended description of the bundle. It supports ASCII character declarations (for adding color, formatting, etc).</p><p>For instance, you can define a bundle like this (using Apache Felix maven-bundle-plugin):</p><pre>
+&lt;?xml version="1.0" encoding="UTF-8"?>
+&lt;project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+    &lt;modelVersion>4.0.0&lt;/modelVersion>
+
+    &lt;groupId>my.groupId&lt;/groupId>
+    &lt;artifactId>my.bundle&lt;/artifactId>
+    &lt;version>1.0-SNAPSHOT&lt;/version>
+    &lt;name>My Bundle&lt;/name>
+    &lt;description>My bundle short description&lt;/description>
+
+    &lt;build>
+        &lt;resources>
+            &lt;resource>
+                &lt;directory>/x1/asf/karaf-2.2.x/target/checkout/manual/src/main/resources&lt;/directory>
+                &lt;filtering>true&lt;/filtering>
+                &lt;includes>
+                    &lt;include>**/*&lt;/include>
+                &lt;/includes>
+            &lt;/resource>
+        &lt;/resources>
+        &lt;plugins>
+            &lt;plugin>
+                &lt;groupId>org.apache.felix&lt;/groupId>
+                &lt;artifactId>maven-bundle-plugin&lt;/artifactId>
+                &lt;version>2.2.0&lt;/version>
+                &lt;extensions>true&lt;/extensions>
+                &lt;configuration>
+                    &lt;instructions>
+                        &lt;Bundle-SymbolicName>manual&lt;/Bundle-SymbolicName>
+                        ...
+                    &lt;/instructions>
+                &lt;/configuration>
+            &lt;/plugin>
+        &lt;/plugins>
+    &lt;/build>
+
+&lt;/project>
+</pre><p>And simply add a src/main/resources/OSGI-INF/bundle.info file containing, for instance:</p><pre>
+\u001B[1mSYNOPSIS\u001B[0m
+    The Apache Software Foundation provides support for the Apache community of open-source software projects.
+    The Apache projects are characterized by a collaborative, consensus based development process, an open and
+    pragmatic software license, and a desire to create high quality software that leads the way in its field.
+    We consider ourselves not simply a group of projects sharing a server, but rather a community of developers
+    and users.
+
+\u001B[1mDESCRIPTION\u001B[0m
+    Long description of your bundle, including usage, etc.
+
+\u001B[1mSEE ALSO\u001B[0m
+    \u001B[36mhttp://yourside\u001B[0m
+    \u001B[36mhttp://yourside/docs\u001B[0m
+
+</pre><p>You can display this extended information using:</p><pre>
+root@karaf> osgi:info
+</pre><h1 id="Creatingbundlesforthirdpartydependencies">Creating bundles for third party dependencies</h1><p>Karaf supports the wrap: protocol execution.</p><p>It allows for directly deploying third party dependencies, like Apache Commons Lang:</p><pre>
+root@karaf> osgi:install wrap:mvn:commons-lang/commons-lang/2.4
+</pre><p>You can specify OSGi statements in the wrap URL:</p><pre>
+root@karaf> osgi:install wrap:mvn:commons-lang/commons-lang/2.4,Bundle-SymbolicName=commons-lang&amp;Bundle-Version=2.4
+</pre><p>You can also create a wrap bundle for a third party dependency.<br/>This bundle is simply a Maven POM that shades an existing jar and package into a jar bundle.</p><p>For instance, to create an OSGi bundle that wraps Apache Commons Lang, you can simply define the following Maven POM:</p><pre>
+&lt;?xml version="1.0" encoding="UTF-8"?>
+&lt;project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+    &lt;modelVersion>4.0.0&lt;/modelVersion>
+
+    &lt;groupId>osgi.commons-lang&lt;/groupId>
+    &lt;artifactId>osgi.commons-lang&lt;/artifactId>
+    &lt;version>2.4&lt;/version>
+    &lt;packaging>bundle&lt;/packaging>
+    &lt;name>commons-lang OSGi Bundle&lt;/name>
+    &lt;description>This OSGi bundle simply wraps commons-lang-2.4.jar artifact.&lt;/description>
+
+    &lt;dependencies>
+        &lt;dependency>
+            &lt;groupId>commons-lang&lt;/groupId>
+            &lt;artifactId>commons-lang&lt;/artifactId>
+            &lt;version>2.4&lt;/version>
+            &lt;optional>true&lt;/optional>
+        &lt;/dependency>
+    &lt;/dependencies>
+
+    &lt;build>
+        &lt;defaultGoal>install&lt;/defaultGoal>
+
+        &lt;plugin>
+            &lt;groupId>org.apache.maven.plugins&lt;/groupId>
+            &lt;artifactId>maven-shade-plugin&lt;/artifactId>
+            &lt;version>1.1&lt;/version>
+            &lt;executions>
+                &lt;execution>
+                    &lt;phase>package&lt;/phase>
+                    &lt;goals>
+                        &lt;goal>shade&lt;/goal>
+                    &lt;/goals>
+                    &lt;configuration>
+                        &lt;artifactSet>
+                            &lt;includes>
+                                &lt;include>commons-lang:commons-lang&lt;/include>
+                            &lt;/includes>
+                        &lt;/artifactSet>
+                        &lt;filters>
+                            &lt;filter>
+                                &lt;artifact>commons-lang:commons-lang&lt;/artifact>
+                                &lt;excludes>
+                                    &lt;exclude>**&lt;/exclude>
+                                &lt;/excludes>
+                            &lt;/filter>
+                        &lt;/filters>
+                        &lt;promoteTransitiveDependencies>true&lt;/promoteTransitiveDependencies>
+                        &lt;createDependencyReducedPom>true&lt;/createDependencyReducedPom>
+                    &lt;/configuration>
+                &lt;/execution>
+            &lt;/executions>
+        &lt;/plugin>
+        &lt;plugin>
+            &lt;groupId>org.apache.felix&lt;/groupId>
+            &lt;artifactId>maven-bundle-plugin&lt;/artifactId>
+            &lt;version>2.1.0&lt;/version>
+            &lt;extensions>true&lt;/extensions>
+            &lt;configuration>
+                &lt;instructions>
+                    &lt;Bundle-SymbolicName>manual&lt;/Bundle-SymbolicName>
+                    &lt;Export-Package>&lt;/Export-Package>
+                    &lt;Import-Package>&lt;/Import-Package>
+                    &lt;_versionpolicy>[$(version;==;$(@)),$(version;+;$(@)))&lt;/_versionpolicy>
+                    &lt;_removeheaders>Ignore-Package,Include-Resource,Private-Package,Embed-Dependency&lt;/_removeheaders>
+                &lt;/instructions>
+                &lt;unpackBundle>true&lt;/unpackBundle>
+            &lt;/configuration>
+        &lt;/plugin>
+    &lt;/build>
+
+&lt;/project>
+</pre><p>You have now a OSGi bundle for commons-lang that you can deploy directly:</p><pre>
+root@karaf> osgi:install -s mvn:osgi.commons-lang/osgi.commons-lang/2.4
+</pre><p>Some more information is available at <a href="http://gnodet.blogspot.com/2008/09/id-like-to-talk-bit-about-third-party.html">http://gnodet.blogspot.com/2008/09/id-like-to-talk-bit-about-third-party.html</a>, <a href="http://blog.springsource.com/2008/02/18/creating-osgi-bundles/">http://blog.springsource.com/2008/02/18/creating-osgi-bundles/</a> and <a href="http://felix.apache.org/site/apache-felix-maven-bundle-plugin-bnd.html">http://felix.apache.org/site/apache-felix-maven-bundle-plugin-bnd.html</a>.</p>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/custom-distribution.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/custom-distribution.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/custom-distribution.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/custom-distribution.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,409 @@
+
+<!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="Customdistributions">Custom distributions</h1><p>As Karaf is an OSGi container, it's heavily used as an application and middleware kernel.</p><p>You may wish to construct your own Karaf distribution preconfigured to your requirements.<br/>This custom distribution could contain:</p><ul style="list-style: square"><li>branding to change the Karaf console look-and-feel</li><li>configuration files (in the etc folder) altered to your requirements</li><li>pre-packaged artifacts in the deploy folder</li><li>a pre-populated system repository (containing your own bundle and features descriptor)</li><li>renamed or specific scripts in the bin folder</li><li>system documentation files</li></ul><h2 id="Mavenassembly">Maven assembly</h2><p>Basically a Karaf custom distribution involves:<br/>1. Uncompressing a standard Karaf distribution in a given directory.<br/>2. Populating the system repo with your features.<br/>3. Populating the lib directory with your branding or o
 ther system bundle jar files.<br/>4. Overriding the configuration files in the etc folder.</p><p>These tasks could be performed using scripting, or more easily and portable, using Apache Maven and a set of Maven plugins.</p><p>For instance, the Maven POM could look like:</p><pre>
+&lt;?xml version="1.0" encoding="UTF-8"?>
+&lt;project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  &lt;groupId>my.company&lt;/groupId>
+  &lt;artifactId>mycustom-karaf&lt;/artifactId>
+  &lt;version>1.0&lt;/version>
+  &lt;packaging>pom&lt;/packaging>
+  &lt;name>My Unix Custom Karaf Distribution&lt;/name>
+
+  &lt;properties>
+    &lt;karaf.version>2.2.2&lt;/karaf.version>
+  &lt;/properties>
+
+  &lt;dependencies>
+    &lt;dependency>
+      &lt;groupId>org.apache.karaf&lt;/groupId>
+      &lt;artifactId>apache-karaf&lt;/artifactId>
+      &lt;version>2.2.4&lt;/version>
+      &lt;type>tar.gz&lt;/type>
+    &lt;/dependency>
+    &lt;dependency>
+      &lt;groupId>org.apache.karaf&lt;/groupId>
+      &lt;artifactId>apache-karaf&lt;/artifactId>
+      &lt;version>2.2.4&lt;/version>
+      &lt;type>xml&lt;/type>
+      &lt;classifier>features&lt;/classifier>
+    &lt;/dependency>
+  &lt;/dependencies>
+
+  &lt;build>
+    &lt;resources>
+      &lt;resource>
+        &lt;directory>/x1/asf/karaf-2.2.x/target/checkout/manual/src/main/filtered-resources&lt;/directory>
+        &lt;filtering>true&lt;/filtering>
+        &lt;includes>
+          &lt;include>**/*&lt;/include>
+        &lt;/includes>
+      &lt;/resource>
+    &lt;/resources>
+    &lt;plugins>
+      &lt;plugin>
+        &lt;groupId>org.apache.maven.plugins&lt;/groupId>
+        &lt;artifactId>maven-resources-plugin&lt;/artifactId>
+        &lt;executions>
+          &lt;execution>
+            &lt;id>filter&lt;/id>
+            &lt;phase>generate-resources&lt;/phase>
+            &lt;goals>
+              &lt;goal>resources&lt;/goal>
+            &lt;/goals>
+          &lt;/execution>
+        &lt;/executions>
+      &lt;/plugin>
+      &lt;plugin>
+        &lt;groupId>org.apache.karaf.tooling&lt;/groupId>
+        &lt;artifactId>features-maven-plugin&lt;/artifactId>
+        &lt;version>2.2.4&lt;/version>
+        &lt;executions>
+          &lt;execution>
+           &lt;id>add-features-to-repo&lt;/id>
+           &lt;phase>generate-resources&lt;/phase>
+           &lt;goals>
+             &lt;goal>add-features-to-repo&lt;/goal>
+           &lt;/goals>
+           &lt;configuration>
+              &lt;descriptors>
+                &lt;descriptor>mvn:org.apache.karaf/apache-karaf/2.2.4/xml/features&lt;/descriptor>
+                &lt;descriptor>file:/x1/asf/karaf-2.2.x/target/checkout/manual/target/classes/my-features.xml&lt;/descriptor>
+              &lt;/descriptors>
+              &lt;features>
+                &lt;feature>my-feature&lt;/feature>
+              &lt;/features>
+           &lt;/configuration>
+          &lt;/execution>
+        &lt;/executions>
+      &lt;/plugin>
+      &lt;plugin>
+        &lt;groupId>org.apache.maven.plugins&lt;/groupId>
+        &lt;artifactId>maven-dependency-plugin&lt;/artifactId>
+        &lt;executions>
+          &lt;execution>
+            &lt;id>copy&lt;/id>
+            &lt;phase>generate-resources&lt;/phase>
+            &lt;goals>
+              &lt;goal>copy&lt;/goal>
+            &lt;/goals>
+            &lt;configuration>
+               &lt;!-- Define here the artifacts which should be considered in the assembly -->
+               &lt;!-- For instance, the branding jar -->
+               &lt;artifactItems>
+                 &lt;artifactItem>
+                    &lt;groupId>my.groupId&lt;/groupId>
+                    &lt;artifactId>my.branding.id&lt;/artifactId>
+                    &lt;version>1.0&lt;/version>
+                    &lt;outputDirectory>target/dependencies&lt;/outputDirectory>
+                    &lt;destFileName>mybranding.jar&lt;/destFileName>
+                 &lt;/artifactItem>
+               &lt;/artifactItems>
+            &lt;/configuration>
+          &lt;/execution>
+          &lt;execution>
+            &lt;!-- Uncompress the standard Karaf distribution -->
+            &lt;id>unpack&lt;/id>
+            &lt;phase>generate-resources&lt;/phase>
+            &lt;goals>
+              &lt;goal>unpack&lt;/goal>
+            &lt;/goals>
+            &lt;configuration>
+              &lt;artifactItems>
+                &lt;artifactItem>
+                  &lt;groupId>org.apache.karaf&lt;/groupId>
+                  &lt;artifactId>apache-karaf&lt;/artifactId>
+                  &lt;type>tar.gz&lt;/type>
+                  &lt;outputDirectory>target/dependencies&lt;/outputDirectory>
+                &lt;/artifactItem>
+              &lt;/artifactItems>
+            &lt;/configuration>
+          &lt;/execution>
+        &lt;/executions>
+      &lt;/plugin>
+      &lt;plugin>
+        &lt;groupId>org.apache.maven.plugins&lt;/groupId>
+        &lt;artifactId>maven-assembly-plugin&lt;/artifactId>
+        &lt;executions>
+          &lt;execution>
+            &lt;id>bin&lt;/id>
+            &lt;phase>package&lt;/phase>
+            &lt;goals>
+              &lt;goal>single&lt;/goal>
+            &lt;/goals>
+            &lt;configuration>
+              &lt;descriptors>
+                &lt;descriptor>src/main/descriptors/bin.xml&lt;/descriptor>
+              &lt;/descriptors>
+              &lt;appendAssemblyId>false&lt;/appendAssemblyId>
+              &lt;tarLongFileMode>gnu&lt;/tarLongFileMode>
+            &lt;/configuration>
+          &lt;/execution>
+        &lt;/executions>
+      &lt;/plugin>
+    &lt;/plugins>
+  &lt;/build>
+
+&lt;/project>
+</pre><p>The Maven POM will download the Karaf standard distribution and prepare resources to be processed by the Maven assembly plugin.</p><p>Your Maven project structure should look like:</p><ul><li>pom.xml: the previous POM file</li><li>src/main/descriptors/bin.xml: the assembly maven plugin descriptor (see below)</li><li>src/main/filtered-resources: contains all resource files that have Maven property values to be filtered/replaced. Typically, this will include features descriptor and configuration files.</li><li>src/main/distribution: contains all raw files which will be copied as-is into your custom distribution.</li></ul><p>For instance, <tt>src/main/filtered-resources</tt> could contain:</p><ul><li><tt>my-features.xml</tt> where maven properties will be replaced</li><li><tt>etc/org.apache.karaf.features.cfg</tt> file containing your my-features descriptor:<pre>
+#
+# Comma separated list of features repositories to register by default
+#
+featuresRepositories=mvn:org.apache.karaf/apache-karaf/2.2.4/xml/features,mvn:my.groupId/my-features/2.2.4/xml/features
+
+#
+# Comma separated list of features to install at startup
+#
+featuresBoot=config,ssh,management,my-feature
+</pre></li></ul><p>The <tt>src/main/distribution</tt> contains all your custom Karaf configuration files and scripts, as, for examples:</p><ul><li>etc/org.ops4j.pax.logging.cfg<pre>
+# Root logger
+log4j.rootLogger=INFO, out, osgi:VmLogAppender
+log4j.throwableRenderer=org.apache.log4j.OsgiThrowableRenderer
+
+# CONSOLE appender not used by default
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} | %-5.5p | %-16.16t | %-32.32C %4L | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+
+# File appender
+log4j.appender.out=org.apache.log4j.RollingFileAppender
+log4j.appender.out.layout=org.apache.log4j.PatternLayout
+log4j.appender.out.layout.ConversionPattern=%d{ABSOLUTE} | %-5.5p | %-16.16t | %-32.32C %4L | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+log4j.appender.out.file=${karaf.home}/log/my-customer-distribution.log
+log4j.appender.out.append=true
+log4j.appender.out.maxFileSize=1MB
+log4j.appender.out.maxBackupIndex=10
+
+# Sift appender
+log4j.appender.sift=org.apache.log4j.sift.MDCSiftingAppender
+log4j.appender.sift.key=bundle.name
+log4j.appender.sift.default=my-custom
+log4j.appender.sift.appender=org.apache.log4j.FileAppender
+log4j.appender.sift.appender.layout=org.apache.log4j.PatternLayout
+log4j.appender.sift.appender.layout.ConversionPattern=%d{ABSOLUTE} | %-5.5p | %-16.16t | %-32.32c{1} | %-32.32C %4L | %m%n
+log4j.appender.sift.appender.file=${karaf.data}/log/$\\{bundle.name\\}.log
+log4j.appender.sift.appender.append=true
+</pre></li><li>etc/system.properties<pre>
+#
+# The properties defined in this file will be made available through system
+# properties at the very beginning of the FAS boot process.
+#
+
+# Log level when the pax-logging service is not available
+# This level will only be used while the pax-logging service bundle
+# is not fully available.
+# To change log levels, please refer to the org.ops4j.pax.logging.cfg file
+# instead.
+org.ops4j.pax.logging.DefaultServiceLog.level=ERROR
+
+#
+# Name of this custom instance.
+#
+karaf.name=my-custom
+
+#
+# Default repository where bundles will be loaded from before using
+# other maven repositories. For the full Maven configuration, see the
+# org.ops4j.pax.url.mvn.cfg file.
+#
+karaf.default.repository=system
+
+#
+# Location of a shell script that will be run when starting a shell
+# session. This script can be used to create aliases and define
+# additional commands.
+#
+karaf.shell.init.script=${karaf.home}/etc/shell.init.script
+
+#
+# Set this empty property to avoid errors when validating xml documents.
+#
+xml.catalog.files=
+
+#
+# Suppress the bell in the console when hitting backspace to many times
+# for example
+#
+jline.nobell=true
+
+#
+# Default port for the OSGi HTTP Service
+#
+org.osgi.service.http.port=8181
+
+#
+# Allow usage of ${custom.home} as an alias for ${karaf.home}
+#
+custom.home=${karaf.home}
+</pre></li><li>etc/users.properties<pre>
+admin=admin,admin
+</pre></li><li>You can add a <tt>etc/custom.properties</tt>, it's a placeholder for any override you may need. For instance:<pre>
+karaf.systemBundlesStartLevel=50
+obr.repository.url=http://svn.apache.org/repos/asf/servicemix/smx4/obr-repo/repository.xml
+org.osgi.framework.system.packages.extra = \
+  org.apache.karaf.branding; \
+  com.sun.org.apache.xalan.internal.xsltc.trax; \
+  com.sun.org.apache.xerces.internal.dom; \
+  com.sun.org.apache.xerces.internal.jaxp; \
+  com.sun.org.apache.xerces.internal.xni; \
+  com.sun.jndi.ldap
+</pre></li></ul><p>Now, we can "assemble" our custom distribution using the Maven assembly plugin. The Maven assembly plugin uses an assembly descriptor, configured in POM above to be <tt>src/main/descriptors/bin.xml</tt>:</p><pre>
+&lt;assembly>
+
+    &lt;id>bin&lt;/id>
+
+    &lt;formats>
+        &lt;format>tar.gz&lt;/format>
+    &lt;/formats>
+
+    &lt;fileSets>
+
+        &lt;!-- Expanded Karaf Standard Distribution -->
+        &lt;fileSet>
+            &lt;directory>target/dependencies/apache-karaf-2.2.4&lt;/directory>
+            &lt;outputDirectory>/&lt;/outputDirectory>
+            &lt;excludes>
+                &lt;exclude>**/demos/**&lt;/exclude>
+                &lt;exclude>bin/**&lt;/exclude>
+                &lt;exclude>etc/system.properties&lt;/exclude>
+                &lt;exclude>etc/users.properties&lt;/exclude>
+                &lt;exclude>etc/org.apache.karaf.features.cfg&lt;/exclude>
+                &lt;exclude>etc/org.ops4j.pax.logging.cfg&lt;/exclude>
+                &lt;exclude>LICENSE&lt;/exclude>
+                &lt;exclude>NOTICE&lt;/exclude>
+                &lt;exclude>README&lt;/exclude>
+                &lt;exclude>RELEASE-NOTES&lt;/exclude>
+                &lt;exclude>karaf-manual*.html&lt;/exclude>
+                &lt;exclude>karaf-manual*.pdf&lt;/exclude>
+            &lt;/excludes>
+        &lt;/fileSet>
+
+        &lt;!-- Copy over bin/* separately to get the correct file mode -->
+        &lt;fileSet>
+            &lt;directory>target/dependencies/apache-karaf-2.2.4&lt;/directory>
+            &lt;outputDirectory>/&lt;/outputDirectory>
+            &lt;includes>
+                &lt;include>bin/admin&lt;/include>
+                &lt;include>bin/karaf&lt;/include>
+                &lt;include>bin/start&lt;/include>
+                &lt;include>bin/stop&lt;/include>
+            &lt;/includes>
+            &lt;fileMode>0755&lt;/fileMode>
+        &lt;/fileSet>
+
+        &lt;!-- Copy over jar files -->
+        &lt;fileSet>
+            &lt;directory>target/dependencies&lt;/directory>
+            &lt;includes>
+                &lt;include>my-custom.jar&lt;/include>
+            &lt;/includes>
+            &lt;outputDirectory>/lib/&lt;/outputDirectory>
+        &lt;/fileSet>
+
+        &lt;fileSet>
+            &lt;directory>src/main/distribution&lt;/directory>
+            &lt;outputDirectory>/&lt;/outputDirectory>
+            &lt;fileMode>0644&lt;/fileMode>
+        &lt;/fileSet>
+        &lt;fileSet>
+            &lt;directory>target/classes/etc&lt;/directory>
+            &lt;outputDirectory>/etc/&lt;/outputDirectory>
+            &lt;lineEnding>unix&lt;/lineEnding>
+            &lt;fileMode>0644&lt;/fileMode>
+        &lt;/fileSet>
+
+        &lt;fileSet>
+            &lt;directory>target/features-repo&lt;/directory>
+            &lt;outputDirectory>/system&lt;/outputDirectory>
+        &lt;/fileSet>
+
+    &lt;/fileSets>
+
+    &lt;files>
+        &lt;file>
+            &lt;source>/x1/asf/karaf-2.2.x/target/checkout/manual/target/dependencies/apache-karaf-2.2.4/bin/karaf&lt;/source>
+            &lt;outputDirectory>/bin/&lt;/outputDirectory>
+            &lt;destName>my-custom&lt;/destName>
+            &lt;fileMode>0755&lt;/fileMode>
+            &lt;lineEnding>unix&lt;/lineEnding>
+        &lt;/file>
+        &lt;file>
+            &lt;source>/x1/asf/karaf-2.2.x/target/checkout/manual/target/classes/features.xml&lt;/source>
+            &lt;outputDirectory>/system/my.groupid/my-features/2.2.4&lt;/outputDirectory>
+            &lt;destName>my-features-2.2.4-features.xml&lt;/destName>
+            &lt;fileMode>0644&lt;/fileMode>
+            &lt;lineEnding>unix&lt;/lineEnding>
+        &lt;/file>
+    &lt;/files>
+
+&lt;/assembly>
+</pre><p>To build your custom Karaf distribution, just run:</p><pre>
+mvn install
+</pre><p>You will find your Karaf custom distribution tar.gz in the target directory.</p><h2 id="Roadmap">Roadmap</h2><p>A distribution goal is in preparation in the next Karaf</p><h2 id="Customdistributionexamples">Custom distribution examples</h2><ul><li><a href="http://svn.apache.org/repos/asf/servicemix/smx4/features/trunk/assembly/">Apache ServiceMix 4</a></li><li><a href="http://svn.apache.org/repos/asf/servicemix/smx4/nmr/trunk/assembly/">Apache ServiceMix NMR</a></li><li><a href="http://buildprocess.svn.sourceforge.net/viewvc/buildprocess/builderaser/trunk/assembly/">BuildProcess BuildEraser</a></li></ul>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/debugging.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/debugging.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/debugging.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/debugging.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,89 @@
+
+<!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="TroubleshootingDebuggingProfilingandMonitoring">Troubleshooting, Debugging, Profiling, and Monitoring</h1><h2 id="Troubleshooting">Troubleshooting</h2><h3 id="Logging">Logging</h3><p>Logging is easy to control through the console, with commands grouped under <em>log</em> shell. To learn about the available logging commands type:</p><pre>
+karaf@root> log&lt;tab>
+
+log:display              log:display-exception    log:get                  log:set
+karaf@root>
+</pre><p>Typical usage is:</p> <p> # Use <tt>log:set</tt> to dynamically change the global log level<br/> # Execute the problematic operation<br/> # Use <tt>log:display</tt> (or <tt>log:display-exception</tt> to display the log </p> <h3 id="WorstCaseScenario">Worst Case Scenario</h3><p>If you end up with a Karaf in a really bad state (i.e. you can not boot it anymore) or you just want to revert to a clean state quickly, you can safely remove the <tt>data</tt> directory in the installation directory.  This folder contains transient data and will be recreated if removed when you relaunch Karaf.<br/>You may also want to remove the files in the <tt>deploy</tt> folder to avoid them being automatically installed when Karaf is started the first time.</p><h2 id="Debugging">Debugging</h2><p>Usually, the easiest way to debug Karaf or any application deployed onto it is to use remote debugging.<br/>Remote debugging can be easily activated by using the <tt>debug</tt> parameter on the co
 mmand line.</p><pre>> bin/karaf debug
+{noformat
+or on Windows
+</pre><p>> bin\karaf.bat debug<br/>{noformat</p><p>Another option is to set the <tt>KARAF_DEBUG</tt> environment variable to <tt>TRUE</tt>.</p><p>This can be done using the following command on Unix systems:</p><pre>export KARAF_DEBUG=true
+</pre><p>On Windows, use the following command</p><pre>set KARAF_DEBUG=true
+</pre><p>Then, you can launch Karaf using the usual way:</p><pre>bin/karaf
+</pre><p>or</p><pre>bin\karaf.bat
+</pre><p>Last, inside your IDE, connect to the remote application (the default port to connect to is 5005).</p><p>This option works fine when it is needed to debug a project deployed top of Apache Karaf. Nevertheless, you will be blocked <br/>if you would like to debug the server Karaf. In this case, you can change the following parameter suspend=y in the <br/>karaf.bat script file. That will cause the JVM to pause just before running main() until you attach a debugger then it <br/>will resume the execution.  This way you can set your breakpoints anywhere in the code and you should be able to hit them<br/>no matter how early in the startup they are.  </p><pre>
+export DEFAULT_JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005'
+</pre><p>and on Windows,</p><pre>
+set DEFAULT_JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005'
+</pre><h2 id="Profiling">Profiling</h2><h3 id="YourKit">YourKit</h3><p>You need a few steps to be able to profile Karaf using YourKit.<br/>The first one is to edit the <tt>etc/config.properties</tt> configuration file and add the following property:</p><pre>org.osgi.framework.bootdelegation=com.yourkit.*
+</pre><p>Then, set the <tt>JAVA_OPTS</tt> environment variable:</p><pre>export JAVA_OPTS='-Xmx512M -agentlib:yjpagent'
+</pre><p>or, on Windows</p><pre>set JAVA_OPTS='-Xmx512M -agentlib:yjpagent'
+</pre><p>Run Karaf from the console, and you should now be able to connect using YourKit standalone or from your favorite IDE.</p><h2 id="Monitoring">Monitoring</h2><p>Karaf uses JMX for monitoring and management of all Karaf components.</p><p>The JMX connection could be:</p><ul><li>local using the process id</li></ul><p><img border="1" src="../../images/jconsole_connect.jpg"/></p><ul><li>remote using the <tt>rmiRegistryPort</tt> property defined in <tt>etc/org.apache.karaf.management.cfg</tt> file.</li></ul><p>Using JMX, you can have a clean overview of the running Karaf instance:</p><ul><li>A overview with graphics displaying the load in terms of thread, heap/GC, etc:</li></ul><p><img border="1" src="../../images/jconsole_overview.jpg"/></p><ul><li>A thread overview:</li></ul><p><img border="1" src="../../images/jconsole_threads.jpg"/></p><ul><li>A memory heap consumption, including "Perform GC" button:</li></ul><p><img border="1" src="../../images/jconsole_memory.jpg"/></
 p><ul><li>A complete JVM summary, with all number of threads, etc:</li></ul><p><img border="1" src="../../images/jconsole_summary.jpg"/></p><p>You can manage Karaf features like you are in the shell. For example, you have access to the Admin service MBean, allowing you to create, rename, destroy, change SSH port, etc. Karaf instances:</p><p><img border="1" src="../../images/jconsole_admin.jpg"/></p><p>You can also manage Karaf features MBean to list, install, and uninstall Karaf features:</p><p><img border="1" src="../../images/jconsole_features.jpg"/></p>
\ No newline at end of file

Added: servicemix/site/production/docs/4.4.x/karaf/developers-guide/developer-commands.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/4.4.x/karaf/developers-guide/developer-commands.html?rev=1388647&view=auto
==============================================================================
--- servicemix/site/production/docs/4.4.x/karaf/developers-guide/developer-commands.html (added)
+++ servicemix/site/production/docs/4.4.x/karaf/developers-guide/developer-commands.html Fri Sep 21 19:45:57 2012
@@ -0,0 +1,150 @@
+
+<!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="Developercommands">Developer commands</h1><p>Karaf provides a set of commands specific for developer use.</p><p>They allow for getting detailed detailed information about the Karaf instance and the applications running in them.</p><h2 id="Diagnosticdumpcommand">Diagnostic dump command</h2><p>Karaf provides a <tt>dev:create-dump</tt> command which creates a dump files containing diagnostic information. The dumps can be<br/>packaged in a zip archive (default) or directly into a given directory.</p><pre>
+karaf@root> dev:create-dump
+Diagnostic dump created.
+</pre><p>The previous command generates a zip archive in the KARAF_HOME (by default the name is the generation timestamp).</p><p>The following dumps are available in the zip archive:</p><ul><li><tt>features.txt</tt> provides an overview of the features. It means:<ul><li>the repository list</li><li>the feature list including bundles URL</li></ul></li><li><tt>bundles.txt</tt> provides an overview of the installed bundles, with the ID and the state of each bundle.</li><li><tt>threads.txt</tt> provides a complete threads dump. It describe all threads running in Karaf and their current state (blocked,<p>waiting, etc) with the associated class hierarchy.</p><p>These dumps are very helpful when you would like to take a snapshot of a current Karaf running instance.</p><h2 id="Dynamicimport">Dynamic import</h2><p>The <tt>dev:dynamic-import</tt> command allows you to enable or disable the dynamic import of a given bundle:</p><pre>
+karaf@root> dev:dynamic-import 41
+Enabling dynamic imports on bundle org.apache.karaf.shell.config [41]
+</pre></li></ul><h2 id="OSGiframework">OSGi framework</h2><p>The <tt>dev:framework</tt> command shows you the current OSGi framework in use, and enables debugging of the underlying OSGi framework.</p><pre>
+karaf@root> dev:framework
+Current OSGi framework is Felix
+karaf@root> dev:framework -debug
+Enabling debug for OSGi framework (Felix)
+- set felix.log.level=4 in etc/config.properties
+
+Restart Karaf now to enable Felix debug logging
+karaf@root> dev:framework -nodebug
+Disabling debug for OSGi framework (Felix)
+- removed felix.log.level from etc/config.properties
+
+Restart Karaf now to disable Felix debug logging
+</pre><h2 id="Printstacktrace">Print stack trace</h2><p>The <tt>dev:print-stack-traces</tt> command prints the full stack trace in the console when the execution of a command<br/>throws an exception.</p><p>You can enable or disable this behavior by passing true (to enable) or false (to disable) on the command on the fly:</p><pre>
+karaf@root> dev:print-stack-traces
+karaf@root> osgi:start
+Error executing command osgi:start: argument ids is required
+org.apache.felix.gogo.commands.CommandException: Argument ids is required
+        at org.apache.felix.gogo.commands.basic.DefaultActionPreparator.prepare(DefaultActionPreparator.java:284)
+        at org.apache.felix.gogo.commands.basic.AbstractCommand.execute(AbstractCommand.java:34)
+        at org.apache.felix.gogo.runtime.CommandProxy.execute(CommandProxy.java:78)
+        at org.apache.felix.gogo.runtime.Closure.executeCmd(Closure.java:474)
+        at org.apache.felix.gogo.runtime.Closure.executeStatement(Closure.java:400)
+        at org.apache.felix.gogo.runtime.Pipe.run(Pipe.java:108)
+        at org.apache.felix.gogo.runtime.Closure.execute(Closure.java:183)
+        at org.apache.felix.gogo.runtime.Closure.execute(Closure.java:120)
+        at org.apache.felix.gogo.runtime.CommandSessionImpl.execute(CommandSessionImpl.java:79)
+        at org.apache.karaf.shell.console.jline.Console.run(Console.java:180)
+        at java.lang.Thread.run(Thread.java:619)
+karaf@root> dev:print-stack-traces false
+karaf@root> osgi:start
+Error executing command osgi:start: argument ids is required
+</pre><h2 id="Karafrestart">Karaf restart</h2><p>The <tt>dev:restart</tt> command allows you to restart the running Karaf instance:</p><pre>
+karaf@root> dev:restart
+karaf@root>
+        __ __                  ____
+       / //_/____ __________ _/ __/
+      / ,&lt;  / __ `/ ___/ __ `/ /_
+     / /| |/ /_/ / /  / /_/ / __/
+    /_/ |_|\__,_/_/   \__,_/_/
+
+  Apache Karaf (2.1.99-SNAPSHOT)
+
+Hit '&lt;tab>' for a list of available commands
+and '[cmd] --help' for help on a specific command.
+Hit '&lt;ctrl-d>' or 'osgi:shutdown' to shutdown Karaf.
+
+karaf@root>
+</pre><h2 id="Bundletree">Bundle tree</h2><p>The <tt>dev:show-tree</tt> command shows the bundle dependency tree based on the wiring information of a given single bundle ID.</p><pre>
+karaf@root> dev:show-tree 40
+Bundle org.apache.karaf.diagnostic.command [40] is currently ACTIVE
+
+org.apache.karaf.diagnostic.command [40]
++- org.apache.aries.blueprint [10]
+|  +- org.apache.aries.util [8]
+|  +- org.apache.felix.configadmin [5]
+|  +- org.apache.aries.proxy [7]
+|  |  +- org.apache.aries.util [8]
+|  |  +- org.apache.servicemix.bundles.asm [9]
+|  |  +- org.ops4j.pax.logging.pax-logging-api [3]
+|  +- org.ops4j.pax.logging.pax-logging-api [3]
++- org.apache.karaf.shell.console [22]
+|  +- org.apache.aries.blueprint [10]
+|  +- org.ops4j.pax.logging.pax-logging-api [3]
+|  +- org.apache.karaf.jaas.modules [13]
+|     +- org.apache.aries.blueprint [10]
+|     +- org.apache.felix.configadmin [5]
+|     +- org.apache.karaf.jaas.config [29]
+|     |  +- org.apache.aries.blueprint [10]
+|     |  +- org.ops4j.pax.logging.pax-logging-api [3]
+|     +- org.ops4j.pax.logging.pax-logging-api [3]
++- org.apache.karaf.diagnostic.core [23]
+</pre><h2 id="Watchingandupdatingbundle">Watching and updating bundle</h2><p>The <tt>dev:watch</tt> watches and updates bundles. It's especially helpful in development mode.</p><p>It allows you to configure a set of URLs that will be monitored. All bundles whose location matches the given URL will be<br/>automatically updated. This avoids needing to manually update the bundles or even copy the bundles to the system folder.</p><p>Note that only Maven based URLs and Maven SNAPSHOTs will actually be updated automatically, so if you do:</p><pre>
+karaf@root> dev:watch *
+</pre><p>it will actually monitor all bundles that have a location matching mvn:* that have '-SNAPSHOT' in their URL.</p>
\ No newline at end of file



Mime
View raw message