karaf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jbono...@apache.org
Subject svn commit: r1688715 [20/23] - in /karaf/site/production/manual/latest: ./ commands/ developers-guide/ users-guide/
Date Wed, 01 Jul 2015 19:43:38 GMT
Modified: karaf/site/production/manual/latest/users-guide/deployers.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/deployers.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/deployers.html (original)
+++ karaf/site/production/manual/latest/users-guide/deployers.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -126,6 +126,7 @@ felix.fileinstall.tmpdir        = ${kara
 felix.fileinstall.poll          = 1000
 felix.fileinstall.start.level   = 80
 felix.fileinstall.active.level  = 80
+felix.fileinstall.log.level     = 3
 </pre><ul><li><tt>felix.fileinstall.dir</tt> defines the location of the <tt>deploy</tt> folder. Default value is <tt>KARAF_BASE/deploy</tt>.</li><li><tt>felix.fileinstall.tmpdir</tt> defines a temporary folder where the deployers store their files. Default value is <tt>KARAF_DATA/generated-bundles</tt>.</li><li><tt>felix.fileinstall.poll</tt> defines the polling interval (in milliseconds). Default value is 1 second.</li></ul><p>When Apache Karaf polls a file from the <tt>deploy</tt> folder, it "delegates" the file handling to a deployer.</p><p>By default, Apache Karaf provides a set of deployers:</p><ul><li>Blueprint deployer is able to handle Blueprint XML files.</li><li>Spring deployer is able to handle Spring XML files.</li><li>Features deployer is able to handle Apache Karaf features XML files (see <a href="provisioning.html">Provisioning section</a> for details).</li><li>KAR deployer is able to handle KAR files (see <a href="kar.html">KAR section</a> for details).</li><li>Wrap
  deployer is able to handle non-OSGi jar files and turns it as OSGi bundles "on the fly".</li><li>Optionally, WAR deployer (if you install the war feature) is able to handle WAR files.</li></ul><h2 id="Blueprintdeployer">Blueprint deployer</h2><p>The Blueprint deployer is able to handle plain Blueprint XML configuration files.</p><p>The Blueprint deployer is able to transform "on the fly" any Blueprint XML file into valid OSGi bundle.</p><p>The generated OSGi MANIFEST will contain the following headers:</p><pre>
 Manifest-Version: 2
 Bundle-SymbolicName: [name of the file]
@@ -150,53 +151,7 @@ DynamicImport-Package: *
     Require-Bundle= my-bundle
   &lt;/manifest>
 </pre><h2 id="Featuresdeployer">Features deployer</h2><p>See the <a href="provisioning.html">Provisioning section</a> for details.</p><h2 id="KARdeployer">KAR deployer</h2><p>See the <a href="kar.html">KAR section</a> for details.</p><h2 id="Wardeployer">War deployer</h2><p>The installation of the WAR feature enables a WAR deployer.</p><p>It means that with the war feature installed, Apache Karaf is a complete OSGi WebContainer (like Tomcat) where<br/>you can deploy WAB (WebApplication Bundle) or pure WAR (WebApplication aRchive).</p><p>You can install the war feature with:</p><pre>
-karaf@root()> feature:install -v war
-Installing feature war 3.0.0
-Installing feature pax-war 3.0.5
-Installing feature pax-http-whiteboard 3.0.5
-Installing feature pax-http 3.0.5
-Installing feature pax-jetty 8.1.14.v20131031
-Found installed bundle: org.apache.servicemix.specs.activation-api-1.1 [81]
-Found installed bundle: org.apache.geronimo.specs.geronimo-servlet_3.0_spec [82]
-Found installed bundle: javax.mail [83]
-Found installed bundle: org.apache.geronimo.specs.geronimo-jta_1.1_spec [84]
-Found installed bundle: org.apache.geronimo.specs.geronimo-annotation_1.1_spec [85]
-Found installed bundle: org.apache.geronimo.specs.geronimo-jaspic_1.0_spec [86]
-Found installed bundle: org.apache.servicemix.bundles.asm [87]
-Found installed bundle: org.eclipse.jetty.aggregate.jetty-all-server [88]
-Checking configuration file mvn:org.ops4j.pax.web/pax-web-features/3.0.5/xml/jettyconfig
-Installing bundle mvn:org.ops4j.base/ops4j-base-lang/1.4.0
-Found installed bundle: org.ops4j.pax.swissbox.core [89]
-Found installed bundle: org.ops4j.pax.swissbox.optional.jcl [90]
-Found installed bundle: org.apache.xbean.bundleutils [91]
-Found installed bundle: org.apache.xbean.asm-shaded [92]
-Found installed bundle: org.apache.xbean.reflect [93]
-Found installed bundle: org.apache.xbean.finder-shaded [94]
-Found installed bundle: org.ops4j.pax.web.pax-web-api [95]
-Found installed bundle: org.ops4j.pax.web.pax-web-spi [96]
-Found installed bundle: org.ops4j.pax.web.pax-web-runtime [97]
-Found installed bundle: org.ops4j.pax.web.pax-web-jetty [98]
-Found installed bundle: org.ops4j.pax.web.pax-web-jsp [99]
-Found installed bundle: org.ops4j.pax.web.pax-web-extender-whiteboard [100]
-Installing bundle mvn:org.ops4j.pax.web/pax-web-jsp/3.0.5
-Found installed bundle: org.ops4j.pax.web.pax-web-extender-war [101]
-Installing bundle mvn:org.ops4j.pax.web/pax-web-extender-whiteboard/3.0.5
-Found installed bundle: org.ops4j.pax.web.pax-web-deployer [102]
-Found installed bundle: org.ops4j.pax.url.war [103]
-Found installed bundle: org.ops4j.pax.url.commons [104]
-Found installed bundle: org.ops4j.pax.swissbox.pax-swissbox-bnd [105]
-Found installed bundle: org.ops4j.pax.swissbox.property [106]
-Installing bundle mvn:org.ops4j.base/ops4j-base-net/1.4.0
-Installing bundle mvn:org.ops4j.base/ops4j-base-lang/1.4.0
-Installing bundle mvn:org.ops4j.base/ops4j-base-monitors/1.4.0
-Installing bundle mvn:org.ops4j.base/ops4j-base-util-property/1.4.0
-Found installed bundle: biz.aQute.bndlib [107]
-Found installed bundle: org.apache.karaf.web.core [108]
-Found installed bundle: org.apache.karaf.web.command [109]
-</pre><p>We can note that the Pax Web deployer (WAR deployer) has been started:</p><pre>
-...
-Found installed bundle: org.ops4j.pax.web.pax-web-deployer [102]
-...
+karaf@root()> feature:install war
 </pre><p>The WAR deployer supports:</p><ul><li>WAB files</li><li>WAR files</li><li>exploded WAR (as a directory named <tt>*.war</tt>).</li></ul><p>The only requirement of the WAR deployer is that the archive contains the <tt>WEB-INF/web.xml</tt> file.</p><h2 id="Wrapdeployer">Wrap deployer</h2><p>The wrap deployer allows you to "hot deploy" non-OSGi jar files ("classical" jar files) from the deploy folder.</p><p>The wrap deployer creates "on the fly" an OSGi bundle with a non-OSGi jar file.</p><p>The wrap deployer looks for jar files in the deploy folder. A jar file is considered as non-OSGi if the MANIFEST doesn't<br/>contain the <tt>Bundle-SymbolicName</tt> and <tt>Bundle-Version</tt> attributes, or if there is no MANIFEST at all.</p><p>The wrap deployer "transforms" non-OSGi jar file into an OSGi bundle.</p><p>The wrap deployer tries to populate the Bundle-SymbolicName and Bundle-Version extracted from the jar file path.</p><p>For example, if you simply copy commons-lang-2.3.jar 
 (which is not an OSGi bundle) into the deploy folder, you<br/>will see:</p><pre>
 karaf@root()> la|grep -i commons-lang
 80 | Active   |  80 | 2.3                   | commons-lang
@@ -210,7 +165,7 @@ Tool = Bnd-2.1.0.20130426-122213
 Specification-Version = 2.3
 Specification-Vendor = Apache Software Foundation
 Implementation-Version = 2.3
-Generated-By-Ops4j-Pax-From = wrap:file:/opt/apache-karaf-3.0.0/deploy/commons-lang-2.3.jar$Bundle-SymbolicName=commons-lang&amp;Bundle-Version=2.3
+Generated-By-Ops4j-Pax-From = wrap:file:/opt/apache-karaf-4.0.0/deploy/commons-lang-2.3.jar$Bundle-SymbolicName=commons-lang&amp;Bundle-Version=2.3
 Implementation-Vendor-Id = org.apache
 Created-By = 1.7.0_21 (Oracle Corporation)
 Implementation-Title = Commons Lang
@@ -267,7 +222,7 @@ karaf@root()> bundle:install -s 'wrap:mv
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/directory-structure.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/directory-structure.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/directory-structure.html (original)
+++ karaf/site/production/manual/latest/users-guide/directory-structure.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,7 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h1 id="Directorystructure">Directory structure</h1><p>The directory layout of a Karaf installation is as follows:</p><ul><li><tt>/bin</tt>: control scripts to start, stop, login, ...</li><li><tt>/etc</tt>: configuration files</li><li><tt>/data</tt>: working directory <ul><li><tt>/cache</tt>: OSGi framework bundle cache</li><li><tt>/generated-bundles</tt>: temporary folder used by the deployers</li><li><tt>/log</tt>: log files</li></ul></li><li><tt>/deploy</tt>: hot deploy directory</li><li><tt>/instances</tt>: directory containing <a href="instances.html">instances</a></li><li><tt>/lib</tt>: contains the bootstrap libraries<ul><li><tt>/lib/ext</tt>: directory for JRE extensions</li><li><tt>/lib/endorsed</tt>: directory for endorsed libraries</li></ul></li><li><tt>/system</tt>: OSGi bundles repository, laid out as a Maven 2 repository</li></ul><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>data</tt> folder con
 tains all the working and temporary files for Karaf.<br/>If you want to restart from a clean state, you can wipe out this directory, which has the same effect as<br/><a href="start-stop#Starting Karaf from clean.html">using the clean option</a>.</p></div>	
+<h1 id="Directorystructure">Directory structure</h1><p>The directory layout of a Karaf installation is as follows:</p><ul><li><tt>/bin</tt>: control scripts to start, stop, login, ...</li><li><tt>/demos</tt>: contains some simple Karaf samples</li><li><tt>/etc</tt>: configuration files</li><li><tt>/data</tt>: working directory <ul><li><tt>/cache</tt>: OSGi framework bundle cache</li><li><tt>/generated-bundles</tt>: temporary folder used by the deployers</li><li><tt>/log</tt>: log files</li></ul></li><li><tt>/deploy</tt>: hot deploy directory</li><li><tt>/instances</tt>: directory containing <a href="instances.html">instances</a></li><li><tt>/lib</tt>: contains libraries<ul><li><tt>/lib/boot</tt>: contains the systeù libraries used at Karaf bootstrap</li><li><tt>/lib/endorsed</tt>: directory for endorsed libraries</li><li><tt>/lib/ext</tt>: directory for JRE extensions</li></ul></li><li><tt>/system</tt>: OSGi bundles repository, laid out as a Maven 2 repository</li></ul><div class
 ="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>data</tt> folder contains all the working and temporary files for Karaf.<br/>If you want to restart from a clean state, you can wipe out this directory, which has the same effect as<br/><a href="start-stop#Starting Karaf from clean.html">using the clean option</a>.</p></div>	
                 </div>
               </td>
             </tr>
@@ -121,7 +121,7 @@
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/ejb.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/ejb.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/ejb.html (original)
+++ karaf/site/production/manual/latest/users-guide/ejb.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -149,7 +149,7 @@ karaf@root()> feature:install openejb-co
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/enterprise.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/enterprise.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/enterprise.html (original)
+++ karaf/site/production/manual/latest/users-guide/enterprise.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -121,7 +121,7 @@
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/failover.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/failover.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/failover.html (original)
+++ karaf/site/production/manual/latest/users-guide/failover.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -105,12 +105,12 @@
 karaf.lock=true
 karaf.lock.class=org.apache.karaf.main.SimpleFileLock
 karaf.lock.dir=&lt;PathToLockFileDirectory>
-karaf.lock.delay=10
-</pre><ul><li><tt>karaf.lock</tt> property enables the the HA/failover mechanism</li><li><tt>karaf.lock.class</tt> property contains the class name providing the lock implementation. Here, we use the filesystem lock.</li><li><tt>karaf.lock.dir</tt> property contains the location where the lock will be written. All instances have to share the same lock.</li><li><tt>karaf.lock.delay</tt> property is the interval period (in seconds) to check if the lock has been released or not.</li></ul><h3 id="Databaselock">Database lock</h3><p>It's not always possible and easy to have a shared filesystem between multiple Apache Karaf instances.</p><p>Instead of sharing a filesystem, Apache Karaf supports sharing a database.</p><p>The master instance holds the lock by locking a table in the database. If the master loses the lock, a waiting slave<br/>gains access to the locking table, acquire the lock on the table and starts.</p><p>The database lock uses JDBC (Java DataBase Connectivity). To use datab
 ase locking, you have to:</p><ul><li>copy the JDBC driver in the <tt>lib/ext</tt> folder on each instance. The JDBC driver to use is the one corresponding to the<p> database used for the locking system.</p></li><li>update <tt>etc/system.properties</tt> file on each instance:</li></ul><pre>
+karaf.lock.delay=10000
+</pre><ul><li><tt>karaf.lock</tt> property enables the the HA/failover mechanism</li><li><tt>karaf.lock.class</tt> property contains the class name providing the lock implementation. Here, we use the filesystem lock.</li><li><tt>karaf.lock.dir</tt> property contains the location where the lock will be written. All instances have to share the same lock.</li><li><tt>karaf.lock.delay</tt> property is the interval period (in milliseconds) to check if the lock has been released or not.</li></ul><h3 id="Databaselock">Database lock</h3><p>It's not always possible and easy to have a shared filesystem between multiple Apache Karaf instances.</p><p>Instead of sharing a filesystem, Apache Karaf supports sharing a database.</p><p>The master instance holds the lock by locking a table in the database. If the master loses the lock, a waiting slave<br/>gains access to the locking table, acquire the lock on the table and starts.</p><p>The database lock uses JDBC (Java DataBase Connectivity). To use 
 database locking, you have to:</p><ul><li>copy the JDBC driver in the <tt>lib/ext</tt> folder on each instance. The JDBC driver to use is the one corresponding to the<p> database used for the locking system.</p></li><li>update <tt>etc/system.properties</tt> file on each instance:</li></ul><pre>
 karaf.lock=true
 karaf.lock.class=org.apache.karaf.main.DefaultJDBCLock
 karaf.lock.level=50
-karaf.lock.delay=10
+karaf.lock.delay=10000
 karaf.lock.jdbc.url=jdbc:derby://dbserver:1527/sample
 karaf.lock.jdbc.driver=org.apache.derby.jdbc.ClientDriver
 karaf.lock.jdbc.user=user
@@ -118,7 +118,7 @@ karaf.lock.jdbc.password=password
 karaf.lock.jdbc.table=KARAF_LOCK
 karaf.lock.jdbc.clustername=karaf
 karaf.lock.jdbc.timeout=30
-</pre><ul><li><tt>karaf.lock</tt> property enabled the HA/failover mechanism</li><li><tt>karaf.lock.class</tt> property contains the class name providing the lock implementation. The <tt>org.apache.karaf.main.DefaultJDBCLock</tt><p> is the most generic database lock system implementation. Apache Karaf supports lock system for specific databases (see later for details).</p></li><li><tt>karaf.lock.level</tt> property is the container-level locking (see later for details).</li><li><tt>karaf.lock.delay</tt> property is the interval period (in seconds) to check if the lock has been released or not.</li><li><tt>karaf.lock.jdbc.url</tt> property contains the JDBC URL to the database (derby in this example).</li><li><tt>karaf.lock.jdbc.driver</tt> property contains the class name of the JDBC driver to use (derby in this example).</li><li><tt>karaf.lock.jdbc.user</tt> property contains the username to use to connect to the database.</li><li><tt>karaf.lock.jdbc.password</tt> property contains
  the password to use to connet to the database.</li><li><tt>karaf.lock.jdbc.table</tt> property contains the database table to use for the lock.</li></ul><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Apache Karaf won't start if the JDBC driver is not present in the <tt>lib/ext</tt> folder.</p></div><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>sample</tt> database will be created automatically if it does not exist.</p></div><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>If the connection to the database is lost, the master instance tries to gracefully shutdown, allowing a slave instance to<br/>become the master when the database is back. The former master instance will required a manual restart.</p></div><h4 id="LockonOracle">Lock on Oracle</h4><p>Apache Karaf suppor
 ts Oracle database for locking. The lock implementation class name to use is <tt>org.apache.karaf.main.lock.OracleJDBCLock</tt>:</p><pre>
+</pre><ul><li><tt>karaf.lock</tt> property enabled the HA/failover mechanism</li><li><tt>karaf.lock.class</tt> property contains the class name providing the lock implementation. The <tt>org.apache.karaf.main.DefaultJDBCLock</tt><p> is the most generic database lock system implementation. Apache Karaf supports lock system for specific databases (see later for details).</p></li><li><tt>karaf.lock.level</tt> property is the container-level locking (see later for details).</li><li><tt>karaf.lock.delay</tt> property is the interval period (in milliseconds) to check if the lock has been released or not.</li><li><tt>karaf.lock.jdbc.url</tt> property contains the JDBC URL to the database (derby in this example).</li><li><tt>karaf.lock.jdbc.driver</tt> property contains the class name of the JDBC driver to use (derby in this example).</li><li><tt>karaf.lock.jdbc.user</tt> property contains the username to use to connect to the database.</li><li><tt>karaf.lock.jdbc.password</tt> property con
 tains the password to use to connet to the database.</li><li><tt>karaf.lock.jdbc.table</tt> property contains the database table to use for the lock. Karaf will first try to find the table as specified in this property,<p>  and if not found, it will try the table name in lower and upper case.</p><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>Apache Karaf won't start if the JDBC driver is not present in the <tt>lib/ext</tt> folder.</p></div></li></ul><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>sample</tt> database will be created automatically if it does not exist.</p></div><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>If the connection to the database is lost, the master instance tries to gracefully shutdown, allowing a slave instance to<br/>become the master when 
 the database is back. The former master instance will required a manual restart.</p></div><h4 id="LockonOracle">Lock on Oracle</h4><p>Apache Karaf supports Oracle database for locking. The lock implementation class name to use is <tt>org.apache.karaf.main.lock.OracleJDBCLock</tt>:</p><pre>
 karaf.lock=true
 karaf.lock.class=org.apache.karaf.main.lock.OracleJDBCLock
 karaf.lock.jdbc.url=jdbc:oracle:thin:@hostname:1521:XE
@@ -162,7 +162,7 @@ karaf.lock.jdbc.timeout=0
 karaf.lock=true
 karaf.lock.class=org.apache.karaf.main.lock.SQLServerJDBCLock
 karaf.lock.level=50
-karaf.lock.delay=10
+karaf.lock.delay=10000
 karaf.lock.jdbc.url=jdbc:jtds:sqlserver://127.0.0.1;databaseName=sample
 karaf.lock.jdbc.driver=net.sourceforge.jtds.jdbc.Driver
 karaf.lock.jdbc.user=user
@@ -192,7 +192,7 @@ karaf.lock.level=50
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/features.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/features.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/features.html (original)
+++ karaf/site/production/manual/latest/users-guide/features.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,7 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h1 id="Features">Features</h1><h2 id="StandardFeatures">Standard Features</h2><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 management 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 yo
 ur 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>Security</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 pro
 perty in a configuration file).</p><p><img border="0" src="../images/karaf.png"/></p><h2 id="Enterprisefeatures">Enterprise features</h2></li><li>WebContainer (JSP/Servlet support, including WAR archive deployment support)</li><li>Naming (JNDI)</li><li>Transaction (JTA)</li><li>DataSources (JDBC)</li><li>MOM (JMS)</li><li>Persistence (JPA)</li><li>EJB</li><li>CDI</li><li>HA/failover and cluster</li></ul><h2 id="ExternalFeatures">External Features</h2><p>As a very extend-able container, OpenSource and commercial projects provide "native" support of Apache Karaf.</p><p>We can mention (this list is not exhaustive):</p><ul><li><a href="http://activemq.apache.org/osgi-integration.html">Apache ActiveMQ</a></li><li><a href="http://camel.apache.org/karaf.html">Apache Camel</a></li><li><a href="http://cxf.apache.org">Apache CXF</a></li><li><a href="http://www.jclouds.org/documentation/userguide/karaf/">JClouds</a></li><li><a href="http://team.ops4j.org/wiki/display/paxwicket/Install+Pax+Wick
 et">Apache Wicket</a></li><li>...</li></ul>
