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 2014/08/05 17:46:57 UTC

svn commit: r1615948 [4/7] - in /karaf/site/production/manual/latest-2.3.x: ./ commands/ developers-guide/ users-guide/

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-create-kar.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-create-kar.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-create-kar.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-create-kar.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,29 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h2 id="Goalfeaturescreatekar">Goal <tt>features:create-kar</tt></h2><p>The <tt>features:create-kar</tt> goal creates a kar file from a given features XML.<br/>A kar file is a zip archive shipping all bundles and configuration files containing in features of a features XML, and the features XML itself.<br/>You can deploy a kar file just by copying it in the deploy folder, all resources will be loaded from the kar file.</p><h3 id="Example">Example</h3><p>The example below generates a kar file from a given features XML. The generated kar will be in the target folder with the manual-2.3.2.kar name.</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-&lt;project&gt;
-  &lt;build&gt;
-    &lt;plugins&gt;
-      &lt;plugin&gt;
-        &lt;groupId&gt;org.apache.karaf.tooling&lt;/groupId&gt;
-        &lt;artifactId&gt;features-maven-plugin&lt;/artifactId&gt;
-        &lt;version&gt;2.3.2&lt;/version&gt;
-          &lt;executions&gt;
-            &lt;execution&gt;
-              &lt;id&gt;create-kar&lt;/id&gt;
-              &lt;goals&gt;
-                &lt;goal&gt;create-kar&lt;/goal&gt;
-              &lt;/goals&gt;
-              &lt;configuration&gt;
-                &lt;featuresFile&gt;/x1/asf/karaf-2.3.x/manual/src/main/resources/features.xml&lt;/featuresFile&gt;
-              &lt;/configuration&gt;
-            &lt;/execution&gt;
-          &lt;/executions&gt;
-        &lt;/plugin&gt;
-    &lt;/plugins&gt;
-  &lt;/build&gt;
-&lt;/project&gt;</code></pre></div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>featuresFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML used to generate the KAR file <br/> Default value: <tt>/x1/asf/karaf-2.3.x/manual/target/feature/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> {{resourcesDir} </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Location of resources directory for additional content to include in the KAR. Note that it includes everything under classes so as to include maven-remote-resources <br/> Default value: /x1/asf/karaf-2.3.x/manual/target/classes}} </td></tr><tr><td class="confluenceTd"> <tt>finalName</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confl
 uenceTd"> Name of the generated kar <br/> Default value: <tt>manual-2.3.2</tt> </td></tr><tr><td class="confluenceTd"> <tt>outputDirectory</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Directory containing the generated archive <br/> Default value: <tt>/x1/asf/karaf-2.3.x/manual/target</tt> </td></tr></table></div>
