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 2013/12/25 07:31:55 UTC
svn commit: r1553356 [22/31] - in /karaf/site/production/manual/latest: ./
commands/ developers-guide/ users-guide/
Modified: karaf/site/production/manual/latest/overview.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/overview.html?rev=1553356&r1=1553355&r2=1553356&view=diff
==============================================================================
--- karaf/site/production/manual/latest/overview.html (original)
+++ karaf/site/production/manual/latest/overview.html Wed Dec 25 06:31:51 2013
@@ -8,7 +8,7 @@
<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.0-SNAPSHOT Guides
+ Apache Karaf 3.0.1-SNAPSHOT Guides
</title>
</head>
<body>
@@ -93,7 +93,7 @@
<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">Installing Karaf</a></li><li><a href="users-guide/directory-structure.html">Directory Structure</a></li><li><a href="users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="users-guide/wrapper.html">OS integration</a></li><li><a href="users-guide/configuration.html">Configuration</a></li><li><a href="users-guide/using-console.html">Using the console</a></li><li><a href="users-guide/web-console.html">Web console</a></li><li><a href="users-guide/remote-console.html">Remote console</a></li><li><a href="users-guide/web-console.html">Web console</a></li><li><a href="users-guide/deployer.html">Deployer
</a></li><li><a href="users-guide/child-instances.html">Child instances</a></li><li><a href="users-guide/security.html">Security</a></li><li><a href="users-guide/failover.html">Failover Deployments</a></li><li><a href="users-guide/logging-system.html">Logging system</a></li><li><a href="users-guide/provisioning.html">Provisioning</a></li><li><a href="users-guide/kar.html">KAR archive</a></li><li><a href="users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="users-guide/web-applications.html">Web applications</a></li><li><a href="users-guide/http.html">HTTP service</a></li><li><a href="users-guide/jmx.html">JMX for monitoring and administration</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/connect-console.html">Programmatically connect to the Console</a></li><li><a href="developers-guide/shell-syntax.html">Shell syntax</a></li><li><a href="dev
elopers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developers-guide/developer-commands.html">Developer Commands</a></li><li><a href="developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="developers-guide/extending-console.html">Extending the Console</a></li><li><a href="developers-guide/branding-console.html">Branding the Console</a></li><li><a href="developers-guide/karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="developers-guide/security-framework.html">Security Framework</a></li><li><a href="developers-guide/custom-distribution.html">Custom Distribution</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="developers-guide/writing-tests.html">Writing integrati
on tests</a></li><li><a href="developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="developers-guide/shell-syntax.html">Shell syntax</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>
+ <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>
@@ -101,7 +101,7 @@
</td>
<td height="100%" width="100%">
<div class="wiki-content">
-<h1 id="KarafOverview">Karaf Overview</h1><p>Apache Karaf is a small OSGi based runtime which provides a lightweight container onto which various components and applications can be deployed.</p><ul><li>Uses either Apache Felix or Eclipse Equinox as OSGi framework and extends these with many features that make it a fully featured server</li><li>Can be scaled from a very lightweight small container to a fully featured enterprise Server</li></ul><p><a href="users-guide/features.html">See all Karaf features in detail</a></p><p>Here is a short list of features supported by the Karaf:</p><ul><li><strong>Hot deployment</strong>: Karaf supports hot deployment of OSGi bundles by monitoring jar files inside the <tt>deploy</tt> directory. Each time a jar is copied in this folder, it will be installed inside the runtime. You can then update or delete it and changes will be handled automatically. In addition, Karaf also supports exploded bundles and custom deployers (Blueprint and Spring ones
are included by default).</li><li><strong>Dynamic configuration</strong>: Services are usually configured through the ConfigurationAdmin OSGi service. Such configuration can be defined in Karaf using property files inside the <tt>etc</tt> directory. These configurations are monitored and changes on the properties files will be propagated to the services.</li><li><strong>Logging System</strong>: using a centralized logging back end supported by Log4J, Karaf supports a number of different APIs (JDK 1.4, JCL, SLF4J, Avalon, Tomcat, OSGi)</li><li><strong>Provisioning</strong>: Provisioning of libraries or applications can be done through a number of different ways, by which they will be downloaded locally, installed and started.</li><li><strong>Native OS integration</strong>: Karaf can be integrated into your own Operating System as a service so that the lifecycle will be bound to your Operating System.</li><li><strong>Extensible Shell console</strong>: Karaf features a nice text con
sole where you can manage the services, install new applications or libraries and manage their state. This shell is easily extensible by deploying new commands dynamically along with new features or applications.</li><li><strong>Remote access</strong>: use any SSH client to connect to Karaf and issue commands in the console</li><li><strong>Security framework</strong> based on JAAS</li><li><strong>Managing instances</strong>: Karaf provides simple commands for managing multiple instances. You can easily create, delete, start and stop instances of Karaf through the console.</li><li>Supports the latest OSGi 4.3 containers: Apache Felix Framework 4.0 and Eclipse Equinox 3.8</li></ul><p><img border="0" src="images/karaf.png"/></p>
+<h1 id="ApacheKarafOverview">Apache Karaf Overview</h1><p>Apache Karaf is a OSGi-based runtime which provides a lightweight container onto which various components and applications can be deployed.</p><p>Apache Karaf uses either Apache Felix Framework or Eclipse Equinox OSGi frameworks, and provide additional features on top of the framework.</p><p>Apache Karaf can be scaled from a very lightweight container to a fully features enterprise service: it's a very flexible and extensible container, covering all the major needs.</p><p>Here is a short list of provided features:</p><ul><li><strong>Hot deployment</strong>: simply drop a file in the <tt>deploy</tt> directory, Apache Karaf will detect the type of the file and<p> try to deploy it.</p></li><li><strong>Complete Console</strong>: Apache Karaf provides a complete Unix-like console where you can completely manage the container.</li><li><strong>Dynamic Configuration</strong>: Apache Karaf provides a set of command dedicated for the m
anagement of the configuration files.<p> All configuration files are centralized in the <tt>etc</tt> folder. Any change in a configuration file is taken on the fly.</p></li><li><strong>Advanced Logging System</strong>: Apache Karaf supports a large set of Logging framework (slf4j, log4j, etc). Whatever the<p> logging framework you use, Apache Karaf centralizes the configuration in one file.</p></li><li><strong>Provisioning</strong>: Apache Karaf supports a large set of URL where you can install your application (Maven repository, HTTP,<p> file, etc). It also provides the concept of "Karaf Feature" which is a way to describe your application.</p></li><li><strong>Management</strong>: Apache Karaf is an enterprise-ready container, providing a lot of management indicators and operations<p> via JMX.</p></li><li><strong>Remote</strong>: Apache Karaf embeds an SSHd server allowing you to use the console remotely. The management layer is also<p> accessible remotely.</p></li><li><strong>Secu
rity</strong>: Apache Karaf provides a complete security framework (based on JAAS), and providing RBAC (Role-Based Access<p> Control) mechanism for console and JMX.</p></li><li><strong>Instances</strong>: multiple instances of Apache Karaf can be managed directly from a main instance (root).</li><li><strong>OSGi frameworks</strong>: Apache Karaf is not tight to one OSGi framework. By default, Apache Karaf runs with Apache Felix<p> Framework, but you can easily switch to Equinox (just change on property in a configuration file).</p><p><img border="0" src="images/karaf.png"/></p></li></ul>
</div>
</td>
</tr>
Modified: karaf/site/production/manual/latest/quick-start.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/quick-start.html?rev=1553356&r1=1553355&r2=1553356&view=diff
==============================================================================
--- karaf/site/production/manual/latest/quick-start.html (original)
+++ karaf/site/production/manual/latest/quick-start.html Wed Dec 25 06:31:51 2013
@@ -8,7 +8,7 @@
<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.0-SNAPSHOT Guides
+ Apache Karaf 3.0.1-SNAPSHOT Guides
</title>
</head>
<body>
@@ -93,7 +93,7 @@
<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">Installing Karaf</a></li><li><a href="users-guide/directory-structure.html">Directory Structure</a></li><li><a href="users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="users-guide/wrapper.html">OS integration</a></li><li><a href="users-guide/configuration.html">Configuration</a></li><li><a href="users-guide/using-console.html">Using the console</a></li><li><a href="users-guide/web-console.html">Web console</a></li><li><a href="users-guide/remote-console.html">Remote console</a></li><li><a href="users-guide/web-console.html">Web console</a></li><li><a href="users-guide/deployer.html">Deployer
</a></li><li><a href="users-guide/child-instances.html">Child instances</a></li><li><a href="users-guide/security.html">Security</a></li><li><a href="users-guide/failover.html">Failover Deployments</a></li><li><a href="users-guide/logging-system.html">Logging system</a></li><li><a href="users-guide/provisioning.html">Provisioning</a></li><li><a href="users-guide/kar.html">KAR archive</a></li><li><a href="users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="users-guide/web-applications.html">Web applications</a></li><li><a href="users-guide/http.html">HTTP service</a></li><li><a href="users-guide/jmx.html">JMX for monitoring and administration</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/connect-console.html">Programmatically connect to the Console</a></li><li><a href="developers-guide/shell-syntax.html">Shell syntax</a></li><li><a href="dev
elopers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developers-guide/developer-commands.html">Developer Commands</a></li><li><a href="developers-guide/archetypes.html">Maven Archetypes</a></li><li><a href="developers-guide/extending-console.html">Extending the Console</a></li><li><a href="developers-guide/branding-console.html">Branding the Console</a></li><li><a href="developers-guide/karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="developers-guide/security-framework.html">Security Framework</a></li><li><a href="developers-guide/custom-distribution.html">Custom Distribution</a></li><li><a href="developers-guide/debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developers-guide/connect-console.html">Programmatically connect to the console</a></li><li><a href="developers-guide/writing-tests.html">Writing integrati
on tests</a></li><li><a href="developers-guide/creating-bundles.html">Creating bundles</a></li><li><a href="developers-guide/shell-syntax.html">Shell syntax</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>
+ <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>
@@ -101,7 +101,7 @@
</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 6 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.6 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>
+<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
@@ -112,18 +112,21 @@ bin/karaf
/ /| |/ /_/ / / / /_/ / __/
/_/ |_|\__,_/_/ \__,_/_/
- Apache Karaf (3.0.0-SNAPSHOT)
+ 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 'system:shutdown' to shutdown Karaf.
+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>
+karaf@root()>
-instance:change-port instance:connect instance:create instance:destroy
-instance:list instance:start instance:stop config:cancel
+</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
@@ -131,18 +134,36 @@ 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>
-feature:repo-add camel 2.10.0
-feature:install camel-spring
-install -s mvn:org.apache.camel/camel-example-osgi/2.10.1
+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>
-bundle:stop org.apache.camel.camel-example-osgi
+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>
Added: karaf/site/production/manual/latest/update-notes.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/update-notes.html?rev=1553356&view=auto
==============================================================================
--- karaf/site/production/manual/latest/update-notes.html (added)
+++ karaf/site/production/manual/latest/update-notes.html Wed Dec 25 06:31:51 2013
@@ -0,0 +1,150 @@
+<!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.1-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="confluence
Td"> 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="confluenceT
d"> 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 clas
s="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 class
="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"> b
undle: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"> ob
r: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="con
fluenceTd"> 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><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 class="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="confluenceTh"> 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>m
vn: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 namespaces:<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="conflu
enceTh"> 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="co
nfluenceTd"> karaf:features-validate-descriptor </td></tr><tr><td class="confluenceTd"> cmdhelp:cmdhelp </td><td class="confluenceTd"> karaf:commands-generate-help </td></tr></table></div><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/users-guide/cdi.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/cdi.html?rev=1553356&view=auto
==============================================================================
--- karaf/site/production/manual/latest/users-guide/cdi.html (added)
+++ karaf/site/production/manual/latest/users-guide/cdi.html Wed Dec 25 06:31:51 2013
@@ -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.1-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><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>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>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