+<h1 id="Features">Features</h1><h2 id="StandardFeatures">Standard Features</h2><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 management 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 yo
 ur 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>Security</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 pro
 perty in a configuration file).</p><p><img border="0" src="../images/karaf.png"/></p><h2 id="Enterprisefeatures">Enterprise features</h2></li><li>WebContainer (JSP/Servlet support, including WAR archive deployment support)</li><li>Naming (JNDI)</li><li>Transaction (JTA)</li><li>DataSources (JDBC)</li><li>MOM (JMS)</li><li>Persistence (JPA)</li><li>EJB</li><li>CDI</li><li>HA/failover and cluster (Apache Karaf Cellar)</li><li>Monitoring (Apache Karaf Decanter)</li><li>Artifacts repository and OSGi bundle repository (Apache Karaf Cave)</li></ul><h2 id="ExternalFeatures">External Features</h2><p>As a very extend-able container, OpenSource and commercial projects provide "native" support of Apache Karaf.</p><p>We can mention (this list is not exhaustive):</p><ul><li><a href="http://activemq.apache.org/osgi-integration.html">Apache ActiveMQ</a></li><li><a href="http://camel.apache.org/karaf.html">Apache Camel</a></li><li><a href="http://cxf.apache.org">Apache CXF</a></li><li><a href="http
 ://www.jclouds.org/documentation/userguide/karaf/">JClouds</a></li><li><a href="http://team.ops4j.org/wiki/display/paxwicket/Install+Pax+Wicket">Apache Wicket</a></li><li>...</li></ul>
                 </div>
               </td>
             </tr>