+<h2 id="Goalfeaturescreatekar">Goal <tt>features:create-kar</tt></h2><p>The <tt>features:create-kar</tt> goal creates a kar file from a given features XML.<br/>A kar file is a zip archive shipping all bundles and configuration files containing in features of a features XML, and the features XML itself.<br/>You can deploy a kar file just by copying it in the deploy folder, all resources will be loaded from the kar file.</p><h3 id="Example">Example</h3><p>The example below generates a kar file from a given features XML. The generated kar will be in the target folder with the manual-2.3.7-SNAPSHOT.kar name.</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span clas
 s="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.3.7-SNAPSHOT<span class="nt">&lt;/version&gt;</span>&#x000A;          <span class="nt">&lt;executions&gt;</span>&#x000A;            <span class="nt">&lt;execution&gt;</span>&#x000A;              <span class="nt">&lt;id&gt;</span>create-kar<span class="nt">&lt;/id&gt;</span>&#x000A;              <span class="nt">&lt;goals&gt;</span>&#x000A;                <span class="nt">&lt;goal&gt;</span>create-kar<span class="nt">&lt;/goal&gt;</span>&#x000A;              <span class="nt">&lt;/goals&gt;</span>&#x000A;              <span class="nt">&lt;configuration&gt;</span>&#x000A;                <span class="nt">&lt;featuresFile&gt;</span>/home/jbonofre/Workspace/karaf/manual/src/main/resources/features.xml<span class="nt">&lt;/featuresFile&gt;</span>&#x000A;              <span class="nt">&lt;/configuration&gt;</span>&#x000A;            <span c
 lass="nt">&lt;/execution&gt;</span>&#x000A;          <span class="nt">&lt;/executions&gt;</span>&#x000A;        <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>&#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>featuresFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML used to generate the KAR file <br/> Default value: <tt>/home/jbonofre/Workspace/karaf/manual/target/feature/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> {{resourcesDir} </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Location of resources directory for additional c
 ontent to include in the KAR. Note that it includes everything under classes so as to include maven-remote-resources <br/> Default value: /home/jbonofre/Workspace/karaf/manual/target/classes}} </td></tr><tr><td class="confluenceTd"> <tt>finalName</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> Name of the generated kar <br/> Default value: <tt>manual-2.3.7-SNAPSHOT</tt> </td></tr><tr><td class="confluenceTd"> <tt>outputDirectory</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Directory containing the generated archive <br/> Default value: <tt>/home/jbonofre/Workspace/karaf/manual/target</tt> </td></tr></table></div>
                 </div>
               </td>
             </tr>

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-generate.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-generate.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-generate.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-generate.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,39 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h2 id="Goalfeaturesgenerate">Goal <tt>features:generate</tt></h2><p>The <tt>features:generate-features-xml</tt> goal generates a features XML file for every bundle listed in the project's dependencies.  In order to satisfy the required imports in these bundles, the plugin will add bundles:</p><ul style="list-style: square"><li>bundles provided by Apache Karaf</li><li>a explicit list of bundles</li><li>bundles discovered in the POM's transitive dependencies</li></ul><p>Afterwards, the generated file will be attached to the build as an additional build artifact (by default as <tt>group:artifact:version:xml:features</tt>).</p><h3 id="Example">Example</h3><p>The example below generates one feature that installs bundle <tt>mvn:org.apache:bundle1:1.0</tt> in a features XML file called <tt>target/features.xml</tt>.  It will find bundle in Apache Karaf 2.3.2, the transitive dependencies for this POM and the bundles listed in <tt>src/main/resources/bundles.properties</tt>. </p><div class="s
 yntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-&lt;project&gt;
-  &lt;dependencies&gt;
-    &lt;dependency&gt;
-      &lt;groupId&gt;org.apache&lt;/groupId&gt;
-      &lt;artifactId&gt;bundle1&lt;/artifactId&gt;
-      &lt;version&gt;1.0&lt;/version&gt;
-    &lt;/dependency&gt;
-  &lt;/dependencies&gt;
-  &lt;build&gt;
-    &lt;plugins&gt;
-      &lt;plugin&gt;
-        &lt;groupId&gt;org.apache.karaf.tooling&lt;/groupId&gt;
-        &lt;artifactId&gt;features-maven-plugin&lt;/artifactId&gt;
-        &lt;version&gt;2.3.2&lt;/version&gt;
-          &lt;executions&gt;
-            &lt;execution&gt;
-              &lt;id&gt;generate&lt;/id&gt;
-              &lt;phase&gt;generate-resources&lt;/phase&gt;
-              &lt;goals&gt;
-                &lt;goal&gt;generate-features-xml&lt;/goal&gt;
-              &lt;/goals&gt;
-              &lt;configuration&gt;
-                &lt;bundles&gt;src/main/resources/bundles.properties&lt;/bundles&gt;
-                &lt;kernelVersion&gt;2.3.2&lt;/kernelVersion&gt;
-                &lt;outputFile&gt;target/features.xml&lt;/outputFile&gt;
-              &lt;/configuration&gt;
-            &lt;/execution&gt;
-          &lt;/executions&gt;
-        &lt;/plugin&gt;
-    &lt;/plugins&gt;
-  &lt;/build&gt;  
-&lt;/project&gt;</code></pre></div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>outputFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Name of the features XML file that is being generated <br/> Default value: <tt>/x1/asf/karaf-2.3.x/manual/target/classes/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactType</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact type for attaching the generated file to the project <br/> Default value: {{xml}) </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactClassifier</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact classifier for attaching the generated file to the project <br/> Defau
 lt value: <tt>features</tt> </td></tr><tr><td class="confluenceTd"> <tt>kernelVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The version of Karaf that is used to determine system bundles and default provided features </td></tr><tr><td class="confluenceTd"> <tt>bundles</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> A properties file that contains a list of bundles that will be used to generate the features.xml file </td></tr></table></div>
