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">
+          &nbsp;
+        </td>
+        <td id="cell-0-1">
+          &nbsp;
+        </td>
+        <td id="cell-0-2" colspan="2">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-1-0">
+          &nbsp;
+        </td>
+        <td id="cell-1-1">
+          &nbsp;
+        </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>
+&#124;
+<a href="users-guide/index.html" title="Users Guide">Users Guide</a>
+&#124;
+<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">
+          &nbsp;
+        </td>
+        <td id="cell-1-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-2-0" colspan="2">
+          &nbsp;
+        </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 &lt;KARAF_HOME>.</li></ul><h2 id="Starttheserver">Start the server</h2><p>Open a command line console and change the directory to &lt;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>
+        __ __                  ____
+       / //_/____ __________ _/ __/
+      / ,&lt;  / __ `/ ___/ __ `/ /_
+     / /| |/ /_/ / /  / /_/ / __/
+    /_/ |_|\__,_/_/   \__,_/_/
+
+  Apache Karaf (3.0.0)
+
+Hit '&lt;tab>' for a list of available commands
+and '[cmd] --help' for help on a specific command.
+Hit '&lt;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>&lt;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">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-3-0">
+          &nbsp;
+        </td>
+        <td id="cell-3-1">
+          &nbsp;
+        </td>
+        <td id="cell-3-2">
+          <div id="footer">
+            <div id="site-footer">
+              &copy; 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">
+          &nbsp;
+        </td>
+        <td id="cell-3-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-4-0" colspan="2">
+          &nbsp;
+        </td>
+        <td id="cell-4-1">
+          &nbsp;
+        </td>
+        <td id="cell-4-2" colspan="2">
+          &nbsp;
+        </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">
+          &nbsp;
+        </td>
+        <td id="cell-0-1">
+          &nbsp;
+        </td>
+        <td id="cell-0-2" colspan="2">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-1-0">
+          &nbsp;
+        </td>
+        <td id="cell-1-1">
+          &nbsp;
+        </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>
+&#124;
+<a href="users-guide/index.html" title="Users Guide">Users Guide</a>
+&#124;
+<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">
+          &nbsp;
+        </td>
+        <td id="cell-1-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-2-0" colspan="2">
+          &nbsp;
+        </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>
+&lt;descriptor>mvn:org.apache.karaf.features/standard/3.0.0/xml/features&lt;/descriptor>
+&lt;descriptor>mvn:org.apache.karaf.features/spring/3.0.0/xml/features&lt;/descriptor>
+&lt;descriptor>mvn:org.apache.karaf.features/enterprise/3.0.0/xml/features&lt;/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">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-3-0">
+          &nbsp;
+        </td>
+        <td id="cell-3-1">
+          &nbsp;
+        </td>
+        <td id="cell-3-2">
+          <div id="footer">
+            <div id="site-footer">
+              &copy; 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">
+          &nbsp;
+        </td>
+        <td id="cell-3-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-4-0" colspan="2">
+          &nbsp;
+        </td>
+        <td id="cell-4-1">
+          &nbsp;
+        </td>
+        <td id="cell-4-2" colspan="2">
+          &nbsp;
+        </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">
+          &nbsp;
+        </td>
+        <td id="cell-0-1">
+          &nbsp;
+        </td>
+        <td id="cell-0-2" colspan="2">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-1-0">
+          &nbsp;
+        </td>
+        <td id="cell-1-1">
+          &nbsp;
+        </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>
+&#124;
+<a href="index.html" title="Users Guide">Users Guide</a>
+&#124;
+<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">
+          &nbsp;
+        </td>
+        <td id="cell-1-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-2-0" colspan="2">
+          &nbsp;
+        </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">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-3-0">
+          &nbsp;
+        </td>
+        <td id="cell-3-1">
+          &nbsp;
+        </td>
+        <td id="cell-3-2">
+          <div id="footer">
+            <div id="site-footer">
+              &copy; 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">
+          &nbsp;
+        </td>
+        <td id="cell-3-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-4-0" colspan="2">
+          &nbsp;
+        </td>
+        <td id="cell-4-1">
+          &nbsp;
+        </td>
+        <td id="cell-4-2" colspan="2">
+          &nbsp;
+        </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">
+          &nbsp;
+        </td>
+        <td id="cell-0-1">
+          &nbsp;
+        </td>
+        <td id="cell-0-2" colspan="2">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-1-0">
+          &nbsp;
+        </td>
+        <td id="cell-1-1">
+          &nbsp;
+        </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>
+&#124;
+<a href="index.html" title="Users Guide">Users Guide</a>
+&#124;
+<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">
+          &nbsp;
+        </td>
+        <td id="cell-1-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-2-0" colspan="2">
+          &nbsp;
+        </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 = (&amp;(osgi.command.scope=system)(osgi.command.function=start-level))
+   * = *
+   start-level = admin                           # admin can set any start level, including &lt; 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 &lt; 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">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-3-0">
+          &nbsp;
+        </td>
+        <td id="cell-3-1">
+          &nbsp;
+        </td>
+        <td id="cell-3-2">
+          <div id="footer">
+            <div id="site-footer">
+              &copy; 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">
+          &nbsp;
+        </td>
+        <td id="cell-3-4">
+          &nbsp;
+        </td>
+      </tr>
+      <tr width="100%">
+        <td id="cell-4-0" colspan="2">
+          &nbsp;
+        </td>
+        <td id="cell-4-1">
+          &nbsp;
+        </td>
+        <td id="cell-4-2" colspan="2">
+          &nbsp;
+        </td>
+      </tr>
+    </table>
+  </body>
+</html>
\ No newline at end of file