@@ -121,7 +121,7 @@
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/http.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/http.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/http.html (original)
+++ karaf/site/production/manual/latest/users-guide/http.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -102,11 +102,11 @@
               <td height="100%" width="100%">
                 <div class="wiki-content">
 <h1 id="HttpService">Http Service</h1><p>The Karaf http feature enables the Pax Web implementation of the OSGi HTTPService.</p><h2 id="InstallingtheHTTPfeature">Installing the HTTP feature</h2><pre>
-root@karaf> feature:install http
-</pre><p>Test the HTTP service is up by pointing your browser to <a href="http://localhost:8080/">http://localhost:8080/</a>.</p><h2 id="ConfiguringtheHTTPService">Configuring the HTTPService</h2><p>By default the HTTPService listens on port 8181 you can change the port by creating a file <tt>etc/org.ops4j.pax.web.cfg</tt> with the following content:</p><pre>
-org.osgi.service.http.port=8080
+root@karaf()> feature:install http
+</pre><p>Test the HTTP service is up by pointing your browser to <a href="http://localhost:8181/">http://localhost:8181/</a>.</p><h2 id="ConfiguringtheHTTPService">Configuring the HTTPService</h2><p>By default the HTTPService listens on port 8181 you can change the port by creating a file <tt>etc/org.ops4j.pax.web.cfg</tt> with the following content:</p><pre>
+org.osgi.service.http.port=8181
 </pre><p>or by typing:</p><pre>
