Added: servicemix/site/production/docs/7.x/developers-guide/custom-distribution.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/custom-distribution.html?rev=1730131&view=auto ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/custom-distribution.html (added) +++ servicemix/site/production/docs/7.x/developers-guide/custom-distribution.html Fri Feb 12 22:27:08 2016 @@ -0,0 +1,447 @@ + +<!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="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><p>branding to change the Karaf console look-and-feel</p></li><li><p>configuration files (in the etc folder) altered to your requirements</p></li><li><p>pre-packaged artifacts in the deploy folder</p></li><li><p>a pre-populated system repository (containing your own bundle and features descriptor)</p></li><li><p>renamed or specific scripts in the bin folder</p></li><li><p>system documentation files</p></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 other 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> +<?xml version="1.0" encoding="UTF-8"?> +<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";> + + <groupId>my.company</groupId> + <artifactId>mycustom-karaf</artifactId> + <version>1.0</version> + <packaging>pom</packaging> + <name>My Unix Custom Karaf Distribution</name> + + <properties> + <karaf.version>2.2.2</karaf.version> + </properties> + + <dependencies> + <dependency> + <groupId>org.apache.karaf</groupId> + <artifactId>apache-karaf</artifactId> + <version>2.3.0</version> + <type>tar.gz</type> + </dependency> + <dependency> + <groupId>org.apache.karaf.assemblies.features</groupId> + <artifactId>standard</artifactId> + <version>2.3.0</version> + <type>xml</type> + <classifier>features</classifier> + </dependency> + </dependencies> + + <build> + <resources> + <resource> + <directory>/x1/asf/karaf-2.3.x/target/checkout/manual/src/main/filtered-resources</directory> + <filtering>true</filtering> + <includes> + <include>**/*</include> + </includes> + </resource> + </resources> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-resources-plugin</artifactId> + <executions> + <execution> + <id>filter</id> + <phase>generate-resources</phase> + <goals> + <goal>resources</goal> + </goals> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.apache.karaf.tooling</groupId> + <artifactId>features-maven-plugin</artifactId> + <version>2.3.0</version> + <executions> + <execution> + <id>add-features-to-repo</id> + <phase>generate-resources</phase> + <goals> + <goal>add-features-to-repo</goal> + </goals> + <configuration> + <descriptors> + <descriptor>mvn:org.apache.karaf.assemblies.features/standard/2.3.0/xml/features</descriptor> + <descriptor>file:/x1/asf/karaf-2.3.x/target/checkout/manual/target/classes/my-features.xml</descriptor> + </descriptors> + <features> + <feature>my-feature</feature> + </features> + </configuration> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-dependency-plugin</artifactId> + <executions> + <execution> + <id>copy</id> + <phase>generate-resources</phase> + <goals> + <goal>copy</goal> + </goals> + <configuration> + <!-- Define here the artifacts which should be considered in the assembly --> + <!-- For instance, the branding jar --> + <artifactItems> + <artifactItem> + <groupId>my.groupId</groupId> + <artifactId>my.branding.id</artifactId> + <version>1.0</version> + <outputDirectory>target/dependencies</outputDirectory> + <destFileName>mybranding.jar</destFileName> + </artifactItem> + </artifactItems> + </configuration> + </execution> + <execution> + <!-- Uncompress the standard Karaf distribution --> + <id>unpack</id> + <phase>generate-resources</phase> + <goals> + <goal>unpack</goal> + </goals> + <configuration> + <artifactItems> + <artifactItem> + <groupId>org.apache.karaf</groupId> + <artifactId>apache-karaf</artifactId> + <type>tar.gz</type> + <outputDirectory>target/dependencies</outputDirectory> + </artifactItem> + </artifactItems> + </configuration> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-assembly-plugin</artifactId> + <executions> + <execution> + <id>bin</id> + <phase>package</phase> + <goals> + <goal>single</goal> + </goals> + <configuration> + <descriptors> + <descriptor>src/main/descriptors/bin.xml</descriptor> + </descriptors> + <appendAssemblyId>false</appendAssemblyId> + <tarLongFileMode>gnu</tarLongFileMode> + </configuration> + </execution> + </executions> + </plugin> + </plugins> + </build> + +</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><p>pom.xml: the previous POM file</p></li><li><p>src/main/descriptors/bin.xml: the assembly maven plugin descriptor (see below)</p></li><li><p>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.</p></li><li><p>src/main/distribution: contains all raw files which will be copied as-is into your custom distribution.</p></li></ul><p>For instance, <tt>src/main/filtered-resources</tt> could contain:</p><ul><li><p><tt>my-features.xml</tt> where maven properties will be replaced</p></li><li><p><tt>etc/org.apache.karaf.features.cfg</tt> file containing your my-features descriptor:</p><pre> +# +# Comma separated list of features repositories to register by default +# +featuresRepositories=mvn:org.apache.karaf/apache-karaf/2.3.0/xml/features,mvn:my.groupId/my-features/2.3.0/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><p>etc/org.ops4j.pax.logging.cfg</p><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><p>etc/system.properties</p><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><p>etc/users.properties</p><pre> +admin=admin,admin +</pre></li><li><p>You can add a <tt>etc/custom.properties</tt>, it's a placeholder for any override you may need. For instance:</p><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> +<assembly> + + <id>bin</id> + + <formats> + <format>tar.gz</format> + </formats> + + <fileSets> + + <!-- Expanded Karaf Standard Distribution --> + <fileSet> + <directory>target/dependencies/apache-karaf-2.3.0</directory> + <outputDirectory>/</outputDirectory> + <excludes> + <exclude>**/demos/**</exclude> + <exclude>bin/**</exclude> + <exclude>etc/system.properties</exclude> + <exclude>etc/users.properties</exclude> + <exclude>etc/org.apache.karaf.features.cfg</exclude> + <exclude>etc/org.ops4j.pax.logging.cfg</exclude> + <exclude>LICENSE</exclude> + <exclude>NOTICE</exclude> + <exclude>README</exclude> + <exclude>RELEASE-NOTES</exclude> + <exclude>karaf-manual*.html</exclude> + <exclude>karaf-manual*.pdf</exclude> + </excludes> + </fileSet> + + <!-- Copy over bin/* separately to get the correct file mode --> + <fileSet> + <directory>target/dependencies/apache-karaf-2.3.0</directory> + <outputDirectory>/</outputDirectory> + <includes> + <include>bin/admin</include> + <include>bin/karaf</include> + <include>bin/start</include> + <include>bin/stop</include> + </includes> + <fileMode>0755</fileMode> + </fileSet> + + <!-- Copy over jar files --> + <fileSet> + <directory>target/dependencies</directory> + <includes> + <include>my-custom.jar</include> + </includes> + <outputDirectory>/lib/</outputDirectory> + </fileSet> + + <fileSet> + <directory>src/main/distribution</directory> + <outputDirectory>/</outputDirectory> + <fileMode>0644</fileMode> + </fileSet> + <fileSet> + <directory>target/classes/etc</directory> + <outputDirectory>/etc/</outputDirectory> + <lineEnding>unix</lineEnding> + <fileMode>0644</fileMode> + </fileSet> + + <fileSet> + <directory>target/features-repo</directory> + <outputDirectory>/system</outputDirectory> + </fileSet> + + </fileSets> + + <files> + <file> + <source>/x1/asf/karaf-2.3.x/target/checkout/manual/target/dependencies/apache-karaf-2.3.0/bin/karaf</source> + <outputDirectory>/bin/</outputDirectory> + <destName>my-custom</destName> + <fileMode>0755</fileMode> + <lineEnding>unix</lineEnding> + </file> + <file> + <source>/x1/asf/karaf-2.3.x/target/checkout/manual/target/classes/features.xml</source> + <outputDirectory>/system/my.groupid/my-features/2.3.0</outputDirectory> + <destName>my-features-2.3.0-features.xml</destName> + <fileMode>0644</fileMode> + <lineEnding>unix</lineEnding> + </file> + </files> + +</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><p><a href="http://svn.apache.org/repos/asf/servicemix/smx4/features/trunk/assembly/";>Apache ServiceMix 4</a></p></li><li><p><a href="http://svn.apache.org/repos/asf/servicemix/smx4/nmr/trunk/assembly/";>Apache ServiceMix NMR</a></p></li><li><p><a href="http://buildprocess.svn.sourceforge.net/viewvc/buildprocess/builderaser/trunk/assembly/";>BuildProcess BuildEraser</a></p></li></ul> + </div> + + </div> + <div id="siteFooter"> + © 2008-2014 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/7.x/developers-guide/debugging.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/debugging.html?rev=1730131&view=auto ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/debugging.html (added) +++ servicemix/site/production/docs/7.x/developers-guide/debugging.html Fri Feb 12 22:27:08 2016 @@ -0,0 +1,127 @@ + +<!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="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<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 command li ne.</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><p>local using the process id</p></li></ul><p>!/images/jconsole_connect.jpg</p>|border=1!<ul><li><p>remote using the <tt>rmiRegistryPort</tt> property defined in <tt>etc/org.apache.karaf.management.cfg</tt> file.</p></li></ul><p>Using JMX, you can have a clean overview of the running Karaf instance:</p><ul><li><p>A overview with graphics displaying the load in terms of thread, heap/GC, etc:</p></li></ul><p>!/images/jconsole_overview.jpg</p>|border=1!<ul><li><p>A thread overview:</p></li></ul><p>!/images/jconsole_threads.jpg</p>|border=1!<ul><li><p>A memory heap consumption, including "Perform GC" button:</p></li></ul><p>!/images/jconsole_memory.jpg</p>|border=1!<ul><li><p>A complete JVM summary, with all number of threads, etc:</p></li></ul><p>!/images/jconsole_summary.jpg</p>|border=1!<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>!/images/jconsole_admin.jpg</p>|border=1!<p>You can also manage Karaf features MBean to list, install, and uninstall Karaf features:</p><p>!/images/jconsole_features.jpg</p>|border=1! + </div> + + </div> + <div id="siteFooter"> + © 2008-2014 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 Modified: servicemix/site/production/docs/7.x/developers-guide/developer-commands.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/developer-commands.html?rev=1730131&r1=1730130&r2=1730131&view=diff ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/developer-commands.html (original) +++ servicemix/site/production/docs/7.x/developers-guide/developer-commands.html Fri Feb 12 22:27:08 2016 @@ -94,133 +94,87 @@ </ul> </div> <div id="body"> - <h1 id="Developercommands">Developer commands</h1><p>As you can see in the users guide, Apache Karaf is an enterprise ready OSGi container.</p><p>It's also a container designed to simplify the life for developers and administrators to get details about the<br/>running container.</p><h2 id="Dump">Dump</h2><p>If you encounter issues like performance degradations, weird behaviour, it could be helpful to have a kind of snapshot<br/>about the current activity of the container.</p><p>The <tt>dev:dump-create</tt> command creates a dump file containing:</p><ul><li><p>the <tt>bundles.txt</tt> file contains the list of all OSGi bundles, with id, symbolic name, version, current status</p></li><li><p>the <tt>environment.txt</tt> file contains details about Apache Karaf, OSGi framework, Operating System, JVM, system<br/> properties, threads count, classes loaded</p></li><li><p>the <tt>features.txt</tt> file contains the list of Apache Karaf features repositories, fe atures with version, current<br/> status, and bundles provided.</p></li><li><p>the <tt>threads.txt</tt> file contains a thread dump, with all threads, waiting status, etc.</p></li><li><p>the <tt>log</tt> folder contains the <tt>data/log</tt> folder, with all log files.</p></li></ul><p>By default, the <tt>dev:dump-create</tt> command creates a zip file in the <tt>KARAF_BASE</tt> folder, with the timestamp of the<br/>dump creation:</p><pre> -karaf@root()> dev:dump-create + <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>We can see the file generated in the <tt>KARAF_BASE</tt> folder:</p><pre> -$ cd /opt/apache-karaf-3.0.0 -$ ls -lh *.zip --rw-r--r-- 1 user group 11K Dec 23 16:08 2013-12-23_160858.zip -</pre><p>You can specify the file name of the zip archive:</p><pre> -karaf@root()> dev:dump-create mydump.zip -Diagnostic dump created. -</pre><p>Instead of a zip archive, you can create the dump (exploded) in a directory using the <tt>-d</tt> (<tt>--directory</tt>) option:</p><pre> -karaf@root()> dev:dump-create -d /tmp/mydump -Diagnostic dump created. -</pre><h2 id="Diagnostic">Diagnostic</h2><p>It's not always easy for the developers to understand why a bundle is not active.</p><p>It could be because the Activator failed, the Blueprint container start failed, etc.</p><p>The <tt>bundle:diag</tt> command gives you details about a bundle is not active:</p><pre> -karaf@root()> bundle:diag -Apache ServiceMix :: Bundles :: avro-ipc (81) ---------------------------------------------- -Status: Installed -Unsatisfied Requirements: -[81.0] osgi.wiring.package; (&(osgi.wiring.package=javax.servlet)(version>=2.5.0)(!(version>=3.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=javax.servlet.http)(version>=2.5.0)(!(version>=3.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.data)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.file)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.generic)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.io)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.reflect)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.specific)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.apache.avro.util)(version>=1.7.0)(!(version>=2.0.0))) -[81.0] osgi.wiring.package; (osgi.wiring.package=org.apache.velocity) -[81.0] osgi.wiring.package; (osgi.wiring.package=org.apache.velocity.app) -[81.0] osgi.wiring.package; (osgi.wiring.package=org.apache.velocity.context) -[81.0] osgi.wiring.package; (osgi.wiring.package=org.apache.velocity.exception) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.bootstrap)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.buffer)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.channel)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.channel.group)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.channel.socket.nio)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.handler.codec.frame)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.handler.codec.oneone)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.jboss.netty.handler.execution)(version>=3.4.0)(!(version>=4.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.mortbay.jetty)(version>=6.1.0)(!(version>=7.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.mortbay.jetty.bio)(version>=6.1.0)(!(version>=7.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.mortbay.jetty.nio)(version>=6.1.0)(!(version>=7.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.mortbay.jetty.servlet)(version>=6.1.0)(!(version>=7.0.0))) -[81.0] osgi.wiring.package; (&(osgi.wiring.package=org.mortbay.resource)(version>=6.1.0)(!(version>=7.0.0))) -</pre><h2 id="Dynamicimport">Dynamic import</h2><p>The <tt>bundle:dynamic-import</tt> command allows you to enable or disable the dynamic import of a given bundle:</p><pre> -karaf@root()> bundle:dynamic-import 77 -Enabling dynamic imports on bundle org.apache.karaf.config.core [77] -</pre><p>The purpose of dynamic import is to allow a bundle to be wired up to packages that may not be knwon about in advance.<br/>When a class is requested, if it cannot be solved via the bundle's existing imports, the dynamic import allows other<br/>bundles to be considered for a wiring import to be added.</p><p>The <tt>bundle:dynamic-import</tt> command allows or doesn't allow this behaviour.</p><h2 id="OSGiframework">OSGi framework</h2><p>The <tt>system:framework</tt> command allows to display the current OSGi framework in use, and enable/disable debugging inside the OSGi framework.</p><pre> -karaf@root()> system:framework -Current OSGi framework is felix -karaf@root()> system:framework -debug -Enabling debug for OSGi framework (felix) -karaf@root()> system:framework -nodebug -Disabling debug for OSGi framework (felix) -</pre><h2 id="Stacktracesprintout">Stack traces printout</h2><p>The <tt>shell:stack-traces-print</tt> command prints the full stack trace when the execution of a command<br/>throws an exception.</p><p>You can enable or disable this behaviour by passing true (to enable) or false (to disable) on the command on the fly:</p><pre> -karaf@root()> stack-traces-print -Printing of stacktraces set to true -karaf@root()> bundle:start -java.lang.RuntimeException: Access to system bundle 0 denied. You can override with -f - at org.apache.karaf.bundle.command.BundlesCommand.assertNoSystemBundles(BundlesCommand.java:57) - at org.apache.karaf.bundle.command.BundlesCommand.doExecute(BundlesCommand.java:48) - at org.apache.karaf.bundle.command.BundlesCommandWithConfirmation.doExecute(BundlesCommandWithConfirmation.java:41) - at org.apache.karaf.shell.console.AbstractAction.execute(AbstractAction.java:33) - at org.apache.karaf.shell.console.OsgiCommandSupport.execute(OsgiCommandSupport.java:39) - at org.apache.karaf.shell.commands.basic.AbstractCommand.execute(AbstractCommand.java:33) - at sun.reflect.GeneratedMethodAccessor30.invoke(Unknown Source) - at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) - at java.lang.reflect.Method.invoke(Method.java:601) - at org.apache.aries.proxy.impl.ProxyHandler$1.invoke(ProxyHandler.java:54) - at org.apache.aries.proxy.impl.ProxyHandler.invoke(ProxyHandler.java:119) - at org.apache.karaf.shell.console.commands.$BlueprintCommand14083304.execute(Unknown Source) - at sun.reflect.GeneratedMethodAccessor30.invoke(Unknown Source) - at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) - at java.lang.reflect.Method.invoke(Method.java:601) - at org.apache.aries.proxy.impl.ProxyHandler$1.invoke(ProxyHandler.java:54) - at org.apache.aries.proxy.impl.ProxyHandler.invoke(ProxyHandler.java:119) - at org.apache.karaf.shell.console.commands.$BlueprintCommand14083304.execute(Unknown Source) +</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><p><tt>features.txt</tt> provides an overview of the features. It means:</p><ul><li><p>the repository list</p></li><li><p>the feature list including bundles URL</p></li></ul></li><li><p><tt>bundles.txt</tt> provides an overview of the installed bundles, with the ID and the state of each bundle.</p></li><li><p><tt>threads.txt</tt> provides a complete threads dump. It describe all threads running in Karaf and their current state (blocked,<br/>waiting, etc) with the associated class hierarchy.</p></li></ul><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><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:477) - at org.apache.felix.gogo.runtime.Closure.executeStatement(Closure.java:403) + 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:89) - at org.apache.karaf.shell.console.impl.jline.ConsoleImpl$DelegateSession.execute(ConsoleImpl.java:497) - at org.apache.karaf.shell.console.impl.jline.ConsoleImpl.run(ConsoleImpl.java:198) - at java.lang.Thread.run(Thread.java:722) - at org.apache.karaf.shell.console.impl.jline.ConsoleFactoryService$3.doRun(ConsoleFactoryService.java:118) - at org.apache.karaf.shell.console.impl.jline.ConsoleFactoryService$3$1.run(ConsoleFactoryService.java:109) - at java.security.AccessController.doPrivileged(Native Method) - at org.apache.karaf.jaas.modules.JaasHelper.doAs(JaasHelper.java:47) - at org.apache.karaf.shell.console.impl.jline.ConsoleFactoryService$3.run(ConsoleFactoryService.java:107) -karaf@root()> stack-traces-print false -Printing of stacktraces set to false -karaf@root()> bundle:start -Error executing command: Access to system bundle 0 denied. You can override with -f -</pre><h2 id="Bundletree">Bundle tree</h2><p>The <tt>bundle:tree-show</tt> command shows the bundle dependency tree based on the wiring information of a given single bundle<br/>ID.</p><pre> -karaf@root()> bundle:tree-show 40 -Bundle org.ops4j.pax.url.wrap [40] is currently ACTIVE - -org.ops4j.pax.url.wrap [40] -+- org.ops4j.base.util.property [14] -+- org.ops4j.pax.url.commons [49] -| +- org.ops4j.base.util.property [14] -| +- org.ops4j.pax.logging.pax-logging-api [23] -| +- org.ops4j.pax.swissbox.property [31] -| | +- org.ops4j.base.util.property [14] -| | +- org.ops4j.base.lang [41] -| +- org.apache.felix.configadmin [43] -| | +- org.ops4j.pax.logging.pax-logging-api [23] -| +- org.ops4j.base.lang [41] -+- org.ops4j.pax.logging.pax-logging-api [23] -+- org.ops4j.pax.swissbox.bnd [25] -| +- biz.aQute.bndlib [30] -| | +- org.apache.servicemix.bundles.junit [36] -| +- org.ops4j.pax.logging.pax-logging-api [23] -| +- org.ops4j.base.lang [41] -+- org.apache.felix.configadmin [43] -+- org.ops4j.base.net [29] -| +- org.ops4j.base.monitors [37] -| +- org.ops4j.base.lang [41] -+- org.ops4j.base.lang [41] -</pre><h2 id="Watch">Watch</h2><p>The <tt>bundle:watch</tt> command enables watching the local Maven repository for updates on bundles.<br/>If the bundle file changes on the Maven repository, Apache Karaf will automatically update the bundle.</p><p>The <tt>bundle:watch</tt> allows you to configure a set of URLs to monitore. All bundles bundles whose location matches the<br/>given URL will be automatically updated. It avoids needing to manually update the bundles or even copy the bundle to the<br/>system folder.</p><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Only Maven based URLs and Maven SNAPSHOTs will actually be updated automatically.</p></div><p>The following command:</p><pre> + 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> + __ __ ____ + / //_/____ __________ _/ __/ + / ,< / __ `/ ___/ __ `/ /_ + / /| |/ /_/ / / / /_/ / __/ + /_/ |_|\__,_/_/ \__,_/_/ + + Apache Karaf (2.1.99-SNAPSHOT) + +Hit '<tab>' for a list of available commands +and '[cmd] --help' for help on a specific command. +Hit '<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>will monitor all bundles that have a location matching mvn:* and '-SNAPSHOT' in their URL.</p> +</pre><p>it will actually monitor all bundles that have a location matching mvn:* that have '-SNAPSHOT' in their URL.</p> </div> </div> Added: servicemix/site/production/docs/7.x/developers-guide/extending-console.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/extending-console.html?rev=1730131&view=auto ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/extending-console.html (added) +++ servicemix/site/production/docs/7.x/developers-guide/extending-console.html Fri Feb 12 22:27:08 2016 @@ -0,0 +1,206 @@ + +<!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="Extendingtheconsole">Extending the console</h1><p>This chapter will guide you through the steps needed to extend the console and create a new shell. <br/>We will leverage Maven, Blueprint and OSGi, so you will need some knowledge of those products.</p><p>You may also find some information about the console at <a href="http://felix.apache.org/site/rfc-147-overview.html";>http://felix.apache.org/site/rfc-147-overview.html</a>.</p><h2 id="Createtheprojectusingmaven">Create the project using maven</h2><p>We first need to create a project using Maven. Let's leverage Maven archetypes for that.</p><h3 id="Commandline">Command line</h3><p>Using the command line, we can create our project:</p><pre> +mvn archetype:create \ + -DarchetypeArtifactId=maven-archetype-quickstart \ + -DgroupId=org.apache.karaf.shell.samples \ + -DartifactId=shell-sample-commands \ + -Dversion=1.0-SNAPSHOT +</pre><p>This generate the main <tt>pom.xml</tt> and some additional packages.</p><h3 id="Interactiveshell">Interactive shell</h3><p>You can also use the interactive mode for creating the skeleton project:</p><pre> +mvn archetype:generate +</pre><p>Use the following values when prompted:</p><pre> +Choose a number: (1/2/3/4/5/6/7/.../32/33/34/35/36) 15: : 15 +Define value for groupId: : org.apache.karaf.shell.samples +Define value for artifactId: : shell-sample-commands +Define value for version: 1.0-SNAPSHOT: : +Define value for package: : org.apache.karaf.shell.samples +</pre><h3 id="Manualcreation">Manual creation</h3><p>Alternatively, you can simply create the directory <tt>shell-sample-commands</tt> and create the <tt>pom.xml</tt> file inside it:</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project</span> <span class="na">xmlns=</span><span class="s">"http://maven.apache.org/POM/4.0.0"</span> <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span> <span class="na">xsi:schemaLocation=</span><span class="s">"http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"</span><span class="nt">></span>

 <span class="nt"><modelVersion></span>4.0.0<span class="nt"></modelVersion></span>

 <span class="nt"><groupId></span>org.apache.karaf.shell.samples<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>shell-sample-commands<span class="nt"><a rtifactId></span>
 <span class="nt"><packaging></span>bundle<span class="nt"></packaging></span>
 <span class="nt"><version></span>1.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"><name></span>shell-sample-commmands<span class="nt"></name></span>


 <span class="nt"><dependencies></span>
 <span class="nt"><dependency></span>
 <span class="nt"><groupId></span>org.apache.karaf.shell<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>org.apache.karaf.shell.console<span class="nt"></artifactId></span>
 <span class="nt"><version></span>2.3.0<span class="nt"></version></span>
 <span class="nt"></dependency></span>
 <span class="nt"><dependency></span>
 <span class="nt"><groupId></span>junit<span class="nt"></groupId></span >
 <span class="nt"><artifactId></span>junit<span >class="nt"></artifactId></span>
 <span >class="nt"><version></span>3.8.1<span >class="nt"></version></span>
 <span >class="nt"><scope></span>test<span >class="nt"></scope></span>
 <span >class="nt"></dependency></span>
 <span >class="nt"></dependencies></span>

 <span >class="nt"><build></span>
 <span >class="nt"><plugins></span>
 <span >class="nt"><plugin></span>
 <span >class="nt"><groupId></span>org.apache.felix<span >class="nt"></groupId></span>
 <span >class="nt"><artifactId></span>maven-bundle-plugin<span >class="nt"></artifactId></span>
 <span >class="nt"><version></span>2.3.7<span >class="nt"></version></span>
 <span >class="nt"><configuration></span>
 <span >class="nt"><in structions></span>
 <span class="nt"><Import-Package></span>
 org.apache.felix.service.command,
 org.apache.felix.gogo.commands,
 org.apache.karaf.shell.console,
 *
 <span class="nt"></Import-Package></span>
 <span class="nt"></instructions></span>
 <span class="nt"></configuration></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>

<span class="nt"></project></span>
</pre></div>
</div><h2 id="ConfiguringforJava5">Configuring for Java 5</h2><p>We are using annotations to define commands, so we need to ensure Maven will actually use JDK 1.5 to compile the jar.<br/>Just add the following snippet after the <tt>dependencies</tt> section.</p><div class="syntax"><div class="hig hlight"><pre><span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.maven.plugins<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>maven-compiler-plugin<span class="nt"></artifactId></span>
 <span class="nt"><configuration></span>
 <span class="nt"><target></span>1.5<span class="nt"></target></span>
 <span class="nt"><source></span>1.5<span class="nt"></source></span>
 <span class="nt"></configuration></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
<span class="nt"></build></span>
</pre></div>
</div><h2 id="LoadingtheprojectinyourIDE">Loading the project in your IDE</h2><p>We can use Maven to generate the needed file s for your IDE:</p><p>Inside the project, run the following command</p><pre> +mvn eclipse:eclipse +</pre><p>or</p><pre> +mvn idea:idea +</pre><p>The project files for your IDE should now be created. Just open the IDE and load the project.</p><h2 id="Creatingabasiccommandclass">Creating a basic command class</h2><p>We can now create the command class <tt>HelloShellCommand.java</tt></p><div class="syntax"><div class="highlight"><pre><span class="kn">package</span> <span class="nn">org.apache.karaf.shell.samples</span><span class="o">;</span>

<span class="kn">import</span> <span class="nn">org.apache.felix.gogo.commands.Command</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">org.apache.karaf.shell.console.OsgiCommandSupport</span><span class="o">;</span>

<span class="nd">@Command</span><span class="o">(</span><span class="n">scope</span> <span class="o">=</span> <span class="s">"test"</span><span class="o">,</span> <span class="n">name</span> <span class="o">=</span> <span class="s">"hello"</span><span class="o">,</span> <span clas s="n">description</span><span class="o">=</span><span class="s">"Says hello"</span><span class="o">)</span>
<span class="kd">public</span> <span class="kd">class</span> <span class="nc">HelloShellCommand</span> <span class="kd">extends</span> <span class="n">OsgiCommandSupport</span> <span class="o">{</span>

 <span class="nd">@Override</span>
 <span class="kd">protected</span> <span class="n">Object</span> <span class="nf">doExecute</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Executing Hello command"</span><span class="o">);</span>
 <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
 <span class="o">}</span>&#x 000A;<span class="o">}</span>
</pre></div>
</div><h2 id="Creatingtheassociatedblueprintconfigurationfiles">Creating the associated blueprint configuration files</h2><p>The blueprint configuration file will be used to create the command and register it in the OSGi registry, which is the way to make the command available to Karaf console. This blueprint file must be located in the <tt>OSGI-INF/blueprint/</tt> directory inside the bundle.</p><p>If you don't have the <tt>src/main/resources</tt> directory yet, create it.</p><pre> +mkdir src/main/resources +</pre><p>Then, re-generate the IDE project files and reload it so that this folder is now recognized as a source folder.</p><p>Inside this directory, create the <tt>OSGI-INF/blueprint/</tt> directory and put the following file inside (the name of this file has no impact at all):</p><div class="syntax"><div class="highlight"><pre><span class="nt"><blueprint</span> <span class="na">xmlns=</span><span class="s">"http://www.osgi.org/xmlns/blueprint/v1.0.0"</span><span class="nt">></span>

 <span class="nt"><command-bundle</span> <span class="na">xmlns=</span><span class="s">"http://karaf.apache.org/xmlns/shell/v1.0.0"</span><span class="nt">></span>
 <span class="nt"><command</span> <span class="na">name=</span><span class="s">"test/hello"</span><span class="nt">></span>
 <span class="nt"><action</span> <span class="na">class=</span><span class="s">"org.apache.karaf.shell.samples.Hel loShellCommand"</span><span class="nt">/></span>
 <span class="nt"></command></span>
 <span class="nt"></command-bundle></span>

<span class="nt"></blueprint></span>
</pre></div>
</div><h2 id="Compilingthejar">Compiling the jar</h2><p>Let's try to build the jar. Remove the test classes and sample classes if you used the artifact, then from the command line, run:</p><pre> +mvn install +</pre><p>The end of the maven output should look like:</p><pre> +[INFO] ------------------------------------------------------------------------ +[INFO] BUILD SUCCESSFUL +[INFO] ------------------------------------------------------------------------ +</pre><h2 id="TestinKaraf">Test in Karaf</h2><p>Launch a Karaf instance and run the following command to install the newly created bundle:</p><pre> +karaf@root> osgi:install -s mvn:org.apache.karaf.shell.samples/shell-sample-commands/1.0-SNAPSHOT +</pre><p>Let's try running the command:</p><pre> +karaf@root> test:hello +Executing Hello command +</pre><h1 id="Commandcompleter">Command completer</h1><p>A completer allows you to automatically complete a command argument using <tab>. A completer is simply a bean which is injected to a command.</p><p>Of course to be able to complete it, the command should require an argument.</p><h2 id="Commandargument">Command argument</h2><p>We add an argument to the HelloCommand:</p><pre> +package org.apache.karaf.shell.samples; + +import org.apache.felix.gogo.commands.Command; +import org.apache.felix.gogo.commands.Argument; +import org.apache.karaf.shell.console.OsgiCommandSupport; + +@Command(scope = "test", name = "hello", description="Says hello") +public class HelloShellCommand extends OsgiCommandSupport { + + @Argument(index = 0, name = "arg", description = "The command argument", required = false, multiValued = false) + String arg = null; + + @Override + protected Object doExecute() throws Exception { + System.out.println("Executing Hello command"); + return null; + } +} +</pre><p>The Blueprint configuration file is the same as previously.</p><h2 id="Completerbean">Completer bean</h2><p>A completer is a bean which implements the Completer interface:</p><pre> +package org.apache.karaf.shell.samples; + +import org.apache.karaf.shell.console.completer.StringsCompleter; +import org.apache.karaf.shell.console.Completer; + +/** + * <p> + * A very simple completer. + * </p> + */ +public class SimpleCompleter implements Completer { + + /** + * @param buffer the beginning string typed by the user + * @param cursor the position of the cursor + * @param candidates the list of completions proposed to the user + */ + public int complete(String buffer, int cursor, List candidates) { + StringsCompleter delegate = new StringsCompleter(); + delegate.getStrings().add("one"); + delegate.getStrings().add("two"); + delegate.getStrings().add("three"); + return delegate.complete(buffer, cursor, candidates); + } + +} +</pre><h2 id="Blueprintconfigurationfile">Blueprint configuration file</h2><p>Using Blueprint, you can "inject" the completer linked to your command. The same completer could be used for several commands and a command can have several completers:</p><pre> +<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0";> + + <command-bundle xmlns="http://karaf.apache.org/xmlns/shell/v1.0.0";> + <command name="test/hello"> + <action class="org.apache.karaf.shell.samples.HelloShellCommand"/> + <completers> + <ref component-id="simpleCompleter"/> + <null/> + </completers> + </command> + </command-bundle> + + <bean id="simpleCompleter" class="org.apache.karaf.shell.samples.SimpleCompleter"/> + +</blueprint> +</pre><h2 id="TestinKaraf2">Test in Karaf</h2><p>Launch a Karaf instance and run the following command to install the newly created bundle:</p><pre> +karaf@root> osgi:install -s mvn:org.apache.karaf.shell.samples/shell-sample-commands/1.0-SNAPSHOT +</pre><p>Let's try running the command:</p><pre> +karaf@root> test:hello <tab> + one two three +</pre> + </div> + + </div> + <div id="siteFooter"> + © 2008-2014 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/7.x/developers-guide/features-maven-plugin-add.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-add.html?rev=1730131&view=auto ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-add.html (added) +++ servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-add.html Fri Feb 12 22:27:08 2016 @@ -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="Goalfeaturesaddfeaturestorepo">Goal <tt>features:add-features-to-repo</tt></h2><p>The <tt>features:add-features-to-repo</tt> goal adds all the required bundles for a given set of features into directory. You can use this goal to create a <tt>/system</tt> directory for building your own Karaf-based distribution.</p><p>By default, the Karaf core features descriptors (standard and enterprise) are automatically included in the descriptors set.</p><h3 id="Example">Example</h3><p>The example below copies the bundles for the <tt>spring</tt> and <tt>war</tt> features defined in the Karaf features XML descriptor into the <tt>target/features-repo</tt> directory.</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>or g.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>features-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>2.3.0<span class="nt"></version></span>

 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>add-features-to-repo<span class="nt"></id></span>
 <span class="nt"><phase></span>generate-resources<span class="nt"></phase></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>add-features-to-repo<span class="nt"></goal></span>
 <span class="nt"></goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><descriptors></span>� A; <span class="nt"><descriptor></span>mvn:my.groupid/my.artifactid/1.0.0/xml/features<span class="nt"></descriptor></span>
 <span class="nt"></descriptors></span>
 <span class="nt"><features></span>
 <span class="nt"><feature></span>spring<span class="nt"></feature></span>
 <span class="nt"><feature></span>war<span class="nt"></feature></span>
 <span class="nt"><feature></span>my<span class="nt"></feature></span>
 <span class="nt"><feature></span>other/1.0-SNAPSHOT<span class="nt"></feature></span>
 <span class="nt"></features></span>
 <span class="nt"><repository></span>target/features-repo<span class="nt"></repository></span>
 <span class="nt"></configuration></span>
 <spa n class="nt"></execution></span>
 <span class="nt"></executions></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span> 