+<h2 id="Goalfeaturesgenerate">Goal <tt>features:generate</tt></h2><p>The <tt>features:generate-features-xml</tt> goal generates a features XML file for every bundle listed in the project's dependencies.  In order to satisfy the required imports in these bundles, the plugin will add bundles:</p><ul style="list-style: square"><li>bundles provided by Apache Karaf</li><li>a explicit list of bundles</li><li>bundles discovered in the POM's transitive dependencies</li></ul><p>Afterwards, the generated file will be attached to the build as an additional build artifact (by default as <tt>group:artifact:version:xml:features</tt>).</p><h3 id="Example">Example</h3><p>The example below generates one feature that installs bundle <tt>mvn:org.apache:bundle1:1.0</tt> in a features XML file called <tt>target/features.xml</tt>.  It will find bundle in Apache Karaf 2.3.7-SNAPSHOT, the transitive dependencies for this POM and the bundles listed in <tt>src/main/resources/bundles.properties</tt>. </p><div
  class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;dependencies&gt;</span>&#x000A;    <span class="nt">&lt;dependency&gt;</span>&#x000A;      <span class="nt">&lt;groupId&gt;</span>org.apache<span class="nt">&lt;/groupId&gt;</span>&#x000A;      <span class="nt">&lt;artifactId&gt;</span>bundle1<span class="nt">&lt;/artifactId&gt;</span>&#x000A;      <span class="nt">&lt;version&gt;</span>1.0<span class="nt">&lt;/version&gt;</span>&#x000A;    <span class="nt">&lt;/dependency&gt;</span>&#x000A;  <span class="nt">&lt;/dependencies&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>
 &#x000A;        <span class="nt">&lt;version&gt;</span>2.3.7-SNAPSHOT<span class="nt">&lt;/version&gt;</span>&#x000A;          <span class="nt">&lt;executions&gt;</span>&#x000A;            <span class="nt">&lt;execution&gt;</span>&#x000A;              <span class="nt">&lt;id&gt;</span>generate<span class="nt">&lt;/id&gt;</span>&#x000A;              <span class="nt">&lt;phase&gt;</span>generate-resources<span class="nt">&lt;/phase&gt;</span>&#x000A;              <span class="nt">&lt;goals&gt;</span>&#x000A;                <span class="nt">&lt;goal&gt;</span>generate-features-xml<span class="nt">&lt;/goal&gt;</span>&#x000A;              <span class="nt">&lt;/goals&gt;</span>&#x000A;              <span class="nt">&lt;configuration&gt;</span>&#x000A;                <span class="nt">&lt;bundles&gt;</span>src/main/resources/bundles.properties<span class="nt">&lt;/bundles&gt;</span>&#x000A;                <span class="nt">&lt;kernelVersion&gt;</span>2.3.7-SNAPSHOT<span class="nt">&lt;/kern
 elVersion&gt;</span>&#x000A;                <span class="nt">&lt;outputFile&gt;</span>target/features.xml<span class="nt">&lt;/outputFile&gt;</span>&#x000A;              <span class="nt">&lt;/configuration&gt;</span>&#x000A;            <span class="nt">&lt;/execution&gt;</span>&#x000A;          <span class="nt">&lt;/executions&gt;</span>&#x000A;        <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>outputFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> Name of the features XML file that is being generated <br/> Default value: <tt>
 /home/jbonofre/Workspace/karaf/manual/target/classes/feature.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactType</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact type for attaching the generated file to the project <br/> Default value: {{xml}) </td></tr><tr><td class="confluenceTd"> <tt>attachmentArtifactClassifier</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The artifact classifier for attaching the generated file to the project <br/> Default value: <tt>features</tt> </td></tr><tr><td class="confluenceTd"> <tt>kernelVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The version of Karaf that is used to determine system bundles and default provided features </td></tr><tr><td class="confluenceTd"> <tt>bundles</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> A properties file that contains a list of bundles
  that will be used to generate the features.xml file </td></tr></table></div>
                 </div>
               </td>
             </tr>

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-validate.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-validate.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-validate.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin-validate.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,38 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h2 id="Goalfeaturesvalidate">Goal <tt>features:validate</tt></h2><p>The <tt>features:validate</tt> goal validates a features XML descriptor by checking if all the required imports for the bundles defined in the features can be matched to a provided export.</p><p>By default, the plugin tries to add the Karaf standard features (standard and enterprise) in the repositories set.<br/>It means that it's not necessary to explicitly define the Karaf features descriptor in the repository section of your features descriptor.</p><h3 id="Example">Example</h3><p>The example below validates the features defined in the <tt>target/features.xml</tt> by checking all the imports and exports.  It reads the definition for the packages that are exported by the system bundle from the <tt>src/main/resources/config.properties</tt> file.</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-&lt;project&gt;
-  &lt;build&gt;
-    &lt;plugins&gt;
-      &lt;plugin&gt;
-        &lt;groupId&gt;org.apache.karaf.tooling&lt;/groupId&gt;
-        &lt;artifactId&gt;features-maven-plugin&lt;/artifactId&gt;
-        &lt;version&gt;2.3.2&lt;/version&gt;
-          &lt;executions&gt;
-            &lt;execution&gt;
-              &lt;id&gt;validate&lt;/id&gt;
-              &lt;phase&gt;process-resources&lt;/phase&gt;
-              &lt;goals&gt;
-                &lt;goal&gt;validate&lt;/goal&gt;
-              &lt;/goals&gt;
-              &lt;configuration&gt;
-                &lt;file&gt;target/features.xml&lt;/file&gt;
-                &lt;karafConfig&gt;src/main/resources/config.properties&lt;/karafConfig&gt;
-              &lt;/configuration&gt;
-            &lt;/execution&gt;
-          &lt;/executions&gt;
-          &lt;dependencies&gt;
-            &lt;dependency&gt;
-              &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
-              &lt;artifactId&gt;slf4j-simple&lt;/artifactId&gt;
-              &lt;version&gt;1.4.3&lt;/version&gt;
-	        &lt;/dependency&gt;
-          &lt;/dependencies&gt;
-        &lt;/plugin&gt;
-    &lt;/plugins&gt;
-  &lt;/build&gt;  
-&lt;/project&gt;</code></pre></div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>file</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML descriptor file to validate. <br/> Default value: <tt>/x1/asf/karaf-2.3.x/manual/target/classes/features.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>karafConfig</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The Karaf <tt>config.properties</tt> file to use during the validation process <br/> Default value: <tt>config.properties</tt> </td></tr><tr><td class="confluenceTd"> <tt>jreVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The JRE version that is used during the validation process <br/> Default value: {{jre-1.5}) <
 /td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The target Karaf version used to get the Karaf core features (standard and enterprise) <br/> Default value is the version of the plugin </td></tr><tr><td class="confluenceTd"> <tt>repositories</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> Additional features XML descriptors that will be used during the validation process </td></tr></table></div>