-root@karaf> config:property-set -p org.ops4j.pax.web org.osgi.service.http.port 8080
+root@karaf> config:property-set -p org.ops4j.pax.web org.osgi.service.http.port 8181
 </pre><p>If the http feature is already installed the change will take effect immediately.</p><h2 id="RegisteringaservletwiththeHttpServicemanually">Registering a servlet with the HttpService manually</h2><p>See <a href="http://felix.apache.org/site/apache-felix-http-service.html">Apache Felix HTTP Service</a>.</p><h2 id="UsingthePaxWebwhiteboardextender">Using the Pax Web whiteboard extender</h2><p>The Pax Web whiteboard extender is an enhancement of the http feature. So use the following command to install:</p><pre>
 root@karaf> feature:install http-whiteboard
 </pre><p>The <a href="http://team.ops4j.org/wiki/display/ops4j/Pax+Web+Extender+-+Whiteboard">Pax Web whiteboard</a> extender listens to services<br/>of interface type HttpServlet and Filter.<br/>It will register each of these interfaces with the HttpService and remove them as soon as the service goes down.<br/>So it is much more convenient than registering with the HttpService directly.</p><pre>
@@ -118,7 +118,7 @@ root@karaf> feature:install http-whitebo
         &lt;bean id="myServlet" class="com.example.MyServlet"/>
     &lt;/service>
 &lt;/blueprint>
-</pre><p>The above snippet publishes the Servlet MyServlet on http://localhost:8080/myServlet.</p><p>Please keep in mind that the Whiteboard pattern for Servlets is not standardized and only works with Pax Web.</p><p>For commands take a look at the command section in the <a href="webcontainer.html">webcontainer</a> chapter.</p>
+</pre><p>The above snippet publishes the Servlet MyServlet on http://localhost:8181/myServlet.</p><p>Please keep in mind that the Whiteboard pattern for Servlets is not standardized and only works with Pax Web.</p><p>For commands take a look at the command section in the <a href="webcontainer.html">webcontainer</a> chapter.</p>
                 </div>
               </td>
             </tr>