<span class="nt"></project></span>
</pre></div>
</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>descriptors</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of features XML descriptors where the features are defined <br/> NB: Karaf core features descriptors (standard and enterprise) are automatically added in this list </td></tr><tr><td class="confluenceTd"> <tt>features</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> List of fea tures that bundles should be copied to the repository directory. A feature could be just a feature name or a name/version. If it's just a name, the features-maven-plugin will take the first feature with the given name, whatever the version is. </td></tr><tr><td class="confluenceTd"> <tt>repository</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The directory where the bundles will be copied by the plugin goal </td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Target Karaf version to use to resolve the Karaf core features descriptors (standard and enterprise) </td></tr></table></div> + </div> + + </div> + <div id="siteFooter"> + © 2008-2014 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/7.x/developers-guide/features-maven-plugin-create-kar.html URL: http://svn.apache.org/viewvc/servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-create-kar.html?rev=1730131&view=auto ============================================================================== --- servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-create-kar.html (added) +++ servicemix/site/production/docs/7.x/developers-guide/features-maven-plugin-create-kar.html Fri Feb 12 22:27:08 2016 @@ -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="Goalfeaturescreatekar">Goal <tt>features:create-kar</tt></h2><p>The <tt>features:create-kar</tt> goal creates a kar file from a given features XML.<br/>A kar file is a zip archive shipping all bundles and configuration files containing in features of a features XML, and the features XML itself.<br/>You can deploy a kar file just by copying it in the deploy folder, all resources will be loaded from the kar file.</p><h3 id="Example">Example</h3><p>The example below generates a kar file from a given features XML. The generated kar will be in the target folder with the manual-2.3.0.kar name.</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>� 0A; <span class="nt"><artifactId></span>features-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>2.3.0<span class="nt"></version></span>
 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>create-kar<span class="nt"></id></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>create-kar<span class="nt"></goal></span>
 <span class="nt"></goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><featuresFile></span>/x1/asf/karaf-2.3.x/target/checkout/manual/src/main/resources/features.xml<span class="nt"></featuresFile></span>
 <span class="nt"></configuration></span>
 <span class="nt"></execution></span>
 <span class="nt"></executions></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</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>featuresFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML used to generate the KAR file <br/> Default value: <tt>/x1/asf/karaf-2.3.x/target/checkout/manual/target/feature/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> {{resourcesDir} </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Location of resources dire ctory for additional content to include in the KAR. Note that it includes everything under classes so as to include maven-remote-resources <br/> Default value: /x1/asf/karaf-2.3.x/target/checkout/manual/target/classes}} </td></tr><tr><td class="confluenceTd"> <tt>finalName</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Name of the generated kar <br/> Default value: <tt>manual-2.3.0</tt> </td></tr><tr><td class="confluenceTd"> <tt>outputDirectory</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Directory containing the generated archive <br/> Default value: <tt>/x1/asf/karaf-2.3.x/target/checkout/manual/target</tt> </td></tr></table></div> + </div> + + </div> + <div id="siteFooter"> + © 2008-2014 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
