You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2015/07/01 19:06:45 UTC
svn commit: r1688692 [21/30] - in
/karaf/site/production/manual/latest-3.0.x: ./ commands/ css/ css/scalate/
developers-guide/ images/ users-guide/
Added: karaf/site/production/manual/latest-3.0.x/quick-start.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-3.0.x/quick-start.html?rev=1688692&view=auto
==============================================================================
--- karaf/site/production/manual/latest-3.0.x/quick-start.html (added)
+++ karaf/site/production/manual/latest-3.0.x/quick-start.html Wed Jul 1 17:06:42 2015
@@ -0,0 +1,217 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="description goes here"/>
+ <meta name="keywords" content="keywords,goes,here"/>
+ <meta name="author" content="The Apache Karaf Team"/>
+ <link href="css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Apache Karaf 3.0.5-SNAPSHOT Guides
+ </title>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+<a href="http://karaf.apache.org/" title="A server side OSGi distribution">
+ <img border="0" src="images/karaf-logo.png" width="400px"></img>
+</a>
+ </td>
+ <td align="right" nowrap="">
+<a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+ <img border="0" src="images/asf-logo.png">
+</a>
+ </td>
+ </tr>
+ </table>
+
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p>
+<a href="index.html" title="Home">Home</a>
+|
+<a href="users-guide/index.html" title="Users Guide">Users Guide</a>
+|
+<a href="developers-guide/index.html" title="Developers Guide">Developers Guide</a>
+</p>
+
+
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Homeindex"><a href="index.html">Home</a></h3><ul style="list-style: square"><li><a href="overview.html">Overview</a></li><li><a href="quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="users-guide/installation.html">Installation</a></li><li><a href="users-guide/directory-structure.html">Directory structure</a></li><li><a href="users-guide/start-stop.html">Start, stop, restart, connect</a></li><li><a href="users-guide/wrapper.html">Integration in the operating system: the Service Wrapper</a></li><li><a href="users-guide/console.html">Console</a></li><li><a href="users-guide/remote.html">Remote</a></li><li><a href="users-guide/log.html">Log</a></li><li><a href="users-guide/configuration.html">Configuration</a></li><li><a href="users-guide/urls.html">Artifacts repositories and URLs</a></li><li><a href="users-guide/provisioning.html"
>Provisioning and features</a></li><li><a href="users-guide/deployers.html">Deployers</a></li><li><a href="users-guide/kar.html">KAR</a></li><li><a href="users-guide/instances.html">Instances</a></li><li><a href="users-guide/security.html">Security</a></li><li><a href="users-guide/obr.html">OBR</a></li><li><a href="users-guide/enterprise.html">Enterprise</a><ul><li><a href="users-guide/webcontainer.html">WebContainer (JSP/Servlet)</a></li><li><a href="users-guide/jndi.html">Naming (JNDI)</a></li><li><a href="users-guide/jta.html">Transaction (JTA)</a></li><li><a href="users-guide/jdbc.html">DataSource (JDBC)</a></li><li><a href="users-guide/jms.html">MOM (JMS)</a></li><li><a href="users-guide/jpa.html">Persistence (JPA)</a></li><li><a href="users-guide/ejb.html">EJB</a></li><li><a href="users-guide/cdi.html">CDI</a></li><li><a href="users-guide/failover.html">HA/failover and cluster</a></li></ul></li><li><a href="users-guide/monitoring.html">Monitoring and Management using JMX</a></
li><li><a href="users-guide/webconsole.html">WebConsole</a></li><li><a href="users-guide/tuning.html">Tuning</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="developers-guide/index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="developers-guide/developer-commands.html">Developer commands</a></li><li><a href="developers-guide/scripting.html">Scripting</a></li><li><a href="developers-guide/connect.html">Programmatically connect</a></li><li><a href="developers-guide/branding.html">Branding</a></li><li><a href="developers-guide/extending.html">Extending</a></li><li><a href="developers-guide/karaf-maven-plugin.html">Karaf Maven plugin</a></li><li><a href="developers-guide/custom-distribution.html">Custom distribution</a></li><li><a href="developers-guide/services.html">OSGi services</a></li><li><a href="developers-guide/creating-bundles.html">Create OSGi bundle</a></li><li><a href="developers-guide/blueprint.html">Blueprint</a></li><li><a hre
f="developers-guide/cdi.html">CDI</a></li><li><a href="developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="developers-guide/security-framework.html">Security Framework</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging, Profiling</a></li><li><a href="developers-guide/writing-tests.html">Integration testing</a></li><li><a href="developers-guide/github-contributions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="commands/commands.html">Commands</a></h3>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<h1 id="QuickStart">Quick Start</h1><p>This instructions should help you get Apache Karaf up and running in 5 to 15 minutes.</p><h2 id="Prerequisites">Prerequisites</h2><p>Karaf requires a Java SE 7 environment to run. Refer to <a href="http://www.oracle.com/technetwork/java/javase/">http://www.oracle.com/technetwork/java/javase/</a> for details on how to download and install Java SE 1.7 or greater.</p><ul><li>Open a Web browser and access the following URL: <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a></li><li>Download the binary distribution that matches your system (zip for windows, tar.gz for unixes) </li><li>Extract the archive a new folder on your hard drive; for example in c:\karaf - from now on this directory will be referenced as <KARAF_HOME>.</li></ul><h2 id="Starttheserver">Start the server</h2><p>Open a command line console and change the directory to <KARAF_HOME>. </p><p>To start the serve
r, run the following command in Windows:</p><pre>
+bin\karaf.bat
+</pre><p>respectively on Unix:</p><pre>
+bin/karaf
+</pre><p>You should see the following information on the command line console:</p><pre>
+ __ __ ____
+ / //_/____ __________ _/ __/
+ / ,< / __ `/ ___/ __ `/ /_
+ / /| |/ /_/ / / / /_/ / __/
+ /_/ |_|\__,_/_/ \__,_/_/
+
+ Apache Karaf (3.0.0)
+
+Hit '<tab>' for a list of available commands
+and '[cmd] --help' for help on a specific command.
+Hit '<ctrl-d>' or type 'system:shutdown' or 'logout' to shutdown Karaf.
+
+karaf@root()>
+
+</pre><h2 id="SomeshellBasics">Some shell Basics</h2><p>You can now run your first command. Simply type the <tt><tab></tt> key in the console.</p><pre>
+karaf@root> Display all 183 possibilities? (y or n)
+*:config *:dev *:feature *:instance *:jaas *:kar *:log *:package
+*:region *:service *:shell *:ssh addbundle addfilter addregion alias
+cancel cl clear clone config config:cancel config:delete config:edit
+config:list config:property-append config:property-delete config:property-list config:property-set config:update connect create
+date delete destroy dev dev:dump-create display dump-create each
+...
+</pre><p>You can then grab more specific help for a given command using the <tt>--help</tt> option for this command:</p><pre>
+karaf@root()> bundle:list --help
+DESCRIPTION
+ bundle:list
+
+ Lists all installed bundles.
+
+SYNTAX
+ bundle:list [options]
+
+OPTIONS
+ -u
+ Shows the update locations
+ --help
+ Display this help message
+ --table
+ Show bundles using a shell table
+ -t
+ Specifies the bundle threshold; bundles with a start-level less than this value will not get printed out.
+ -l
+ Show the locations
+ -s
+ Shows the symbolic name
+
+</pre><p>Note that the console supports tab completion so if your start typing a command it will show possible completions and also auto complete if there is only one completion.</p><h2 id="Deployasampleapplication">Deploy a sample application</h2><p>While you will learn in the Karaf user's guide how to fully use and leverage Apache Karaf, let's install a sample <a href="http://camel.apache.org">Apache Camel</a> application for now:</p><p>In the console, run the following commands:</p><pre>
+karaf@root()> feature:repo-add camel 2.10.0
+Adding feature url mvn:org.apache.camel.karaf/apache-camel/2.10.0/xml/features
+karaf@root()> feature:install camel-spring
+karaf@root()> bundle:install -s mvn:org.apache.camel/camel-example-osgi/2.10.1
+</pre><p>The example installed is using Camel to start a timer every 2 seconds and output a message on the console.<br/>The previous commands download the Camel features descriptor and install the example feature.</p><pre>
+>>>> SpringDSL set body: Fri Jan 07 11:59:51 CET 2011
+>>>> SpringDSL set body: Fri Jan 07 11:59:53 CET 2011
+>>>> SpringDSL set body: Fri Jan 07 11:59:55 CET 2011
+
+</pre><h3 id="Stoppinganduninstallingthesampleapplication">Stopping and uninstalling the sample application</h3><p>To stop this demo, run the following command:</p><pre>
+karaf@root()> bundle:stop org.apache.camel.camel-example-osgi
+</pre><h2 id="StoppingKaraf">Stopping Karaf</h2><p>To stop Karaf from the console, enter <tt>^D</tt> in the console:</p><pre>
+^D
+</pre><p>Alternatively, you can also run the following command:</p><pre>
+system:shutdown
+</pre><h3 id="CleaningtheKarafstate">Cleaning the Karaf state</h3><p>Normally Karaf remembers the features and bundles you installed and started. The reset Karaf into a clean state just delete the data directory when karaf is not running.</p><h2 id="Summary">Summary</h2><p>This document showed how simple it is to have Apache Karaf up and running and install a simple Apache Camel application.</p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation
+ <br/>
+ Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: karaf/site/production/manual/latest-3.0.x/update-notes.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-3.0.x/update-notes.html?rev=1688692&view=auto
==============================================================================
--- karaf/site/production/manual/latest-3.0.x/update-notes.html (added)
+++ karaf/site/production/manual/latest-3.0.x/update-notes.html Wed Jul 1 17:06:42 2015
@@ -0,0 +1,154 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="description goes here"/>
+ <meta name="keywords" content="keywords,goes,here"/>
+ <meta name="author" content="The Apache Karaf Team"/>
+ <link href="css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Apache Karaf 3.0.5-SNAPSHOT Guides
+ </title>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+<a href="http://karaf.apache.org/" title="A server side OSGi distribution">
+ <img border="0" src="images/karaf-logo.png" width="400px"></img>
+</a>
+ </td>
+ <td align="right" nowrap="">
+<a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+ <img border="0" src="images/asf-logo.png">
+</a>
+ </td>
+ </tr>
+ </table>
+
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p>
+<a href="index.html" title="Home">Home</a>
+|
+<a href="users-guide/index.html" title="Users Guide">Users Guide</a>
+|
+<a href="developers-guide/index.html" title="Developers Guide">Developers Guide</a>
+</p>
+
+
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Homeindex"><a href="index.html">Home</a></h3><ul style="list-style: square"><li><a href="overview.html">Overview</a></li><li><a href="quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="users-guide/installation.html">Installation</a></li><li><a href="users-guide/directory-structure.html">Directory structure</a></li><li><a href="users-guide/start-stop.html">Start, stop, restart, connect</a></li><li><a href="users-guide/wrapper.html">Integration in the operating system: the Service Wrapper</a></li><li><a href="users-guide/console.html">Console</a></li><li><a href="users-guide/remote.html">Remote</a></li><li><a href="users-guide/log.html">Log</a></li><li><a href="users-guide/configuration.html">Configuration</a></li><li><a href="users-guide/urls.html">Artifacts repositories and URLs</a></li><li><a href="users-guide/provisioning.html"
>Provisioning and features</a></li><li><a href="users-guide/deployers.html">Deployers</a></li><li><a href="users-guide/kar.html">KAR</a></li><li><a href="users-guide/instances.html">Instances</a></li><li><a href="users-guide/security.html">Security</a></li><li><a href="users-guide/obr.html">OBR</a></li><li><a href="users-guide/enterprise.html">Enterprise</a><ul><li><a href="users-guide/webcontainer.html">WebContainer (JSP/Servlet)</a></li><li><a href="users-guide/jndi.html">Naming (JNDI)</a></li><li><a href="users-guide/jta.html">Transaction (JTA)</a></li><li><a href="users-guide/jdbc.html">DataSource (JDBC)</a></li><li><a href="users-guide/jms.html">MOM (JMS)</a></li><li><a href="users-guide/jpa.html">Persistence (JPA)</a></li><li><a href="users-guide/ejb.html">EJB</a></li><li><a href="users-guide/cdi.html">CDI</a></li><li><a href="users-guide/failover.html">HA/failover and cluster</a></li></ul></li><li><a href="users-guide/monitoring.html">Monitoring and Management using JMX</a></
li><li><a href="users-guide/webconsole.html">WebConsole</a></li><li><a href="users-guide/tuning.html">Tuning</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="developers-guide/index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="developers-guide/developer-commands.html">Developer commands</a></li><li><a href="developers-guide/scripting.html">Scripting</a></li><li><a href="developers-guide/connect.html">Programmatically connect</a></li><li><a href="developers-guide/branding.html">Branding</a></li><li><a href="developers-guide/extending.html">Extending</a></li><li><a href="developers-guide/karaf-maven-plugin.html">Karaf Maven plugin</a></li><li><a href="developers-guide/custom-distribution.html">Custom distribution</a></li><li><a href="developers-guide/services.html">OSGi services</a></li><li><a href="developers-guide/creating-bundles.html">Create OSGi bundle</a></li><li><a href="developers-guide/blueprint.html">Blueprint</a></li><li><a hre
f="developers-guide/cdi.html">CDI</a></li><li><a href="developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="developers-guide/security-framework.html">Security Framework</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging, Profiling</a></li><li><a href="developers-guide/writing-tests.html">Integration testing</a></li><li><a href="developers-guide/github-contributions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="commands/commands.html">Commands</a></h3>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<h1 id="UpdateNotesfrom2.xto3.x">Update Notes (from 2.x to 3.x)</h1><p>This section is dedicated to users of previous Apache Karaf version.</p><h2 id="Distributions">Distributions</h2><p>The Apache Karaf distributions content has changed.</p><p>On Apache Karaf 2.x, we provide:</p><ul><li>tar.gz archive dedicated for Unix platforms</li><li>zip archive dedicated for Windows platforms</li></ul><p>Now, Apache Karaf 3.x still provide tar.gz and zip archives, but the content is the same.<br/>Especially, the two archives contains a <tt>bin</tt> folder with both Unix scripts and Windows bat scripts.</p><h2 id="Commands">Commands</h2><p>All console commands have been renamed and dispatched in scopes between Apache Karaf 2.x and Apache Karaf 3.x.</p><p>The purpose is to standardize the naming convention, and use more "logic" scope (especially for subshell).</p><p>The following table shows the correspondence between the "old" commands and the "new" ones.</p><div class="table-wrap"><table class
="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x </th><th class="confluenceTh"> Apache Karaf 3.x </th></tr><tr><td class="confluenceTd"> admin:change-opts </td><td class="confluenceTd"> instance:opts-change </td></tr><tr><td class="confluenceTd"> admin:change-rmi-registry-port </td><td class="confluenceTd"> instance:rmi-registry-port-change </td></tr><tr><td class="confluenceTd"> admin:change-rmi-server-port </td><td class="confluenceTd"> instance:rmi-server-port-change </td></tr><tr><td class="confluenceTd"> admin:change-ssh-port </td><td class="confluenceTd"> instance:ssh-port-change </td></tr><tr><td class="confluenceTd"> admin:clone </td><td class="confluenceTd"> instance:clone </td></tr><tr><td class="confluenceTd"> admin:connect </td><td class="confluenceTd"> instance:connect
</td></tr><tr><td class="confluenceTd"> admin:create </td><td class="confluenceTd"> instance:create </td></tr><tr><td class="confluenceTd"> admin:destroy </td><td class="confluenceTd"> instance:destroy </td></tr><tr><td class="confluenceTd"> admin:list </td><td class="confluenceTd"> instance:list </td></tr><tr><td class="confluenceTd"> admin:rename </td><td class="confluenceTd"> instance:rename </td></tr><tr><td class="confluenceTd"> admin:start </td><td class="confluenceTd"> instance:start </td></tr><tr><td class="confluenceTd"> admin:status </td><td class="confluenceTd"> instance:status </td></tr><tr><td class="confluenceTd"> admin:stop </td><td class="conflue
nceTd"> instance:stop </td></tr><tr><td class="confluenceTd"> dev:create-dump </td><td class="confluenceTd"> dev:dump-create </td></tr><tr><td class="confluenceTd"> features:add-url </td><td class="confluenceTd"> feature:repo-add </td></tr><tr><td class="confluenceTd"> features:chooseurl </td><td class="confluenceTd"> feature:repo-add </td></tr><tr><td class="confluenceTd"> features:info </td><td class="confluenceTd"> feature:info </td></tr><tr><td class="confluenceTd"> features:install </td><td class="confluenceTd"> feature:install </td></tr><tr><td class="confluenceTd"> features:listVersions </td><td class="confluenceTd"> feature:version-list </td></tr><tr><td class="confluenceTd"> features:list
</td><td class="confluenceTd"> feature:list </td></tr><tr><td class="confluenceTd"> features:listRepositories </td><td class="confluenceTd"> feature:repo-list </td></tr><tr><td class="confluenceTd"> features:listUrl </td><td class="confluenceTd"> feature:repo-list </td></tr><tr><td class="confluenceTd"> features:refreshUrl </td><td class="confluenceTd"> feature:repo-refresh </td></tr><tr><td class="confluenceTd"> features:removeRepository </td><td class="confluenceTd"> feature:repo-remove </td></tr><tr><td class="confluenceTd"> features:removeUrl </td><td class="confluenceTd"> feature:repo-remove </td></tr><tr><td class="confluenceTd"> features:uninstall </td><td class="confluenceTd"> feature:uninstall </td></tr><tr><td class="confluen
ceTd"> jaas:cancel </td><td class="confluenceTd"> jaas:cancel </td></tr><tr><td class="confluenceTd"> jaas:pending </td><td class="confluenceTd"> jaas:pending-list </td></tr><tr><td class="confluenceTd"> jaas:realms </td><td class="confluenceTd"> jaas:realm-list </td></tr><tr><td class="confluenceTd"> jaas:users </td><td class="confluenceTd"> jaas:user-list </td></tr><tr><td class="confluenceTd"> jaas:manage </td><td class="confluenceTd"> jaas:realm-manage </td></tr><tr><td class="confluenceTd"> jaas:roleadd </td><td class="confluenceTd"> jaas:role-add </td></tr><tr><td class="confluenceTd"> jaas:roledel </td><td class="confluenceTd"> jaas:role-delete <
/td></tr><tr><td class="confluenceTd"> jaas:update </td><td class="confluenceTd"> jaas:update </td></tr><tr><td class="confluenceTd"> jaas:useradd </td><td class="confluenceTd"> jaas:user-add </td></tr><tr><td class="confluenceTd"> jaas:userdel </td><td class="confluenceTd"> jaas:user-delete </td></tr><tr><td class="confluenceTd"> shell:alias </td><td class="confluenceTd"> shell:alias </td></tr><tr><td class="confluenceTd"> shell:cat </td><td class="confluenceTd"> shell:cat </td></tr><tr><td class="confluenceTd"> shell:clear </td><td class="confluenceTd"> shell:clear </td></tr><tr><td class="confluenceTd"> shell:date </td><td class="confluenceTd"> shell:date
</td></tr><tr><td class="confluenceTd"> shell:each </td><td class="confluenceTd"> shell:each </td></tr><tr><td class="confluenceTd"> shell:echo </td><td class="confluenceTd"> shell:echo </td></tr><tr><td class="confluenceTd"> shell:exec </td><td class="confluenceTd"> shell:exec </td></tr><tr><td class="confluenceTd"> shell:grep </td><td class="confluenceTd"> shell:grep </td></tr><tr><td class="confluenceTd"> shell:head </td><td class="confluenceTd"> shell:head </td></tr><tr><td class="confluenceTd"> shell:history </td><td class="confluenceTd"> shell:history </td></tr><tr><td class="confluenceTd"> shell:if </td><td c
lass="confluenceTd"> shell:if </td></tr><tr><td class="confluenceTd"> shell:info </td><td class="confluenceTd"> shell:info </td></tr><tr><td class="confluenceTd"> shell:java </td><td class="confluenceTd"> shell:java </td></tr><tr><td class="confluenceTd"> shell:logout </td><td class="confluenceTd"> shell:logout </td></tr><tr><td class="confluenceTd"> shell:more </td><td class="confluenceTd"> shell:more </td></tr><tr><td class="confluenceTd"> shell:new </td><td class="confluenceTd"> shell:new </td></tr><tr><td class="confluenceTd"> shell:printf </td><td class="confluenceTd"> shell:printf </td></tr><tr><td class="confluenceTd"> shell:sleep
</td><td class="confluenceTd"> shell:sleep </td></tr><tr><td class="confluenceTd"> shell:sort </td><td class="confluenceTd"> shell:sort </td></tr><tr><td class="confluenceTd"> shell:source </td><td class="confluenceTd"> shell:source </td></tr><tr><td class="confluenceTd"> shell:tac </td><td class="confluenceTd"> shell:tac </td></tr><tr><td class="confluenceTd"> shell:tail </td><td class="confluenceTd"> shell:tail </td></tr><tr><td class="confluenceTd"> shell:watch </td><td class="confluenceTd"> shell:watch </td></tr><tr><td class="confluenceTd"> shell:wc </td><td class="confluenceTd"> shell:wc </td></tr><tr><td cl
ass="confluenceTd"> config:cancel </td><td class="confluenceTd"> config:cancel </td></tr><tr><td class="confluenceTd"> config:delete </td><td class="confluenceTd"> config:delete </td></tr><tr><td class="confluenceTd"> config:edit </td><td class="confluenceTd"> config:edit </td></tr><tr><td class="confluenceTd"> config:list </td><td class="confluenceTd"> config:list </td></tr><tr><td class="confluenceTd"> config:propappend </td><td class="confluenceTd"> config:property-append </td></tr><tr><td class="confluenceTd"> config:propdel </td><td class="confluenceTd"> config:property-delete </td></tr><tr><td class="confluenceTd"> config:proplist </td><td class="confluenceTd"> config:property-list
</td></tr><tr><td class="confluenceTd"> config:propset </td><td class="confluenceTd"> config:property-set </td></tr><tr><td class="confluenceTd"> config:update </td><td class="confluenceTd"> config:update </td></tr><tr><td class="confluenceTd"> dev:dynamic-import </td><td class="confluenceTd"> bundle:dynamic-import </td></tr><tr><td class="confluenceTd"> dev:framework </td><td class="confluenceTd"> system:framework </td></tr><tr><td class="confluenceTd"> dev:print-stack-traces </td><td class="confluenceTd"> shell:stack-traces-print </td></tr><tr><td class="confluenceTd"> dev:restart </td><td class="confluenceTd"> system:shutdown </td></tr><tr><td class="confluenceTd"> dev:show-tree </td><td class="confluenceTd"
> bundle:tree-show </td></tr><tr><td class="confluenceTd"> dev:system-property </td><td class="confluenceTd"> system:property </td></tr><tr><td class="confluenceTd"> dev:wait-for-service </td><td class="confluenceTd"> service:wait </td></tr><tr><td class="confluenceTd"> dev:watch </td><td class="confluenceTd"> bundle:watch </td></tr><tr><td class="confluenceTd"> log:clear </td><td class="confluenceTd"> log:clear </td></tr><tr><td class="confluenceTd"> log:display-exception </td><td class="confluenceTd"> log:exception-display </td></tr><tr><td class="confluenceTd"> log:display </td><td class="confluenceTd"> log:display </td></tr><tr><td class="confluenceTd"> log:get
</td><td class="confluenceTd"> log:get </td></tr><tr><td class="confluenceTd"> log:tail </td><td class="confluenceTd"> log:tail </td></tr><tr><td class="confluenceTd"> log:set </td><td class="confluenceTd"> log:set </td></tr><tr><td class="confluenceTd"> obr:addUrl </td><td class="confluenceTd"> obr:url-add </td></tr><tr><td class="confluenceTd"> obr:deploy </td><td class="confluenceTd"> obr:deploy </td></tr><tr><td class="confluenceTd"> obr:find </td><td class="confluenceTd"> obr:find </td></tr><tr><td class="confluenceTd"> obr:info </td><td class="confluenceTd"> obr:info </td></tr><tr><td class="confluenceTd">
obr:list </td><td class="confluenceTd"> obr:list </td></tr><tr><td class="confluenceTd"> obr:listUrl </td><td class="confluenceTd"> obr:url-list </td></tr><tr><td class="confluenceTd"> obr:refreshUrl </td><td class="confluenceTd"> obr:url-refresh </td></tr><tr><td class="confluenceTd"> obr:removeUrl </td><td class="confluenceTd"> obr:url-remove </td></tr><tr><td class="confluenceTd"> obr:resolve </td><td class="confluenceTd"> obr:resolve </td></tr><tr><td class="confluenceTd"> obr:source </td><td class="confluenceTd"> obr:source </td></tr><tr><td class="confluenceTd"> obr:start </td><td class="confluenceTd"> obr:start </td></
tr><tr><td class="confluenceTd"> osgi:bundle-level </td><td class="confluenceTd"> bundle:start-level </td></tr><tr><td class="confluenceTd"> osgi:classes </td><td class="confluenceTd"> bundle:classes </td></tr><tr><td class="confluenceTd"> osgi:find-class </td><td class="confluenceTd"> bundle:find-class </td></tr><tr><td class="confluenceTd"> osgi:headers </td><td class="confluenceTd"> bundle:headers </td></tr><tr><td class="confluenceTd"> osgi:info </td><td class="confluenceTd"> bundle:info </td></tr><tr><td class="confluenceTd"> osgi:install </td><td class="confluenceTd"> bundle:install </td></tr><tr><td class="confluenceTd"> osgi:bundle-services </td><td class="confluenceTd"> bundle:services
</td></tr><tr><td class="confluenceTd"> osgi:list </td><td class="confluenceTd"> bundle:list </td></tr><tr><td class="confluenceTd"> osgi:ls </td><td class="confluenceTd"> service:list </td></tr><tr><td class="confluenceTd"> osgi:name </td><td class="confluenceTd"> system:name </td></tr><tr><td class="confluenceTd"> osgi:refresh </td><td class="confluenceTd"> bundle:refresh </td></tr><tr><td class="confluenceTd"> osgi:resolve </td><td class="confluenceTd"> bundle:resolve </td></tr><tr><td class="confluenceTd"> osgi:restart </td><td class="confluenceTd"> bundle:restart </td></tr><tr><td class="confluenceTd"> osgi:shutdown </td><td class="
confluenceTd"> system:shutdown </td></tr><tr><td class="confluenceTd"> osgi:start </td><td class="confluenceTd"> bundle:start </td></tr><tr><td class="confluenceTd"> osgi:start-level </td><td class="confluenceTd"> bundle:start-level </td></tr><tr><td class="confluenceTd"> osgi:stop </td><td class="confluenceTd"> bundle:stop </td></tr><tr><td class="confluenceTd"> osgi:uninstall </td><td class="confluenceTd"> bundle:uninstall </td></tr><tr><td class="confluenceTd"> osgi:update </td><td class="confluenceTd"> bundle:update </td></tr><tr><td class="confluenceTd"> osgi:version </td><td class="confluenceTd"> system:version </td></tr><tr><td class="confluenceTd"> packages:exports
</td><td class="confluenceTd"> package:exports </td></tr><tr><td class="confluenceTd"> packages:imports </td><td class="confluenceTd"> package:imports </td></tr><tr><td class="confluenceTd"> ssh:ssh </td><td class="confluenceTd"> ssh:ssh </td></tr><tr><td class="confluenceTd"> ssh:sshd </td><td class="confluenceTd"> ssh:sshd </td></tr><tr><td class="confluenceTd"> web:list </td><td class="confluenceTd"> web:list </td></tr><tr><td class="confluenceTd"> wrapper:install </td><td class="confluenceTd"> wrapper:install </td></tr></table></div><p>We encourage the users to use the <tt>--help</tt> option to check the name and type of arguments and options.</p><p>In term of development, the pr
eviously shell anotations provided by the <tt>org.apache.felix.gogo.commands*</tt> package (<tt>@Command</tt>, <tt>@Argument</tt>, etc)<br/>are now deprecated. Apache Karaf 3.0.0 still supports these annotations, but we encourage the users to upgrade to the new package <tt>org.apache.karaf.shell.commands</tt>.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Shell annotation </th><th class="confluenceTh"> Apache Karaf 2.x </th><th class="confluenceTh"> Apache Karaf 3.x </th></tr><tr><td class="confluenceTd"> <tt>@Argument</tt> </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Argument</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.Argument</tt> </td></tr><tr><td class="confluenceTd"> <tt>@Command</tt> </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Command</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.Command</tt> </td></tr><tr><td clas
s="confluenceTd"> <tt>@CompleterValues</tt> </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.CompleterValues</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.CompleterValues</tt> </td></tr><tr><td class="confluenceTd"> <tt>@Option</tt> </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Option</tt> </td><td class="confluenceTd"> {{org.apache.karaf.shell.commands.Option </td></tr><tr><td class="confluenceTd"> <tt>@SubShell</tt> </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.SubShell</tt> </td><td class="confluenceTd"> {{org.apache.karaf.shell.commands.SubShell </td></tr></table></div><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Class name </th><th class="confluenceTh"> Apache Karaf 2.x </th><th class="confluenceTh"> Apache Karaf 3.x </th></tr><tr><td class="confluenceTd"> Action </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.Acti
on</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.Action</tt> </td></tr><tr><td class="confluenceTd"> CommandException </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.CommandException</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.CommandException</tt> </td></tr><tr><td class="confluenceTd"> AbstractCommand </td><td class="confluenceTd"> <tt>org.apache.felix.gogo.commands.basic.AbstractCommand</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf.shell.commands.basic.AbstractCommand</tt> </td></tr></table></div><h2 id="JMXMBeans">JMX MBeans</h2><p>Like the console commands, the JMX MBeans object names have been renamed and the operations haven been dispatched in<br/>new MBeans.</p><p>The following table shows the correspondence between the "old" MBeans object names and the "new" ones.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x
</th><th class="confluenceTh"> Apache Karaf 3.x </th></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=bundles,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=bundle,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=config,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=config,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=dev,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org;apache.karaf:type=log,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=log,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=obr,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=obr,name=*</tt> </td></tr><tr><td cl
ass="confluenceTd"> <tt>org.apache.karaf:type=packages,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=package,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=services,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=service,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=system,name=*</tt> </td></tr><tr><td class="confluenceTd"> <tt>org.apache.karaf:type=web,name=*</tt> </td><td class="confluenceTd"> <tt>org.apache.karaf:type=web,name=*</tt> </td></tr></table></div><h2 id="Features">Features</h2><p>The Apache Karaf "core" features repository XML URL have changed:</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x </th><th class="confl
uenceTh"> Apache Karaf 3.x </th></tr><tr><td class="confluenceTd"> <tt>mvn:org.apache.karaf.assemblies.features/standard/2.3.x/xml/features</tt> </td><td class="confluenceTd"> <tt>mvn:org.apache.karaf.features/standard/3.0.x/xml/features</tt> </td></tr><tr><td class="confluenceTd"> <tt>mvn:org.apache.karaf.assemblies.features/enterprise/2.3.x/xml/features</tt> </td><td class="confluenceTd"> <tt>mvn:org.apache.karaf.features/enterprise/3.0.x/xml/features</tt> </td></tr></table></div><p>The Spring features have been isolated in a dedicated features repository (<tt>mvn:org.apache.karaf.features/spring/3.0.x/xml/features</tt>).</p><h2 id="Namespaces">Namespaces</h2><p>Apache Karaf 3.x brings updated version of the namespaces:</p><ul><li>Supported features namespaces:<ul><li><tt>karaf-features-1.0.0.xsd</tt></li><li><tt>karaf-features-1.1.0.xsd</tt></li><li><tt>karaf-features-1.2.0.xsd</tt></li></ul></li><li>Supported jaas na
mespaces:<ul><li><tt>karaf-jaas-1.0.0.xsd</tt></li><li><tt>karaf-jaas-1.1.0.xsd</tt></li></ul></li><li>Supported shell namespaces:<ul><li><tt>karaf-shell-1.0.0.xsd</tt></li><li><tt>karaf-shell-1.1.0.xsd</tt></li></ul></li></ul><h2 id="Mavenplugin">Maven plugin</h2><p>The previous <tt>features-maven-plugin</tt> and <tt>cmdhelp-maven-plugin</tt> Maven plugins have been gathered in one main Maven<br/>plugin: <tt>karaf-maven-plugin</tt>.</p><p>The goals have changed as follow:</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Apache Karaf 2.x Maven plugins </th><th class="confluenceTh"> Apache Karaf Maven Plugin (3.x) </th></tr><tr><td class="confluenceTd"> features:add-features-to-repo </td><td class="confluenceTd"> karaf:features-add-to-repository </td></tr><tr><td class="confluenceTd"> features:create-kar </td><td class="confluenceTd"> karaf:features-create-
kar </td></tr><tr><td class="confluenceTd"> features:generate-features-file </td><td class="confluenceTd"> karaf:features-generate-descriptor </td></tr><tr><td class="confluenceTd"> features:generate-features-xml </td><td class="confluenceTd"> karaf:features-generate-descriptor </td></tr><tr><td class="confluenceTd"> features:install-kars </td><td class="confluenceTd"> karaf:install-kars </td></tr><tr><td class="confluenceTd"> features:validate-features </td><td class="confluenceTd"> karaf:features-validate-descriptor </td></tr><tr><td class="confluenceTd"> cmdhelp:cmdhelp </td><td class="confluenceTd"> karaf:commands-generate-help </td></tr></table></div><p>Using the <tt>features:add-features-to-repo</tt> goal, you have now to explicitily define the Apache Karaf
features URL (previously, the Apache Karaf features were automatically added).<br/>It means that you have to define:</p><pre>
+<descriptor>mvn:org.apache.karaf.features/standard/3.0.0/xml/features</descriptor>
+<descriptor>mvn:org.apache.karaf.features/spring/3.0.0/xml/features</descriptor>
+<descriptor>mvn:org.apache.karaf.features/enterprise/3.0.0/xml/features</descriptor>
+</pre><h2 id="Testtooling">Test tooling</h2><p>Apache Karaf 3.0.x is fully supported by OPS4J Pax Exam and "previous" karaf-pax-exam module is no more maintained.</p><h2 id="WebContainer">WebContainer</h2><p>WebApplications using the <tt>WebApp-Context</tt> headers in the MANIFEST are no more supported.</p><p>Apache Karaf now supports only the OSGi standard <tt>Web-ContextPath</tt> header in the MANIFEST.</p><h2 id="Updateguide">Update guide</h2><p>We encourage users to stard a fresh Apache Karaf 3.x container more than trying to override the folders from an<br/>Apache Karaf 2.x container.</p><p>Most of the files in the different Apache Karaf folders have changed, and the merge/diff is very large.</p><p>The future Apache Karaf version will introduce the concept of "Karaf Profiles" to simplify the update process.</p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation
+ <br/>
+ Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: karaf/site/production/manual/latest-3.0.x/users-guide/cdi.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-3.0.x/users-guide/cdi.html?rev=1688692&view=auto
==============================================================================
--- karaf/site/production/manual/latest-3.0.x/users-guide/cdi.html (added)
+++ karaf/site/production/manual/latest-3.0.x/users-guide/cdi.html Wed Jul 1 17:06:42 2015
@@ -0,0 +1,174 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="description goes here"/>
+ <meta name="keywords" content="keywords,goes,here"/>
+ <meta name="author" content="The Apache Karaf Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Apache Karaf 3.0.5-SNAPSHOT Guides
+ </title>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+<a href="http://karaf.apache.org/" title="A server side OSGi distribution">
+ <img border="0" src="../images/karaf-logo.png" width="400px"></img>
+</a>
+ </td>
+ <td align="right" nowrap="">
+<a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png">
+</a>
+ </td>
+ </tr>
+ </table>
+
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p>
+<a href="../index.html" title="Home">Home</a>
+|
+<a href="index.html" title="Users Guide">Users Guide</a>
+|
+<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a>
+</p>
+
+
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installation</a></li><li><a href="directory-structure.html">Directory structure</a></li><li><a href="start-stop.html">Start, stop, restart, connect</a></li><li><a href="wrapper.html">Integration in the operating system: the Service Wrapper</a></li><li><a href="console.html">Console</a></li><li><a href="remote.html">Remote</a></li><li><a href="log.html">Log</a></li><li><a href="configuration.html">Configuration</a></li><li><a href="urls.html">Artifacts repositories and URLs</a></li><li><a href="provisioning.html">Provisioning and features</a></li><li><a href="deployers.html">Deployers</a></li><li><a href="kar.html">KAR</a></li><li><a
href="instances.html">Instances</a></li><li><a href="security.html">Security</a></li><li><a href="obr.html">OBR</a></li><li><a href="enterprise.html">Enterprise</a><ul><li><a href="webcontainer.html">WebContainer (JSP/Servlet)</a></li><li><a href="jndi.html">Naming (JNDI)</a></li><li><a href="jta.html">Transaction (JTA)</a></li><li><a href="jdbc.html">DataSource (JDBC)</a></li><li><a href="jms.html">MOM (JMS)</a></li><li><a href="jpa.html">Persistence (JPA)</a></li><li><a href="ejb.html">EJB</a></li><li><a href="cdi.html">CDI</a></li><li><a href="failover.html">HA/failover and cluster</a></li></ul></li><li><a href="monitoring.html">Monitoring and Management using JMX</a></li><li><a href="webconsole.html">WebConsole</a></li><li><a href="tuning.html">Tuning</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="../developers-guide/index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="../developers-guide/developer-commands.html">Developer command
s</a></li><li><a href="../developers-guide/scripting.html">Scripting</a></li><li><a href="../developers-guide/connect.html">Programmatically connect</a></li><li><a href="../developers-guide/branding.html">Branding</a></li><li><a href="../developers-guide/extending.html">Extending</a></li><li><a href="../developers-guide/karaf-maven-plugin.html">Karaf Maven plugin</a></li><li><a href="../developers-guide/custom-distribution.html">Custom distribution</a></li><li><a href="../developers-guide/services.html">OSGi services</a></li><li><a href="../developers-guide/creating-bundles.html">Create OSGi bundle</a></li><li><a href="../developers-guide/blueprint.html">Blueprint</a></li><li><a href="../developers-guide/cdi.html">CDI</a></li><li><a href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="../developers-guide/security-framework.html">Security Framework</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging, Profiling</a></li><li><a
href="../developers-guide/writing-tests.html">Integration testing</a></li><li><a href="../developers-guide/github-contributions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<h1 id="CDI">CDI</h1><p>This section described how to add support of CDI, and embed a CDI container in Apache Karaf. It doesn't describe<br/>how to develop CDI applications. See the developer guide for that.</p><h2 id="PaxCDI">Pax CDI</h2><p>Apache Karaf supports different CDI containers by using Pax CDI.</p><p>Pax CDI is pre-referenced in Apache Karaf. To register the Pax CDI features, you can do:</p><pre>
+karaf@root()> feature:repo-add pax-cdi
+</pre><p>This command will register the latest pax-cdi features.</p><p>You can see now a set of new CDI features available:</p><pre>
+karaf@root()> feature:list|grep -i cdi
+pax-cdi | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Provide CDI support
+pax-cdi-1.1 | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Provide CDI 1.1 support
+pax-cdi-weld | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Weld CDI support
+pax-cdi-1.1-weld | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Weld CDI 1.1 support
+pax-cdi-openwebbeans | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | OpenWebBeans CDI support
+pax-cdi-web | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Web CDI support
+pax-cdi-1.1-web | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Web CDI 1.1 support
+pax-cdi-web-weld | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Weld Web CDI support
+pax-cdi-1.1-web-weld | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | Weld Web CDI 1.1 support
+pax-cdi-web-openwebbeans | 0.6.0 | | org.ops4j.pax.cdi-0.6.0 | OpenWebBeans Web CDI support
+pax-cdi-deltaspike-core | >0.5 | | org.ops4j.pax.cdi-0.6.0 | Apache Deltaspike core support
+pax-cdi-deltaspike-jpa | 0.5 | | org.ops4j.pax.cdi-0.6.0 | Apche Deltaspike jpa support
+</pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Starting from Apache Karaf 3.0.1, the <tt>feature:repo-add pax-cdi</tt> command is no more required.<br/>Pax CDI features are now automatically included in the Apache Karaf enterprise features.</p></div><h2 id="CDIContainers">CDI Containers</h2><p>Thanks to Pax CDI, Apache Karaf supports multiple CDI implementation versions, and different CDI containers.</p><p>You just have to install the feature corresponding to the CDI container and version that you want to use.</p><h3 id="ApacheOpenWebBeans">Apache OpenWebBeans</h3><p>Apache Karaf provides a ready to use feature for Apache OpenWebBeans.</p><p>The <tt>openwebbeans</tt> feature automatically install the Pax CDI features and the Apache OpenWebBeans bundles:</p><pre>
+karaf@root()> feature:install openwebbeans
+</pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>With Apache Karaf 3.0.0, don't forget to register the pax-cdi features repository first with:</p><pre>
+karaf@root()> feature:repo-add pax-cdi
+</pre></div><h3 id="JBossWeldCDIcontainer">JBoss Weld CDI container</h3><p>Apache Karaf provides a ready to use feature for JBoss Weld.</p><p>The <tt>weld</tt> feature automatically install the Pax CDI features and the JBoss Weld bundles:</p><pre>
+karaf@root()> feature:install weld
+</pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>With Apache Karaf 3.0.0, don't forget to register the pax-cdi features repository first with:</p><pre>
+karaf@root()> feature:repo-add pax-cdi
+</pre></div>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation
+ <br/>
+ Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: karaf/site/production/manual/latest-3.0.x/users-guide/configuration.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-3.0.x/users-guide/configuration.html?rev=1688692&view=auto
==============================================================================
--- karaf/site/production/manual/latest-3.0.x/users-guide/configuration.html (added)
+++ karaf/site/production/manual/latest-3.0.x/users-guide/configuration.html Wed Jul 1 17:06:42 2015
@@ -0,0 +1,300 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="description goes here"/>
+ <meta name="keywords" content="keywords,goes,here"/>
+ <meta name="author" content="The Apache Karaf Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Apache Karaf 3.0.5-SNAPSHOT Guides
+ </title>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+<a href="http://karaf.apache.org/" title="A server side OSGi distribution">
+ <img border="0" src="../images/karaf-logo.png" width="400px"></img>
+</a>
+ </td>
+ <td align="right" nowrap="">
+<a href="http://www.apache.org/" title="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png">
+</a>
+ </td>
+ </tr>
+ </table>
+
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p>
+<a href="../index.html" title="Home">Home</a>
+|
+<a href="index.html" title="Users Guide">Users Guide</a>
+|
+<a href="../developers-guide/index.html" title="Developers Guide">Developers Guide</a>
+</p>
+
+
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="installation.html">Installation</a></li><li><a href="directory-structure.html">Directory structure</a></li><li><a href="start-stop.html">Start, stop, restart, connect</a></li><li><a href="wrapper.html">Integration in the operating system: the Service Wrapper</a></li><li><a href="console.html">Console</a></li><li><a href="remote.html">Remote</a></li><li><a href="log.html">Log</a></li><li><a href="configuration.html">Configuration</a></li><li><a href="urls.html">Artifacts repositories and URLs</a></li><li><a href="provisioning.html">Provisioning and features</a></li><li><a href="deployers.html">Deployers</a></li><li><a href="kar.html">KAR</a></li><li><a
href="instances.html">Instances</a></li><li><a href="security.html">Security</a></li><li><a href="obr.html">OBR</a></li><li><a href="enterprise.html">Enterprise</a><ul><li><a href="webcontainer.html">WebContainer (JSP/Servlet)</a></li><li><a href="jndi.html">Naming (JNDI)</a></li><li><a href="jta.html">Transaction (JTA)</a></li><li><a href="jdbc.html">DataSource (JDBC)</a></li><li><a href="jms.html">MOM (JMS)</a></li><li><a href="jpa.html">Persistence (JPA)</a></li><li><a href="ejb.html">EJB</a></li><li><a href="cdi.html">CDI</a></li><li><a href="failover.html">HA/failover and cluster</a></li></ul></li><li><a href="monitoring.html">Monitoring and Management using JMX</a></li><li><a href="webconsole.html">WebConsole</a></li><li><a href="tuning.html">Tuning</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="../developers-guide/index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="../developers-guide/developer-commands.html">Developer command
s</a></li><li><a href="../developers-guide/scripting.html">Scripting</a></li><li><a href="../developers-guide/connect.html">Programmatically connect</a></li><li><a href="../developers-guide/branding.html">Branding</a></li><li><a href="../developers-guide/extending.html">Extending</a></li><li><a href="../developers-guide/karaf-maven-plugin.html">Karaf Maven plugin</a></li><li><a href="../developers-guide/custom-distribution.html">Custom distribution</a></li><li><a href="../developers-guide/services.html">OSGi services</a></li><li><a href="../developers-guide/creating-bundles.html">Create OSGi bundle</a></li><li><a href="../developers-guide/blueprint.html">Blueprint</a></li><li><a href="../developers-guide/cdi.html">CDI</a></li><li><a href="../developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="../developers-guide/security-framework.html">Security Framework</a></li><li><a href="../developers-guide/debugging.html">Troubleshooting, Debugging, Profiling</a></li><li><a
href="../developers-guide/writing-tests.html">Integration testing</a></li><li><a href="../developers-guide/github-contributions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<h1 id="Configuration">Configuration</h1><h2 id="Files">Files</h2><p>Apache Karaf stores and loads all configuration in files located in the <tt>etc</tt> folder.</p><p>By default, the <tt>etc</tt> folder is located relatively to the <tt>KARAF_BASE</tt> folder. You can define another location<br/>using the <tt>KARAF_ETC</tt> variable.</p><p>Each configuration is identified by a ID (the ConfigAdmin PID). The configuration files name follows the <tt>pid.cfg</tt><br/>name convention.</p><p>For instance, <tt>etc/org.apache.karaf.shell.cfg</tt> means that this file is the file used by the configuration with<br/><tt>org.apache.karaf.shell</tt> as PID.</p><p>A configuration file is a properties file containing key/value pairs:</p><pre>
+property=value
+</pre><p>In Apache Karaf, a configuration is PID with a set of properties attached.</p><p>Apache Karaf automatically loads all <tt>*.cfg</tt> files from the <tt>etc</tt> folder.</p><p>You can configure the behaviour of the configuration files using some dedicated properties in the<br/><tt>etc/config.properties</tt> configuration file:</p><pre>
+...
+#
+# Configuration FileMonitor properties
+#
+felix.fileinstall.enableConfigSave = true
+felix.fileinstall.dir = ${karaf.etc}
+felix.fileinstall.filter = .*\\.cfg
+felix.fileinstall.poll = 1000
+felix.fileinstall.noInitialDelay = true
+felix.fileinstall.log.level = 3
+...
+</pre><ul><li><tt>felix.fileinstall.enableConfigSave</tt> flush back in the configuration file the changes performed directly on the<p>configuration service (ConfigAdmin). If <tt>true</tt>, any change (using <tt>config:*</tt> commands, MBeans, OSGi service) is<br/>persisted back in the configuration false. Default is <tt>true</tt>.</p></li><li><tt>felix.fileinstall.dir</tt> is the directory where Apache Karaf is looking for configuration files. Default is <tt>${karaf.etc}</tt><p>meaning the value of the <tt>KARAF_ETC</tt> variable.</p></li><li><tt>felix.fileinstall.filter</tt> is the file name pattern used to load only some configuration files. Only files matching<p>the pattern will be loaded. Default value is <tt>.*<br/>.cfg</tt> meaning *.cfg files.</p></li><li><tt>felix.fileinstall.poll</tt> is the polling interval (in milliseconds). Default value is <tt>1000</tt> meaning that Apache<p>Karaf "re-loads" the configuration files every second.</p></li><li><tt>felix.fileinstall.noInit
ialDelay</tt> is a flag indicating if the configuration file polling starts as soon as Apache<p>Karaf starts or wait for a certain time. If <tt>true</tt>, Apache Karaf polls the configuration files as soon as the configuration<br/>service starts.</p></li><li><tt>felix.fileinstall.log.level</tt> is the log message verbosity level of the configuration polling service. More<p>this value is high, more verbose the configuration service is.</p><p>You can change the configuration at runtime by directly editiing the configuration file.</p><p>You can also do the same using the <tt>config:*</tt> commands or the ConfigMBean.</p><h2 id="configcommands"><tt>config:*</tt> commands</h2><p>Apache Karaf provides a set of commands to manage the configuration.</p><h3 id="configlist"><tt>config:list</tt></h3><p><tt>config:list</tt> displays the list of all configurations available, or the properties in a given configuration (PID).</p><p>Without the <tt>query</tt> argument, the <tt>config:list</tt> comm
and display all configurations, with PID, attached bundle and<br/>properties defined in the configuration:</p><pre>
+karaf@root()> config:list
+----------------------------------------------------------------
+Pid: org.apache.karaf.service.acl.command.system.start-level
+BundleLocation: mvn:org.apache.karaf.shell/org.apache.karaf.shell.console/3.0.0
+Properties:
+ service.guard = (&(osgi.command.scope=system)(osgi.command.function=start-level))
+ * = *
+ start-level = admin # admin can set any start level, including < 100
+ start-level[/[^0-9]*/] = viewer # viewer can obtain the current start level
+ execute[/.*/,/[^0-9]*/] = viewer # viewer can obtain the current start level
+ execute = admin # admin can set any start level, including < 100
+ service.pid = org.apache.karaf.service.acl.command.system.start-level
+ start-level[/.*[0-9][0-9][0-9]+.*/] = manager # manager can set startlevels above 100
+ execute[/.*/,/.*[0-9][0-9][0-9]+.*/] = manager # manager can set startlevels above 100
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+...
+</pre></li></ul><p>The <tt>query</tt> argument accepts a query using a LDAP syntax.</p><p>For instance, you can display details on one specific configuration using the following filter:</p><pre>
+karaf@root()> config:list "(service.pid=org.apache.karaf.log)"
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><h3 id="configedit"><tt>config:edit</tt></h3><p><tt>config:edit</tt> is the first command to do when you want to change a configuration. <tt>config:edit</tt> command put you<br/>in edition mode for a given configuration.</p><p>For instance, you can edit the <tt>org.apache.karaf.log</tt> configuration:</p><pre>
+karaf@root()> config:edit org.apache.karaf.log
+</pre><p>The <tt>config:edit</tt> command doesn't display anything, it just puts you in configuration edit mode. You are now ready<br/>to use other config commands (like <tt>config:property-append</tt>, <tt>config:property-delete</tt>, <tt>config:property-set</tt>, ...).</p><p>If you provide a configuration PID that doesn't exist yet, Apache Karaf will create a new configuration (and so a new<br/>configuration file) automatically.</p><p>All changes that you do in configuration edit mode are store in your console session: the changes are not directly<br/>applied in the configuration. It allows you to "commit" the changes (see <tt>config:update</tt> command) or "rollback" and<br/>cancel your changes (see <tt>config:cancel</tt> command).</p><h3 id="configpropertylist"><tt>config:property-list</tt></h3><p>The <tt>config:property-list</tt> lists the properties for the currently edited configuration.</p><p>Assuming that you edited the <tt>org.apache.karaf.log</tt> configuration, you can d
o:</p><pre>
+karaf@root()> config:property-list
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><h3 id="configpropertyset"><tt>config:property-set</tt></h3><p>The <tt>config:property-set</tt> command update the value of a given property in the currently edited configuration.</p><p>For instance, to change the value of the <tt>size</tt> property of previously edited <tt>org.apache.karaf.log</tt> configuration,<br/>you can do:</p><pre>
+karaf@root()> config:property-set size 1000
+karaf@root()> config:property-list
+ service.pid = org.apache.karaf.log
+ size = 1000
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><p>If the property doesn't exist, the <tt>config:property-set</tt> command creates the property.</p><p>You can use <tt>config:property-set</tt> command outside the configuration edit mode, by specifying the <tt>-p</tt> (for configuration pid) option:</p><pre>
+karaf@root()> config:property-set -p org.apache.karaf.log size 1000
+karaf@root()> config:list "(service.pid=org.apache.karaf.log)"
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 1000
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Using the <tt>pid</tt> option, you bypass the configuration commit and rollback mechanism.</p></div><h3 id="configpropertyappend"><tt>config:property-append</tt></h3><p>The <tt>config:property-append</tt> is similar to <tt>config:property-set</tt> command, but instead of completely replacing the<br/>property value, it appends a string at the end of the property value.</p><p>For instance, to add 1 at the end of the value of the <tt>size</tt> property in <tt>org.apache.karaf.log</tt> configuration<br/>(and so have 5001 for the value instead of 500), you can do:</p><pre>
+karaf@root()> config:property-append size 1
+karaf@root()> config:property-list
+ service.pid = org.apache.karaf.log
+ size = 5001
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><p>Like the <tt>config:property-set</tt> command, if the property doesn't exist, the <tt>config:property-set</tt> command creates<br/>the property.</p><p>You can use the <tt>config:property-append</tt> command outside the configuration edit mode, by specifying the <tt>-p</tt> (for configuration pid) option:</p><pre>
+karaf@root()> config:property-append -p org.apache.karaf.log size 1
+karaf@root()> config:list "(service.pid=org.apache.karaf.log)"
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 5001
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Using the <tt>pid</tt> option, you bypass the configuration commit and rollback mechanism.</p></div><h3 id="configpropertydelete"><tt>config:property-delete</tt></h3><p>The <tt>config:property-delete</tt> command delete a property in the currently edited configuration.</p><p>For instance, you previously added a <tt>test</tt> property in <tt>org.apache.karaf.log</tt> configuration. To delete this <tt>test</tt><br/>property, you do:</p><pre>
+karaf@root()> config:property-set test test
+karaf@root()> config:property-list
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+ test = test
+karaf@root()> config:property-delete test
+karaf@root()> config:property-list
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><p>You can use the <tt>config:property-delete</tt> command outside the configuration edit mode, by specifying the <tt>-p</tt> (for configuration pid) option:</p><pre>
+karaf@root()> config:property-delete -p org.apache.karaf.log test
+</pre><h3 id="configupdateandconfigcancel"><tt>config:update</tt> and <tt>config:cancel</tt></h3><p>When you are in the configuration edit mode, all changes that you do using <tt>config:property*</tt> commands are stored in "memory"<br/>(actually in the console session).</p><p>Thanks to that, you can "commit" your changes using the <tt>config:update</tt> command. The <tt>config:update</tt> command will<br/>commit your changes, update the configuration, and (if possible) update the configuration files.</p><p>For instance, after changing <tt>org.apache.karaf.log</tt> configuration with some <tt>config:property*</tt> commands, you have<br/>to commit your change like this:</p><pre>
+karaf@root()> config:edit org.apache.karaf.log
+karaf@root()> config:property-set test test
+karaf@root()> config:update
+karaf@root()> config:list "(service.pid=org.apache.karaf.log)"
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+ test = test
+</pre><p>On the other hand, if you want to "rollback" your changes, you can use the <tt>config:cancel</tt> command. It will cancel all<br/>changes that you did, and return of the configuration state just before the <tt>config:edit</tt> command. The <tt>config:cancel</tt><br/>exits from the edit mode.</p><p>For instance, you added the test property in the <tt>org.apache.karaf.log</tt> configuration, but it was a mistake:</p><pre>
+karaf@root()> config:edit org.apache.karaf.log
+karaf@root()> config:property-set test test
+karaf@root()> config:cancel
+karaf@root()> config:list "(service.pid=org.apache.karaf.log)"
+----------------------------------------------------------------
+Pid: org.apache.karaf.log
+BundleLocation: mvn:org.apache.karaf.log/org.apache.karaf.log.core/3.0.0
+Properties:
+ service.pid = org.apache.karaf.log
+ size = 500
+ pattern = %d{ISO8601} | %-5.5p | %-16.16t | %-32.32c{1} | %X{bundle.id} - %X{bundle.name} - %X{bundle.version} | %m%n
+ felix.fileinstall.filename = file:/opt/apache-karaf-3.0.0/etc/org.apache.karaf.log.cfg
+</pre><h3 id="configdelete"><tt>config:delete</tt></h3><p>The <tt>config:delete</tt> command completely delete an existing configuration. You don't have to be in edit mode to delete<br/>a configuration.</p><p>For instance, you added <tt>my.config</tt> configuration:</p><pre>
+karaf@root()> config:edit my.config
+karaf@root()> config:property-set test test
+karaf@root()> config:update
+karaf@root()> config:list "(service.pid=my.config)"
+----------------------------------------------------------------
+Pid: my.config
+BundleLocation: null
+Properties:
+ service.pid = my.config
+ test = test
+</pre><p>You can delete the <tt>my.config</tt> configuration (including all properties in the configuration) using the <tt>config:delete</tt><br/>command:</p><pre>
+karaf@root()> config:delete my.config
+karaf@root()> config:list "(service.pid=my.config)"
+karaf@root()>
+</pre><h2 id="JMXConfigMBean">JMX ConfigMBean</h2><p>On the JMX layer, you have a MBean dedicated to the management of the configurations: the ConfigMBean.</p><p>The ConfigMBean object name is: <tt>org.apache.karaf:type=config,name=*</tt>.</p><h3 id="Attributes">Attributes</h3><p>The <tt>Configs</tt> attribute is a list of all configuration PIDs.</p><h3 id="Operations">Operations</h3><ul><li><tt>listProperties(pid)</tt> returns the list of properties (property=value formatted) for the configuration <tt>pid</tt>.</li><li><tt>deleteProperty(pid, property)</tt> deletes the <tt>property</tt> from the configuration <tt>pid</tt>.</li><li><tt>appendProperty(pid, property, value)</tt> appends <tt>value</tt> at the end of the value of the <tt>property</tt> of the configuration <tt>pid</tt>.</li><li><tt>setProperty(pid, property, value)</tt> sets <tt>value</tt> for the value of the <tt>property</tt> of the configuration <tt>pid</tt>.</li><li><tt>delete(pid)</tt> deletes the configuration iden
tified by the <tt>pid</tt>.</li><li><tt>create(pid)</tt> creates an empty (without any property) configuration with <tt>pid</tt>.</li><li><tt>update(pid, properties)</tt> updates a configuration identified with <tt>pid</tt> with the provided <tt>properties</tt> map.</li></ul>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation
+ <br/>
+ Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file