@@ -138,7 +138,7 @@ root@karaf> feature:install http-whitebo
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/index.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/index.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/index.html (original)
+++ karaf/site/production/manual/latest/users-guide/index.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -121,7 +121,7 @@
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/installation.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/installation.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/installation.html (original)
+++ karaf/site/production/manual/latest/users-guide/installation.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,27 +101,27 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h1 id="Installation">Installation</h1><p>Apache Karaf is a lightweight container, very easy to install and administrate, on both Unix and Windows platforms.</p><h2 id="Requirements">Requirements</h2><p><strong>Hardware:</strong></p><ul><li>50 MB of free disk space for the Apache Karaf binary distribution.</li></ul><p><strong>Operating Systems:</strong></p><ul><li>Windows: Windows 8, Windows 7, Windows 2003, Windows Vista, Windows XP SP2, Windows 2000.</li><li>Unix: RedHat Enterprise Linux, Debian, SuSE/OpenSuSE, CentOS, Fedora, Ubuntu, MacOS, AIX, HP-UX, Solaris, any Unix platform that supports Java.</li></ul><p><strong>Environment:</strong></p><ul><li>Java SE 1.7.x or greater (<a href="http://www.oracle.com/technetwork/java/javase/">http://www.oracle.com/technetwork/java/javase/</a>).</li><li>The JAVA_HOME environment variable must be set to the directory where the Java runtime is installed,</li></ul><h2 id="UsingApacheKarafbinarydistributions">Using Apache Karaf binary distributi
 ons</h2><p>Apache Karaf is available in two distributions, both as a tar.gz and zip archives.</p><p>The "default" distribution is a "ready to use" distribution.<br/>The "default" distribution provides the following features enabled.</p><p>The "minimal" distribution is like the minimal distributions that you can find for most of Unix distributions.<br/>Only the core layer is packaged, most of the features and bundles are downloaded from Internet at bootstrap.<br/>It means that Apache Karaf minimal distribution requires an Internet connection to start correctly.<br/>The features provided by the "minimal" distribution are exactly the same as in the "default" distribution, the difference<br/>is that the minimal distribution will download the features from Internet.</p><h3 id="InstallationonWindowsplatform">Installation on Windows platform</h3><p>NB: the JAVA_HOME environment variable has to be correctly defined. To accomplish that, press Windows key and Break key together, switch to "Ad
 vanced" tab and click on "Environment Variables".</p><ol><li>From a browser, navigate to <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>.</li><li>Download Apache Karaf binary distribution in the zip format: <tt>apache-karaf-3.0.0.zip</tt>.</li><li>Extract the files from the zip file into a directory of your choice (it's the <tt>KARAF_HOME</tt>.<p>NB: remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</p></li><li>Apache Karaf is now installed.</li></ol><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Handy Hint</b></p><p>In case you have to install Karaf into a very deep path or a path containing illegal characters for Java paths, e.g. !, % etc., you may add a bat file to <em>start \-> startup</em> that executes</p><pre>subst S: "C:\your very % problematic path!\KARAF"
+<h1 id="Installation">Installation</h1><p>Apache Karaf is a lightweight container, very easy to install and administrate, on both Unix and Windows platforms.</p><h2 id="Requirements">Requirements</h2><p><strong>Hardware:</strong></p><ul><li>50 MB of free disk space for the Apache Karaf binary distribution.</li></ul><p><strong>Operating Systems:</strong></p><ul><li>Windows: Windows 8, Windows 7, Windows 2003, Windows Vista, Windows XP SP2, Windows 2000.</li><li>Unix: RedHat Enterprise Linux, Debian, SuSE/OpenSuSE, CentOS, Fedora, Ubuntu, MacOS, AIX, HP-UX, Solaris, any Unix platform that supports Java.</li></ul><p><strong>Environment:</strong></p><ul><li>Java SE 1.7.x or greater (<a href="http://www.oracle.com/technetwork/java/javase/">http://www.oracle.com/technetwork/java/javase/</a>).</li><li>The JAVA_HOME environment variable must be set to the directory where the Java runtime is installed,</li></ul><h2 id="UsingApacheKarafbinarydistributions">Using Apache Karaf binary distributi
 ons</h2><p>Apache Karaf is available in two distributions, both as a tar.gz and zip archives.</p><p>The "default" distribution is a "ready to use" distribution.<br/>The "default" distribution provides the following features enabled.</p><p>The "minimal" distribution is like the minimal distributions that you can find for most of Unix distributions.<br/>Only the core layer is packaged, most of the features and bundles are downloaded from Internet at bootstrap.<br/>It means that Apache Karaf minimal distribution requires an Internet connection to start correctly.<br/>The features provided by the "minimal" distribution are exactly the same as in the "default" distribution, the difference<br/>is that the minimal distribution will download the features from Internet.</p><h3 id="InstallationonWindowsplatform">Installation on Windows platform</h3><p>NB: the JAVA_HOME environment variable has to be correctly defined. To accomplish that, press Windows key and Break key together, switch to "Ad
 vanced" tab and click on "Environment Variables".</p><ol><li>From a browser, navigate to <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>.</li><li>Download Apache Karaf binary distribution in the zip format: <tt>apache-karaf-4.0.0.zip</tt>.</li><li>Extract the files from the zip file into a directory of your choice (it's the <tt>KARAF_HOME</tt>.<p>NB: remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</p></li><li>Apache Karaf is now installed.</li></ol><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Handy Hint</b></p><p>In case you have to install Karaf into a very deep path or a path containing illegal characters for Java paths, e.g. !, % etc., you may add a bat file to <em>start \-> startup</em> that executes</p><pre>subst S: "C:\your very % problematic path!\KARAF"
 </pre><p>so your Karaf root directory is S: <del>-</del> which works for sure and is short to type.</p></div><h3 id="InstallationonUnixplatforms">Installation on Unix platforms</h3><p>NB: the JAVA_HOME environment variable has to be correctly defined. Check the current value using</p><pre>
 echo $JAVA_HOME
 </pre><p>If it's not correct, fix it using:</p><pre>
 export JAVA_HOME=....
-</pre><ol><li>From a browser, navigate to <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>.</li><li>Download Apache Karaf binary distribution in the tar.gz format: <tt>apache-karaf-3.0.0.tar.gz</tt>.</li><li>Extract the files from the tar.gz file into a directory of your choice (it's the <tt>KARAF_HOME</tt>). For example:<pre>
-gunzip apache-karaf-3.0.0.tar.gz
-tar xvf apache-karaf-3.0.0.tar
-</pre><p>NB: remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</p></li><li>Apache Karaf is now installed.</li></ol><h2 id="PostInstallationsteps">Post-Installation steps</h2><p>Thought it is not always required, it is strongly advised to set up the <tt>JAVA_HOME</tt> environment property to point to the JDK you want Apache Karaf to use before starting it.<br/>This property is used to locate the <tt>java</tt> executable and should be configured to point to the home directory of the Java SE 7 installation.</p><p>By default, all Apache Karaf files are "gather" in one directory: the <tt>KARAF_HOME</tt>.</p><p>You can define your own directory layout, by using some Karaf environment variables:</p><ul><li><tt>KARAF_DATA</tt> is the location of the data folder, where Karaf stores temporary files.</li><li><tt>KARAF_ETC</tt> is the location of the etc folder, where Karaf stores configuration files.</li><li><tt>KARAF_BASE</tt> is the Karaf base folder. By d
 efault <tt>KARAF_BASE</tt> is the same as <tt>KARAF_HOME</tt>.</li></ul><h2 id="BuildingfromSources">Building from Sources</h2><p>If you intend to build Apache Karaf from the sources, the requirements are a bit different:</p><p><strong>Hardware:</strong></p><ul><li>500 MB of free disk space for the Apache Karaf source distributions or SVN checkout, the Maven build and the dependencies Maven downloads.</li></ul><p><strong>Environment:</strong></p><ul><li>Java SE Development Kit 1.7.x or greater (<a href="http://www.oracle.com/technetwork/java/javase/">http://www.oracle.com/technetwork/java/javase/</a>).</li><li>Apache Maven 3.0.4 (<a href="http://maven.apache.org/download.html">http://maven.apache.org/download.html</a>).</li></ul><h3 id="BuildingonWindowsplatform">Building on Windows platform</h3><ol><li>You can get the Apache Karaf sources from:</li></ol><ul><li>the sources distribution <tt>apache-karaf-3.0.0-src.zip</tt> available at <a href="http://karaf.apache.org/index/community
 /download.html">http://karaf.apache.org/index/community/download.html</a>. Extract the files in the directory of your choice.</li><li>by checkout of the git repository:<pre>
+</pre><ol><li>From a browser, navigate to <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>.</li><li>Download Apache Karaf binary distribution in the tar.gz format: <tt>apache-karaf-4.0.0.tar.gz</tt>.</li><li>Extract the files from the tar.gz file into a directory of your choice (it's the <tt>KARAF_HOME</tt>). For example:<pre>
+gunzip apache-karaf-4.0.0.tar.gz
+tar xvf apache-karaf-4.0.0.tar
+</pre><p>NB: remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.</p></li><li>Apache Karaf is now installed.</li></ol><h2 id="PostInstallationsteps">Post-Installation steps</h2><p>Thought it is not always required, it is strongly advised to set up the <tt>JAVA_HOME</tt> environment property to point to the JDK you want Apache Karaf to use before starting it.<br/>This property is used to locate the <tt>java</tt> executable and should be configured to point to the home directory of the Java SE 7 installation.</p><p>By default, all Apache Karaf files are "gather" in one directory: the <tt>KARAF_HOME</tt>.</p><p>You can define your own directory layout, by using some Karaf environment variables:</p><ul><li><tt>KARAF_DATA</tt> is the location of the data folder, where Karaf stores temporary files.</li><li><tt>KARAF_ETC</tt> is the location of the etc folder, where Karaf stores configuration files.</li><li><tt>KARAF_BASE</tt> is the Karaf base folder. By d
 efault <tt>KARAF_BASE</tt> is the same as <tt>KARAF_HOME</tt>.</li></ul><h2 id="BuildingfromSources">Building from Sources</h2><p>If you intend to build Apache Karaf from the sources, the requirements are a bit different:</p><p><strong>Hardware:</strong></p><ul><li>500 MB of free disk space for the Apache Karaf source distributions or SVN checkout, the Maven build and the dependencies Maven downloads.</li></ul><p><strong>Environment:</strong></p><ul><li>Java SE Development Kit 1.7.x or greater (<a href="http://www.oracle.com/technetwork/java/javase/">http://www.oracle.com/technetwork/java/javase/</a>).</li><li>Apache Maven 3.0.4 or greater (<a href="http://maven.apache.org/download.html">http://maven.apache.org/download.html</a>).</li></ul><h3 id="BuildingonWindowsplatform">Building on Windows platform</h3><ol><li>You can get the Apache Karaf sources from:</li></ol><ul><li>the sources distribution <tt>apache-karaf-4.0.0-src.zip</tt> available at <a href="http://karaf.apache.org/inde
 x/community/download.html">http://karaf.apache.org/index/community/download.html</a>. Extract the files in the directory of your choice.</li><li>by checkout of the git repository:<pre>
 git clone https://git-wip-us.apache.org/repos/asf/karaf.git karaf
 </pre></li></ul><ol><li>Use Apache Maven to build Apache Karaf:<pre>
 mvn clean install
 </pre><p>NB: you can speed up the build by bypassing the unit tests:</p><pre>
 mvn clean install -DskipTests
-</pre></li><li>You can find the built binary distribution in <tt>assemblies\apache-karaf\target\apache-karaf-3.0.0.zip</tt>. You can install and use it as explained in the "Using Apache Karaf binary distributions" section.</li></ol><h3 id="BuildingonUnixplatforms">Building on Unix platforms</h3><ol><li>You can get the Apache Karaf sources from:</li></ol><ul><li>the sources distribution <tt>apache-karaf-3.0.0-src.tar.gz</tt> available at <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>. Extract the files in the directory of your choice.</li><li>by checkout of the git repository:<pre>
+</pre></li><li>You can find the built binary distribution in <tt>assemblies\apache-karaf\target\apache-karaf-4.0.0.zip</tt>. You can install and use it as explained in the "Using Apache Karaf binary distributions" section.</li></ol><h3 id="BuildingonUnixplatforms">Building on Unix platforms</h3><ol><li>You can get the Apache Karaf sources from:</li></ol><ul><li>the sources distribution <tt>apache-karaf-4.0.0-src.tar.gz</tt> available at <a href="http://karaf.apache.org/index/community/download.html">http://karaf.apache.org/index/community/download.html</a>. Extract the files in the directory of your choice.</li><li>by checkout of the git repository:<pre>
 git clone https://git-wip-us.apache.org/repos/asf/karaf.git karaf
 </pre></li></ul><ol><li>Use Apache Maven to build Apache Karaf:<pre>
 mvn clean install
 </pre><p>NB: you can speed up the build by bypassing the unit tests:</p><pre>
 mvn clean install -DskipTests
-</pre></li><li>You can find the built binary distribution in <tt>assemblies/apache-karaf/target/apache-karaf-3.0.0.tar.gz</tt>. You can install and use it as explained in the "Using Apache Karaf binary distributions" section.</li></ol>
+</pre></li><li>You can find the built binary distribution in <tt>assemblies/apache-karaf/target/apache-karaf-4.0.0.tar.gz</tt>. You can install and use it as explained in the "Using Apache Karaf binary distributions" section.</li></ol>
                 </div>
               </td>
             </tr>
@@ -141,7 +141,7 @@ mvn clean install -DskipTests
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/instances.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/instances.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/instances.html (original)
+++ karaf/site/production/manual/latest/users-guide/instances.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -187,13 +187,13 @@ karaf@root()>
 karaf@root()> instance:connect test feature:list
 Name                          | Version         | Installed | Repository                | Description
 ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
-standard                      | 3.0.0           | x         | standard-3.0.0            | Karaf standard feature
-aries-annotation              | 3.0.0           |           | standard-3.0.0            | Aries Annotations
-wrapper                       | 3.0.0           |           | standard-3.0.0            | Provide OS integration
-service-wrapper               | 3.0.0           |           | standard-3.0.0            | Provide OS integration (alias to wrapper feature)
-obr                           | 3.0.0           |           | standard-3.0.0            | Provide OSGi Bundle Repository (OBR) support
-config                        | 3.0.0           | x         | standard-3.0.0            | Provide OSGi ConfigAdmin support
-region                        | 3.0.0           | x         | standard-3.0.0            | Provide Region Support
+standard                      | 4.0.0           | x         | standard-4.0.0            | Karaf standard feature
+aries-annotation              | 4.0.0           |           | standard-4.0.0            | Aries Annotations
+wrapper                       | 4.0.0           |           | standard-4.0.0            | Provide OS integration
+service-wrapper               | 4.0.0           |           | standard-4.0.0            | Provide OS integration (alias to wrapper feature)
+obr                           | 4.0.0           |           | standard-4.0.0            | Provide OSGi Bundle Repository (OBR) support
+config                        | 4.0.0           | x         | standard-4.0.0            | Provide OSGi ConfigAdmin support
+region                        | 4.0.0           | x         | standard-4.0.0            | Provide Region Support
 ...
 </pre><h3 id="Stopaninstance">Stop an instance</h3><p>To stop an instance, you can connect to the instance (using <tt>instance:connect</tt>) and execute the <tt>system:shutdown</tt><br/>command.</p><p>You can also use the <a href="../commands/instance-stop.html"><tt>instance:stop</tt></a> command:</p><pre>
 karaf@root()> instance:stop test
@@ -265,7 +265,7 @@ OPTIONS
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/jdbc.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/jdbc.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/jdbc.html (original)
+++ karaf/site/production/manual/latest/users-guide/jdbc.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -217,7 +217,7 @@ REF_GENERATION | TYPE_NAME | TABLE_NAME
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/jms.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/jms.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/jms.html (original)
+++ karaf/site/production/manual/latest/users-guide/jms.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -115,22 +115,30 @@ DESCRIPTION
         Create a JMS connection factory.
 
 SYNTAX
-        jms:create [options] name 
+        jms:create [options] name
 
 ARGUMENTS
         name
                 The JMS connection factory name
 
 OPTIONS
-        -u, --url
-                The JMS URL. NB: for WebsphereMQ type, the URL is hostname/port/queuemanager/channel
-        --help
-                Display this help message
         -t, --type
                 The JMS connection factory type (ActiveMQ or WebsphereMQ)
+                (defaults to ActiveMQ)
+        -u, --username
+                Username to connect to the JMS broker
+                (defaults to karaf)
+        --help
+                Display this help message
+        --url
+                URL of the JMS broker. For WebsphereMQ type, the URL is hostname/port/queuemanager/channel
+                (defaults to tcp://localhost:61616)
+        -p, --password
+                Password to connect to the JMS broker
+                (defaults to karaf)
 
-</pre><ul><li>the <tt>name</tt> argument is required. It's the name of the JMS connection factory. The name is used to identify the connection factory, and to create the connection factory definition file (<tt>deploy/connectionfactory-<a href="name.html">name</a>.xml</tt>).</li><li>the <tt>-t</tt> (<tt>--type</tt>) option is required. It's the type of the JMS connection factory. Currently on <tt>activemq</tt> and <tt>webspheremq</tt> type are supported. If you want to use another type of JMS connection factory, you can create the <tt>deploy/connectionfactory-<a href="name.html">name</a>.xml</tt> file by hand (using one as template).</li><li>the <tt>-u</tt> (<tt>--url</tt>) option is required. It's the URL used by the JMS connection factory to connect to the broker. If the type is <tt>activemq</tt>, the URL looks like <tt>tcp://localhost:61616</tt>. If the type is <tt>webspheremq</tt>, the URL looks like <tt>host/port/queuemanager/channel</tt>.</li></ul><p>For instance, to create a J
 MS connection factory for a Apache ActiveMQ broker, you can do:</p><pre>
-karaf@root()> jms:create -t activemq -u tcp://localhost:61616 test
+</pre><ul><li>the <tt>name</tt> argument is required. It's the name of the JMS connection factory. The name is used to identify the connection factory, and to create the connection factory definition file (<tt>deploy/connectionfactory-<a href="name.html">name</a>.xml</tt>).</li><li>the <tt>-t</tt> (<tt>--type</tt>) option is required. It's the type of the JMS connection factory. Currently on <tt>activemq</tt> and <tt>webspheremq</tt> type are supported. If you want to use another type of JMS connection factory, you can create the <tt>deploy/connectionfactory-<a href="name.html">name</a>.xml</tt> file by hand (using one as template).</li><li>the <tt>--url</tt> option is required. It's the URL used by the JMS connection factory to connect to the broker. If the type is <tt>activemq</tt>, the URL looks like <tt>tcp://localhost:61616</tt>. If the type is <tt>webspheremq</tt>, the URL looks like <tt>host/port/queuemanager/channel</tt>.</li><li>the <tt>-u</tt> (<tt>--username</tt>) option 
 is optional (karaf by default). In the case of the broker requires authentication, it's the username used.</li><li>the <tt>-p</tt> (<tt>--password</tt>) option is optional (karaf by default). In the case of the broker requires authentication, it's the password used.</li></ul><p>For instance, to create a JMS connection factory for a Apache ActiveMQ broker, you can do:</p><pre>
+karaf@root()> jms:create -t activemq --url tcp://localhost:61616 test
 </pre><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>jms:create</tt> command doesn't install any feature or bundle providing the JMS connection factory classes (and dependencies).<br/>You have to install the required features (for instance <tt>activemq-broker</tt> feature for Apache ActiveMQ), or bundles (for IBM WebsphereMQ) providing the JMS connection factory packages and classes.</p></div><p>In the previous example, we assume that you previously installed the <tt>activemq-broker</tt> feature.</p><p>We can see the created JMS connection factory:</p><pre>
 karaf@root()> la
 ...
@@ -205,7 +213,7 @@ karaf@root()> jms:move /jms/test MyQueue
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/jndi.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/jndi.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/jndi.html (original)
+++ karaf/site/production/manual/latest/users-guide/jndi.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -185,7 +185,7 @@ osgi:service/jndi | org.apache.karaf.jnd
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/jpa.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/jpa.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/jpa.html (original)
+++ karaf/site/production/manual/latest/users-guide/jpa.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -125,7 +125,7 @@ karaf@root()> feature:install hibernate
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/jta.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/jta.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/jta.html (original)
+++ karaf/site/production/manual/latest/users-guide/jta.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -115,7 +115,7 @@ Properties:
    org.apache.karaf.features.configKey = org.apache.aries.transaction
    aries.transaction.howl.maxBlocksPerFile = 512
    aries.transaction.howl.maxLogFiles = 2
-   aries.transaction.howl.logFileDir = /opt/apache-karaf-3.0.0/data/txlog
+   aries.transaction.howl.logFileDir = /opt/apache-karaf-4.0.0/data/txlog
    aries.transaction.howl.bufferSizeKBytes = 4
 </pre><ul><li><tt>aries.transaction.recoverable</tt> property is a flag to enable support of recoverable resource or not. A recoverable<p> resource is a transactional object whose state is saved to stable storage if the transaction is committed, and whose<br/> state can be reset to what it was at the beginning of the transaction if the transaction is rolled back.<br/> At commit time, the transaction manager uses the two-phase XA protocol when communicating with the recoverable resource<br/> to ensure transactional integrity when more than one recoverable resource is involved in the transaction being committed.<br/> Transactional databases and message brokers like Apache ActiveMQ are examples of recoverable resources.<br/> A recoverable resource is represented using the javax.transaction.xa.XAResource interface in JTA.<br/> Default is <tt>true</tt>.</p></li><li><tt>aries.transaction.timeout</tt> property is the transaction timeout. If a transaction has a lifetime longer than this tim
 eout<p> a transaction exception is raised and the transaction is rollbacked. Default is <tt>600</tt> (10 minutes).</p></li><li><tt>aries.transaction.howl.logFileDir</tt> property is the directory where the transaction logs (journal) are stored.<p> Default is <tt>KARAF_DATA/txlog</tt>.</p></li><li><tt>aries.transaction.howl.maxLogFiles</tt> property is the maximum number of transaction log files to retain. Combined with the<p> <tt>aries.transaction.howl.maxBlocksPerFile</tt>, it defines the transaction retention.</p><p>You can change the configuration directly using the <tt>config:*</tt> commands, or the Config MBean.</p><p>For instance, to increase the transaction timeout, you can do:</p><pre>
 karaf@root()> config:edit org.apache.aries.transaction
@@ -132,7 +132,7 @@ Properties:
    org.apache.karaf.features.configKey = org.apache.aries.transaction
    aries.transaction.howl.maxBlocksPerFile = 512
    aries.transaction.howl.maxLogFiles = 2
-   aries.transaction.howl.logFileDir = /opt/apache-karaf-3.0.0/data/txlog
+   aries.transaction.howl.logFileDir = /opt/apache-karaf-4.0.0/data/txlog
    aries.transaction.howl.bufferSizeKBytes = 4
 </pre></li></ul><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p>The <tt>transaction</tt> feature defines the configuration in memory by default. It means that changes that you can do will<br/>be lost in case of Apache Karaf restart.<br/>If you want to define your own transaction configuration at startup, you have to create a <tt>etc/org.apache.aries.transaction.cfg</tt><br/>configuration file and set the properties and values in the file. For instance:</p><pre>
 # etc/org.apache.aries.transaction.cfg
@@ -140,7 +140,7 @@ aries.transaction.recoverable = true
 aries.transaction.timeout = 1200
 aries.transaction.howl.maxBlocksPerFile = 512
 aries.transaction.howl.maxLogFiles = 2
-aries.transaction.howl.logFileDir = /opt/apache-karaf-3.0.0/data/txlog
+aries.transaction.howl.logFileDir = /opt/apache-karaf-4.0.0/data/txlog
 aries.transaction.howl.bufferSizeKBytes = 4
 </pre></div>
                 </div>
@@ -162,7 +162,7 @@ aries.transaction.howl.bufferSizeKBytes
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>

Modified: karaf/site/production/manual/latest/users-guide/kar.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/users-guide/kar.html?rev=1688715&r1=1688714&r2=1688715&view=diff
==============================================================================
--- karaf/site/production/manual/latest/users-guide/kar.html (original)
+++ karaf/site/production/manual/latest/users-guide/kar.html Wed Jul  1 19:43:35 2015
@@ -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.3-SNAPSHOT Guides
+      Apache Karaf 4.0.1-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,13 +101,13 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h1 id="KAR">KAR</h1><p>As described in the <a href="provisioning.html">Provisioning section</a>, Apache Karaf features describe applications.</p><p>A feature defines different resources to resolve using URL (for instance, bundles URLs, or configuration files URLs).<br/>As described in the <a href="urls.html">Artifacts repositories and URLs section</a>, Apache Karaf looks for artifacts (bundles,<br/>configuration files, ...) in the artifact repositories.<br/>Apache Karaf may require to download artifacts from remote repositories.</p><p>Apache Karaf provides a special type of artifact that package a features XML and all resources described in the features<br/>of this XML. This artifact is named a KAR (KAraf aRchive).</p><p>A KAR file is a zip archive containing the</p><p>Basically, the kar format is a jar (so a zip file) which contains a set of feature descriptor and bundle jar files.</p><p>A KAR file contains a <tt>repository</tt> folder containing:</p><ul><li>a set of features XML 
 files</li><li>the artifacts following the Maven directory structure (<tt>groupId/artifactId/version/artifactId-version.type</tt>).</li></ul><p>For instance, the <tt>spring-3.0.0.kar</tt> contains:</p><pre>
-~$ unzip -l spring-3.0.0.kar
-Archive:  spring-3.0.0.kar
+<h1 id="KAR">KAR</h1><p>As described in the <a href="provisioning.html">Provisioning section</a>, Apache Karaf features describe applications.</p><p>A feature defines different resources to resolve using URL (for instance, bundles URLs, or configuration files URLs).<br/>As described in the <a href="urls.html">Artifacts repositories and URLs section</a>, Apache Karaf looks for artifacts (bundles,<br/>configuration files, ...) in the artifact repositories.<br/>Apache Karaf may require to download artifacts from remote repositories.</p><p>Apache Karaf provides a special type of artifact that package a features XML and all resources described in the features<br/>of this XML. This artifact is named a KAR (KAraf aRchive).</p><p>A KAR file is a zip archive containing the</p><p>Basically, the kar format is a jar (so a zip file) which contains a set of feature descriptor and bundle jar files.</p><p>A KAR file contains a <tt>repository</tt> folder containing:</p><ul><li>a set of features XML 
 files</li><li>the artifacts following the Maven directory structure (<tt>groupId/artifactId/version/artifactId-version.type</tt>).</li></ul><p>For instance, the <tt>spring-4.0.0.kar</tt> contains:</p><pre>
+~$ unzip -l spring-4.0.0.kar
+Archive:  spring-4.0.0.kar
   Length      Date    Time    Name
 ---------  ---------- -----   ----
       143  2013-12-06 10:52   META-INF/MANIFEST.MF
-    12186  2013-12-06 10:52   repository/org/apache/karaf/features/spring/3.0.0/spring-3.0.0-features.xml
+    12186  2013-12-06 10:52   repository/org/apache/karaf/features/spring/4.0.0/spring-4.0.0-features.xml
    575389  2013-12-06 10:52   repository/commons-collections/commons-collections/3.2.1/commons-collections-3.2.1.jar
    232019  2013-12-06 10:52   repository/commons-beanutils/commons-beanutils/1.8.3/commons-beanutils-1.8.3.jar
    673109  2013-12-06 10:52   repository/org/apache/servicemix/bundles/org.apache.servicemix.bundles.struts/1.3.10_1/org.apache.servicemix.bundles.struts-1.3.10_1.jar
@@ -121,7 +121,7 @@ Archive:  spring-3.0.0.kar
    340841  2013-12-06 10:52   repository/org/springframework/org.springframework.aop/3.2.4.RELEASE/org.springframework.aop-3.2.4.RELEASE.jar
    877369  2013-12-06 10:52   repository/org/springframework/org.springframework.context/3.2.4.RELEASE/org.springframework.context-3.2.4.RELEASE.jar
    130224  2013-12-06 10:52   repository/org/springframework/org.springframework.context.support/3.2.4.RELEASE/org.springframework.context.support-3.2.4.RELEASE.jar
-    30640  2013-12-06 10:52   repository/org/apache/karaf/deployer/org.apache.karaf.deployer.spring/3.0.0/org.apache.karaf.deployer.spring-3.0.0.jar
+    30640  2013-12-06 10:52   repository/org/apache/karaf/deployer/org.apache.karaf.deployer.spring/4.0.0/org.apache.karaf.deployer.spring-4.0.0.jar
     51951  2013-12-06 10:52   repository/org/springframework/org.springframework.aspects/3.2.4.RELEASE/org.springframework.aspects-3.2.4.RELEASE.jar
    411175  2013-12-06 10:52   repository/org/springframework/org.springframework.jdbc/3.2.4.RELEASE/org.springframework.jdbc-3.2.4.RELEASE.jar
     48049  2013-12-06 10:52   repository/javax/portlet/portlet-api/2.0/portlet-api-2.0.jar
@@ -140,7 +140,7 @@ Archive:  spring-3.0.0.kar
    362889  2013-12-06 10:52   repository/org/springframework/osgi/spring-osgi-core/1.2.1/spring-osgi-core-1.2.1.jar
    120822  2013-12-06 10:52   repository/org/springframework/osgi/spring-osgi-extender/1.2.1/spring-osgi-extender-1.2.1.jar
     24231  2013-12-06 10:52   repository/org/springframework/osgi/spring-osgi-annotation/1.2.1/spring-osgi-annotation-1.2.1.jar
-    12597  2013-12-06 10:52   repository/org/apache/karaf/bundle/org.apache.karaf.bundle.springstate/3.0.0/org.apache.karaf.bundle.springstate-3.0.0.jar
+    12597  2013-12-06 10:52   repository/org/apache/karaf/bundle/org.apache.karaf.bundle.springstate/4.0.0/org.apache.karaf.bundle.springstate-4.0.0.jar
     31903  2013-12-06 10:52   repository/org/eclipse/gemini/blueprint/gemini-blueprint-io/1.0.0.RELEASE/gemini-blueprint-io-1.0.0.RELEASE.jar
    578205  2013-12-06 10:52   repository/org/eclipse/gemini/blueprint/gemini-blueprint-core/1.0.0.RELEASE/gemini-blueprint-core-1.0.0.RELEASE.jar
    178525  2013-12-06 10:52   repository/org/eclipse/gemini/blueprint/gemini-blueprint-extender/1.0.0.RELEASE/gemini-blueprint-extender-1.0.0.RELEASE.jar
@@ -153,7 +153,7 @@ Archive:  spring-3.0.0.kar
 ~$ zip -r my.kar repository
 updating: repository/ (stored 0%)
   adding: repository/my/project/my/1.0.0/my-1.0.0.jar (deflated 0%)
-</pre><p>You can create KAR files using Apache Maven, or directly in the Apache Karaf console.</p><h2 id="Maven">Maven</h2><p>Apache Karaf provides a Maven plugin: <tt>karaf-maven-plugin</tt>.</p><p>The Apache Karaf Maven plugin provides the <tt>features-create-kar</tt> goal.</p><p>The <tt>features-create-kar</tt> goal does:<br/>1. Reads all features specified in the features XML.<br/>2. For each feature described in the features XML, the goal resolves the bundles described in the feature.<br/>3. The goal finally packages the features XML, and the resolved bundles in a zip file.</p><p>You can also use the Karaf maven plugin. The features maven plugin provides an features-create-kar goal.</p><p>The features-create-kar goal:<br/>1. Reads all features specified in the features descriptor.<br/>2. For each feature, it resolves the bundles defined in the feature.<br/>3. All bundles are packaged into the kar archive.</p><p>For instance, the following Maven POM create <tt>my-kar.kar</tt></p
 ><p>For instance, you can use the following POM to create a kar:</p><pre>
+</pre><p>You can create KAR files using Apache Maven, or directly in the Apache Karaf console.</p><h2 id="Maven">Maven</h2><p>Apache Karaf provides a Maven plugin: <tt>karaf-maven-plugin</tt>.</p><p>The Apache Karaf Maven plugin provides the <tt>kar</tt> goal.</p><p>The <tt>kar</tt> goal does:<br/>1. Reads all features specified in the features XML.<br/>2. For each feature described in the features XML, the goal resolves the bundles described in the feature.<br/>3. The goal finally packages the features XML, and the resolved bundles in a zip file.</p><p>For instance, the following Maven POM create <tt>my-kar.kar</tt></p><p>For instance, you can use the following POM to create a kar:</p><pre>
 &lt;?xml version="1.0" encoding="UTF-8"?>
 &lt;project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 
@@ -162,25 +162,15 @@ updating: repository/ (stored 0%)
     &lt;groupId>my.groupId&lt;/groupId>
     &lt;artifactId>my-kar&lt;/artifactId>
     &lt;version>1.0&lt;/version>
-    &lt;packaging>pom&lt;/packaging>
+    &lt;packaging>kar&lt;/packaging>
 
     &lt;build>
         &lt;plugins>
             &lt;plugin>
                 &lt;groupId>org.apache.karaf.tooling&lt;/groupId>
                 &lt;artifactId>karaf-maven-plugin&lt;/artifactId>
-                &lt;version>3.0.0&lt;/version>
-                &lt;executions>
-                    &lt;execution>
-                        &lt;id>features-create-kar&lt;/id>
-                        &lt;goals>
-                            &lt;goal>features-create-kar&lt;/goal>
-                        &lt;/goals>
-                        &lt;configuration>
-                            &lt;featuresFile>src/main/resources/features.xml&lt;/featuresFile>
-                        &lt;/configuration>
-                    &lt;/execution>
-                &lt;/executions>
+                &lt;version>4.0.0&lt;/version>
+                &lt;extensions>true&lt;/extensions>
             &lt;/plugin>
         &lt;/plugins>
     &lt;/build>
@@ -197,23 +187,27 @@ my-kar-1.0-SNAPSHOT
 karaf@root()> feature:repo-list
 Repository                       | URL
 -------------------------------------------------------------------------------------------------------
-standard-3.0.0                   | mvn:org.apache.karaf.features/standard/3.0.0/xml/features
-enterprise-3.0.0                 | mvn:org.apache.karaf.features/enterprise/3.0.0/xml/features
-spring-3.0.0                     | mvn:org.apache.karaf.features/spring/3.0.0/xml/features
-org.ops4j.pax.web-3.0.5          | mvn:org.ops4j.pax.web/pax-web-features/3.0.5/xml/features
+standard-4.0.0                   | mvn:org.apache.karaf.features/standard/4.0.0/xml/features
+enterprise-4.0.0                 | mvn:org.apache.karaf.features/enterprise/4.0.0/xml/features
+spring-4.0.0                     | mvn:org.apache.karaf.features/spring/4.0.0/xml/features
+org.ops4j.pax.web-4.1.4          | mvn:org.ops4j.pax.web/pax-web-features/4.1.4/xml/features
 </pre><p>You can use one of these features repositories to create the kar file:</p><pre>
-karaf@root()> kar:create org.ops4j.pax.web-3.0.5
-Adding feature pax-war
-Adding feature pax-http-whiteboard
+karaf@root()> kar:create org.ops4j.pax.web-4.1.4
 Adding feature pax-jetty
-Adding feature pax-tomcat
+Adding feature pax-http-whiteboard
+Adding feature pax-war
+Adding feature pax-http-tomcat
+Adding feature pax-war-tomcat
 Adding feature pax-http
-Kar file created : /opt/apache-karaf-3.0.0/data/kar/org.ops4j.pax.web-3.0.5.kar
+Adding feature pax-http-jetty
+Adding feature pax-jsf-support
+Adding feature pax-jetty-spdy
+Kar file created : /home/jbonofre/Downloads/apache-karaf-4.0.0/data/kar/org.ops4j.pax.web-4.1.4.kar
 </pre><p>You can see that the KAR file has been created in the <tt>KARAF_DATA/kar</tt> folder.</p><p>By default, the <tt>kar:create</tt> command creates a KAR file, packaging all features in the features descriptor.</p><p>You can provide the list of features that you want to package into the KAR file:</p><pre>
-karaf@root()> kar:create org.ops4j.pax.web-3.0.5 pax-jetty pax-tomcat
+karaf@root()> kar:create org.ops4j.pax.web-4.1.4 pax-jetty pax-tomcat
 Adding feature pax-jetty
 Adding feature pax-tomcat
-Kar file created : /opt/apache-karaf-3.0.0/data/kar/org.ops4j.pax.web-3.0.5.kar
+Kar file created : /opt/apache-karaf-4.1.4/data/kar/org.ops4j.pax.web-4.1.4.kar
 </pre><h3 id="karinstall"><tt>kar:install</tt></h3><p>You can deploy a KAR file using <tt>kar:install</tt> command.</p><p>The <tt>kar:install</tt> command expects the KAR URL. Any URL described in the <a href="urls.html">Artifacts repositories and URLs section</a><br/>is supported by the <tt>kar:install</tt> command:</p><pre>
 karaf@root()> kar:install file:/tmp/my-kar-1.0-SNAPSHOT.kar
 </pre><p>The KAR file is uncompressed and populated the <tt>KARAF_BASE/system</tt> folder.</p><p>The Apache Karaf KAR service is looking for features XML files in the KAR file, registers the features XML and automatically<br/>installs all features described in the features repositories present in the KAR file.</p><h3 id="karuninstall"><tt>kar:uninstall</tt></h3><p>The <tt>kar:uninstall</tt> command uninstall a KAR file (identified by a name).</p><p>By uninstall, it means that:</p><ul><li>the features previously installed by the KAR file are uninstalled</li><li>delete (from the <tt>KARAF_DATA/system</tt> repository) all files previously "populated" by the KAR file</li></ul><p>For instance, to uninstall the previously installed <tt>my-kar-1.0-SNAPSHOT.kar</tt> KAR file:</p><pre>
@@ -263,7 +257,7 @@ noAutoRefreshBundles=false
         <td id="cell-3-2">
           <div id="footer">
             <div id="site-footer">
-              &copy; 2008-2011 The Apache Software Foundation
+              &copy; 2008-2014 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>



Mime
View raw message