+<h2 id="Goalfeaturesvalidate">Goal <tt>features:validate</tt></h2><p>The <tt>features:validate</tt> goal validates a features XML descriptor by checking if all the required imports for the bundles defined in the features can be matched to a provided export.</p><p>By default, the plugin tries to add the Karaf standard features (standard and enterprise) in the repositories set.<br/>It means that it's not necessary to explicitly define the Karaf features descriptor in the repository section of your features descriptor.</p><h3 id="Example">Example</h3><p>The example below validates the features defined in the <tt>target/features.xml</tt> by checking all the imports and exports.  It reads the definition for the packages that are exported by the system bundle from the <tt>src/main/resources/config.properties</tt> file.</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;pl
 ugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&gt;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.3.7-SNAPSHOT<span class="nt">&lt;/version&gt;</span>&#x000A;          <span class="nt">&lt;executions&gt;</span>&#x000A;            <span class="nt">&lt;execution&gt;</span>&#x000A;              <span class="nt">&lt;id&gt;</span>validate<span class="nt">&lt;/id&gt;</span>&#x000A;              <span class="nt">&lt;phase&gt;</span>process-resources<span class="nt">&lt;/phase&gt;</span>&#x000A;              <span class="nt">&lt;goals&gt;</span>&#x000A;                <span class="nt">&lt;goal&gt;</span>validate<span class="nt">&lt;/goal&gt;</span>&#x000A;              <span class="nt">&lt;/goals&gt;</span>&#x000A;             
  <span class="nt">&lt;configuration&gt;</span>&#x000A;                <span class="nt">&lt;file&gt;</span>target/features.xml<span class="nt">&lt;/file&gt;</span>&#x000A;                <span class="nt">&lt;karafConfig&gt;</span>src/main/resources/config.properties<span class="nt">&lt;/karafConfig&gt;</span>&#x000A;              <span class="nt">&lt;/configuration&gt;</span>&#x000A;            <span class="nt">&lt;/execution&gt;</span>&#x000A;          <span class="nt">&lt;/executions&gt;</span>&#x000A;          <span class="nt">&lt;dependencies&gt;</span>&#x000A;            <span class="nt">&lt;dependency&gt;</span>&#x000A;              <span class="nt">&lt;groupId&gt;</span>org.slf4j<span class="nt">&lt;/groupId&gt;</span>&#x000A;              <span class="nt">&lt;artifactId&gt;</span>slf4j-simple<span class="nt">&lt;/artifactId&gt;</span>&#x000A;              <span class="nt">&lt;version&gt;</span>1.4.3<span class="nt">&lt;/version&gt;</span>&#x000A;	        <span class="nt">&lt;
 /dependency&gt;</span>&#x000A;          <span class="nt">&lt;/dependencies&gt;</span>&#x000A;        <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div><h3 id="Parameters">Parameters</h3><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt>file</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The features XML descriptor file to validate. <br/> Default value: <tt>/home/jbonofre/Workspace/karaf/manual/target/classes/features.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>karafConfig</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The Karaf <tt>config.properties</tt> file to use during th
 e validation process <br/> Default value: <tt>config.properties</tt> </td></tr><tr><td class="confluenceTd"> <tt>jreVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The JRE version that is used during the validation process <br/> Default value: {{jre-1.5}) </td></tr><tr><td class="confluenceTd"> <tt>karafVersion</tt> </td><td class="confluenceTd"> <tt>String</tt> </td><td class="confluenceTd"> The target Karaf version used to get the Karaf core features (standard and enterprise) <br/> Default value is the version of the plugin </td></tr><tr><td class="confluenceTd"> <tt>repositories</tt> </td><td class="confluenceTd"> <tt>String[]</tt> </td><td class="confluenceTd"> Additional features XML descriptors that will be used during the validation process </td></tr></table></div>
                 </div>
               </td>
             </tr>

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/features-maven-plugin.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>
@@ -101,22 +101,7 @@
               </td>
               <td height="100%" width="100%">
                 <div class="wiki-content">
-<h1 id="Usingthefeaturesmavenplugin">Using the features-maven-plugin</h1><p>The <tt>features-maven-plugin</tt> provides several goals to help you create and validate features XML descriptors as well as leverage your features to create a custom Karaf distribution.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Goal </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-add.html">features:add-features-to-repo</a></tt> </td><td class="confluenceTd"> Copies all the bundles required for a given set of features into a directory <br/> (e.g. for creating your own Karaf-based distribution) </td></tr><tr><td class="confluenceTd"> <tt>features:generate-features-file</tt> </td><td class="confluenceTd"> Deprecated - use <tt><a href="features-maven-plugin-generate.html">features:generate-features-xml</a></tt> instead </td></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-gen
 erate.html">features:generate-features-xml</a></tt> </td><td class="confluenceTd"> Generates a features XML descriptor for a set of bundles </td></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-validate.html">features:validate</a></tt> </td><td class="confluenceTd"> Validate a features XML descriptor by checking if all the required imports can be matched to exports </td></tr><tr><td class="confluenceTd"> {{</td><td class="confluenceTd">features:create-kar</td></tr></table></div><h2 id="Configurethefeaturesmavenplugin">Configure the features-maven-plugin</h2><p>In order to use the <tt>features-maven-plugin</tt>, you have to define the plugin in your project's <tt>pom.xml</tt> file:</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code>
-&lt;project&gt;
-  &lt;build&gt;
-    &lt;plugins&gt;
-      &lt;plugin&gt;
-        &lt;groupId&gt;org.apache.karaf.tooling&lt;/groupId&gt;
-        &lt;artifactId&gt;features-maven-plugin&lt;/artifactId&gt;
-        &lt;version&gt;2.3.2&lt;/version&gt;
-
-        &lt;executions&gt;
-          &lt;!-- add execution definitions here --&gt;
-        &lt;/executions&gt;
-      &lt;/plugin&gt;
-    &lt;/plugins&gt;
-  &lt;/build&gt;  
-&lt;/project&gt;</code></pre></div>
+<h1 id="Usingthefeaturesmavenplugin">Using the features-maven-plugin</h1><p>The <tt>features-maven-plugin</tt> provides several goals to help you create and validate features XML descriptors as well as leverage your features to create a custom Karaf distribution.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Goal </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-add.html">features:add-features-to-repo</a></tt> </td><td class="confluenceTd"> Copies all the bundles required for a given set of features into a directory <br/> (e.g. for creating your own Karaf-based distribution) </td></tr><tr><td class="confluenceTd"> <tt>features:generate-features-file</tt> </td><td class="confluenceTd"> Deprecated - use <tt><a href="features-maven-plugin-generate.html">features:generate-features-xml</a></tt> instead </td></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-gen
 erate.html">features:generate-features-xml</a></tt> </td><td class="confluenceTd"> Generates a features XML descriptor for a set of bundles </td></tr><tr><td class="confluenceTd"> <tt><a href="features-maven-plugin-validate.html">features:validate</a></tt> </td><td class="confluenceTd"> Validate a features XML descriptor by checking if all the required imports can be matched to exports </td></tr><tr><td class="confluenceTd"> {{</td><td class="confluenceTd">features:create-kar</td></tr></table></div><h2 id="Configurethefeaturesmavenplugin">Configure the features-maven-plugin</h2><p>In order to use the <tt>features-maven-plugin</tt>, you have to define the plugin in your project's <tt>pom.xml</tt> file:</p><div class="syntax"><div class="highlight"><pre><span class="nt">&lt;project&gt;</span>&#x000A;  <span class="nt">&lt;build&gt;</span>&#x000A;    <span class="nt">&lt;plugins&gt;</span>&#x000A;      <span class="nt">&lt;plugin&gt;</span>&#x000A;        <span class="nt">&lt;groupId&g
 t;</span>org.apache.karaf.tooling<span class="nt">&lt;/groupId&gt;</span>&#x000A;        <span class="nt">&lt;artifactId&gt;</span>features-maven-plugin<span class="nt">&lt;/artifactId&gt;</span>&#x000A;        <span class="nt">&lt;version&gt;</span>2.3.7-SNAPSHOT<span class="nt">&lt;/version&gt;</span>&#x000A;&#x000A;        <span class="nt">&lt;executions&gt;</span>&#x000A;          <span class="c">&lt;!-- add execution definitions here --&gt;</span>&#x000A;        <span class="nt">&lt;/executions&gt;</span>&#x000A;      <span class="nt">&lt;/plugin&gt;</span>&#x000A;    <span class="nt">&lt;/plugins&gt;</span>&#x000A;  <span class="nt">&lt;/build&gt;</span>  &#x000A;<span class="nt">&lt;/project&gt;</span>&#x000A;</pre></div>&#x000A;</div>
                 </div>
               </td>
             </tr>

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/github-contributions.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/github-contributions.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/github-contributions.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/github-contributions.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>

Modified: karaf/site/production/manual/latest-2.3.x/developers-guide/index.html
URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest-2.3.x/developers-guide/index.html?rev=1615948&r1=1615947&r2=1615948&view=diff
==============================================================================
--- karaf/site/production/manual/latest-2.3.x/developers-guide/index.html (original)
+++ karaf/site/production/manual/latest-2.3.x/developers-guide/index.html Tue Aug  5 15:46:54 2014
@@ -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 2.3.2 Guides
+      Apache Karaf 2.3.7-SNAPSHOT Guides
     </title>
   </head>
   <body>