Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-generate-descriptor.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-generate-descriptor.html?rev=1484249&r1=1484248&r2=1484249&view=diff ============================================================================== --- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-generate-descriptor.html (original) +++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-generate-descriptor.html Sun May 19 09:53:10 2013 @@ -93,7 +93,7 @@ <div id="wrapper-menu-page-top"> <div id="wrapper-menu-page-bottom"> <div id="menu-page"> - <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> </div> </div> </div> @@ -103,32 +103,7 @@ <div class="wiki-content"> <h2 id="Goalkaraffeaturesgeneratedescriptor">Goal <tt>karaf:features-generate-descriptor</tt></h2><p>Except in unusual circumstances, use the <packaging>feature</packaging> to run this goal.</p><p>The <tt>karaf:features-generate-descriptor</tt> goal generates a features XML file based on the Maven dependencies. By default, it will follow Maven transitive dependencies, stopping when it encounters bundles already present in features that are Maven dependencies.</p><p>A record of the dependency tree search can be found in target/history/treeListing.txt.</p><p>You can track dependency changes and warn or fail on change.</p><h2 id="Configuration">Configuration</h2><p>Specify the packaging as a top level element</p><pre> <packaging>feature</packaging> -</pre><p>You can supply a feature descriptor to extend in src/main/feature/feature.xml.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Parameter Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> aggregateFeatures </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> Specifies processing of feature repositories that are (transitive) Maven dependencies. If false, all features in these repositories become dependencies of the generated feature. If true, all features in these repositories are copied into the generated feature repository. </td></tr><tr><td class="confluenceTd"> startLevel </td><td class="confluenceTd"> int </td><td class="confluenceTd"> The start level for the bundles determined from Maven dependencies. This can be overridden by specifying the bundle in the source feature.xml with the desired startlevel. </td></tr><tr><td cla ss="confluenceTd"> includeTransitiveDependency </td><td class="confluenceTd"> boolean (true) </td><td class="confluenceTd"> Whether to follow Maven transitive dependencies. </td></tr><tr><td class="confluenceTd"> checkDependencyChange </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> Whether to record dependencies in src/main/history.dependencies.xml for change tracking. </td></tr><tr><td class="confluenceTd"> warnOnDependencyChange </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> whether to fail on changed dependencies (false, default) or warn in the build output (true). </td></tr><tr><td class="confluenceTd"> logDependencyChanges </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> If true, added and removed dependencies are shown in target/history. </td></tr><tr><td class="confluenceTd"> overwriteChangedDependencies </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd" > If true, the src/main/history/dependencies.xml file will be overwritten if > it has changed. </td></tr></table></div><h3 id="Example">Example</h3><div > class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code> -<project> -... - <packaging>feature</packaging> - <dependencies> - <dependency> - <groupId>org.apache</groupId> - <artifactId>bundle1</artifactId> - <version>1.0</version> - </dependency> - </dependencies> - <build> - <plugins> - <plugin> - <groupId>org.apache.karaf.tooling</groupId> - <artifactId>karaf-maven-plugin</artifactId> - <version>3.0.0-SNAPSHOT</version> - <extensions>true</extensions> - <configuration> - <startLevel>80</startLevel> - <aggregateFeatures>true</aggregateFeatures> - </configuration> - </plugin> - </plugins> - </build> -</project></code></pre></div> +</pre><p>You can supply a feature descriptor to extend in src/main/feature/feature.xml.</p><div class="table-wrap"><table class="confluenceTable"><tr><th class="confluenceTh"> Parameter Name </th><th class="confluenceTh"> Type </th><th class="confluenceTh"> Description </th></tr><tr><td class="confluenceTd"> aggregateFeatures </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> Specifies processing of feature repositories that are (transitive) Maven dependencies. If false, all features in these repositories become dependencies of the generated feature. If true, all features in these repositories are copied into the generated feature repository. </td></tr><tr><td class="confluenceTd"> startLevel </td><td class="confluenceTd"> int </td><td class="confluenceTd"> The start level for the bundles determined from Maven dependencies. This can be overridden by specifying the bundle in the source feature.xml with the desired startlevel. </td></tr><tr><td cla ss="confluenceTd"> includeTransitiveDependency </td><td class="confluenceTd"> boolean (true) </td><td class="confluenceTd"> Whether to follow Maven transitive dependencies. </td></tr><tr><td class="confluenceTd"> checkDependencyChange </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> Whether to record dependencies in src/main/history.dependencies.xml for change tracking. </td></tr><tr><td class="confluenceTd"> warnOnDependencyChange </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> whether to fail on changed dependencies (false, default) or warn in the build output (true). </td></tr><tr><td class="confluenceTd"> logDependencyChanges </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd"> If true, added and removed dependencies are shown in target/history. </td></tr><tr><td class="confluenceTd"> overwriteChangedDependencies </td><td class="confluenceTd"> boolean (false) </td><td class="confluenceTd" > If true, the src/main/history/dependencies.xml file will be overwritten if > it has changed. </td></tr></table></div><h3 id="Example">Example</h3><div > class="syntax"><div class="highlight"><pre><span > class="nt"><project></span>
...
 <span > class="nt"><packaging></span>feature<span > class="nt"></packaging></span>
 <span > class="nt"><dependencies></span>
 <span > class="nt"><dependency></span>
 <span > class="nt"><groupId></span>org.apache<span > class="nt"></groupId></span>
 <span > class="nt"><artifactId></span>bundle1<span > class="nt"></artifactId></span>
 <span > class="nt"><version></span>1.0<span > class="nt"></version></span>
 <span > class="nt"></dependency></span>
 <span > class="nt"></dependencies></span>
 <span > class="nt"><build></span>
 <span > class="nt"><plugins></span>
 <span clas s="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"><extensions></span>true<span class="nt"></extensions></span>
 <span class="nt"><configuration></span>
 <span class="nt"><startLevel></span>80<span class="nt"></startLevel></span>
 <span class="nt"><aggregateFeatures></span>true<span class="nt"></aggregateFeatures></span>
 <span class="nt"></configuration></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></sp an>
<span class="nt"></project></span>
</pre></div>
</div> </div> </td> </tr>
Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-validate-descriptor.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-validate-descriptor.html?rev=1484249&r1=1484248&r2=1484249&view=diff ============================================================================== --- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-validate-descriptor.html (original) +++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-features-validate-descriptor.html Sun May 19 09:53:10 2013 @@ -93,7 +93,7 @@ <div id="wrapper-menu-page-top"> <div id="wrapper-menu-page-bottom"> <div id="menu-page"> - <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> </div> </div> </div> @@ -101,38 +101,7 @@ </td> <td height="100%" width="100%"> <div class="wiki-content"> -<h2 id="Goalkaraffeaturesvalidatedescriptor">Goal <tt>karaf:features-validate-descriptor</tt></h2><p>The <tt>karaf:features-validate-descriptor</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 core features (standard and enterprise) in the repositories set.<br/>It means that it's not required 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> -<project> - <build> - <plugins> - <plugin> - <groupId>org.apache.karaf.tooling</groupId> - <artifactId>karaf-maven-plugin</artifactId> - <version>3.0.0-SNAPSHOT</version> - <executions> - <execution> - <id>validate</id> - <phase>process-resources</phase> - <goals> - <goal>features-validate-descriptor</goal> - </goals> - <configuration> - <file>target/features.xml</file> - <karafConfig>src/main/resources/config.properties</karafConfig> - </configuration> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>org.slf4j</groupId> - <artifactId>slf4j-simple</artifactId> - <version>1.4.3</version> - </dependency> - </dependencies> - </plugin> - </plugins> - </build> -</project></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>/home/jbonofre/workspace/karaf/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 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/> Def ault 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 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="Goalkaraffeaturesvalidatedescriptor">Goal <tt>karaf:features-validate-descriptor</tt></h2><p>The <tt>karaf:features-validate-descriptor</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 core features (standard and enterprise) in the repositories set.<br/>It means that it's not required 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"><project></span>
 <span class="nt">< ;build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SNAPSHOT<span class="nt"></version></span>
 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>validate<span class="nt"></id></span>
 <span class="nt"><phase></span>process-resources<span class="nt"></phase></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>features-validate-descriptor<span class="nt"></goal></span>� 00A; <span class="nt"></goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><file></span>target/features.xml<span class="nt"></file></span>
 <span class="nt"><karafConfig></span>src/main/resources/config.properties<span class="nt"></karafConfig></span>
 <span class="nt"></configuration></span>
 <span class="nt"></execution></span>
 <span class="nt"></executions></span>
 <span class="nt"><dependencies></span>
 <span class="nt"><dependency></span>
 <span class="nt"><groupId></span>org.slf4j<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>slf4j-simple<span class="nt"></artifactId></span>
 <span class="nt"><version></spa n>1.4.3<span class="nt"></version></span>
 <span class="nt"></dependency></span>
 <span class="nt"></dependencies></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</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/karaf/manual/target/classes/features.xml</tt> </td></tr><tr><td class="confluenceTd"> <tt>karafConfig</tt> </td><td class="confluenceTd"> <tt>Stri ng</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 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/developers-guide/karaf-maven-plugin-instance-create-archive.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-instance-create-archive.html?rev=1484249&r1=1484248&r2=1484249&view=diff ============================================================================== --- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-instance-create-archive.html (original) +++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin-instance-create-archive.html Sun May 19 09:53:10 2013 @@ -93,7 +93,7 @@ <div id="wrapper-menu-page-top"> <div id="wrapper-menu-page-bottom"> <div id="menu-page"> - <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> </div> </div> </div> @@ -101,32 +101,7 @@ </td> <td height="100%" width="100%"> <div class="wiki-content"> -<h2 id="Goalkarafinstancecreatearchive">Goal <tt>karaf:instance-create-archive</tt></h2><p>Normally this is run as part of the karaf-assembly packaging.</p><p>The <tt>karaf:instance-create-archive</tt> goal packages a Karaf instance archive from a given assembled instance.</p><p>Both tar.gz and zip formats are generated in the destination folder.</p><h3 id="Example">Example</h3><p>The example below create archives for the given Karaf instance:</p><div class="syntax"><pre name='code' class='brush: xml; gutter: false;'><code> -<project> - <build> - <plugins> - <plugin> - <groupId>org.apache.karaf.tooling</groupId> - <artifactId>karaf-maven-plugin</artifactId> - <version>3.0.0-SNAPSHOT</version> - <executions> - <execution> - <id>generate</id> - <phase>package</phase> - <goals> - <goal>instance-create-archive</goal> - </goals> - <configuration> - <destDir>/home/jbonofre/workspace/karaf/karaf/manual/target</destDir> - <targetServerDirectory>/home/jbonofre/workspace/karaf/karaf/manual/target/assembly</targetServerDirectory> - <targetFile>/home/jbonofre/workspace/karaf/karaf/manual/pom.xml</targetFile> - </configuration> - </execution> - </executions> - </plugin> - </plugins> - </build> -</project></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>destDir</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The target directory of the project. <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target </td></tr><tr><td class="confluenceTd"> <tt>targetServerDirectory</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The location of the server repository. <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target/assembly </td></tr><tr><td class="confluenceTd"> <tt>targetFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The target file to set as the project's artifact. <br/> Default value: /home/jbonofre/workspace/karaf/kar af/manual/pom.xml </td></tr></table></div> +<h2 id="Goalkarafinstancecreatearchive">Goal <tt>karaf:instance-create-archive</tt></h2><p>Normally this is run as part of the karaf-assembly packaging.</p><p>The <tt>karaf:instance-create-archive</tt> goal packages a Karaf instance archive from a given assembled instance.</p><p>Both tar.gz and zip formats are generated in the destination folder.</p><h3 id="Example">Example</h3><p>The example below create archives for the given Karaf instance:</p><div class="syntax"><div class="highlight"><pre><span class="nt"><project></span>
 <span class="nt"><build></span>
 <span class="nt"><plugins></span>
 <span class="nt"><plugin></span>
 <span class="nt"><groupId></span>org.apache.karaf.tooling<span class="nt"></groupId></span>
 <span class="nt"><artifactId></span>karaf-maven-plugin<span class="nt"></artifactId></span>
 <span class="nt"><version></span>3.0.0-SN APSHOT<span class="nt"></version></span>
 <span class="nt"><executions></span>
 <span class="nt"><execution></span>
 <span class="nt"><id></span>generate<span class="nt"></id></span>
 <span class="nt"><phase></span>package<span class="nt"></phase></span>
 <span class="nt"><goals></span>
 <span class="nt"><goal></span>instance-create-archive<span class="nt"></goal></span>
 <span class="nt"></goals></span>
 <span class="nt"><configuration></span>
 <span class="nt"><destDir></span>/home/jbonofre/workspace/karaf/karaf/manual/target<span class="nt"></destDir></span>
 <span class="nt"><targetServerDirectory></span>/home/jbonofre/workspace/karaf/karaf/manual/target/assembly<span class="nt"></ta rgetServerDirectory></span>
 <span class="nt"><targetFile></span>/home/jbonofre/workspace/karaf/karaf/manual/pom.xml<span class="nt"></targetFile></span>
 <span class="nt"></configuration></span>
 <span class="nt"></execution></span>
 <span class="nt"></executions></span>
 <span class="nt"></plugin></span>
 <span class="nt"></plugins></span>
 <span class="nt"></build></span>
<span class="nt"></project></span>
</pre></div>
</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>destDir</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The target directory of the projec t. <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target </td></tr><tr><td class="confluenceTd"> <tt>targetServerDirectory</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The location of the server repository. <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/target/assembly </td></tr><tr><td class="confluenceTd"> <tt>targetFile</tt> </td><td class="confluenceTd"> <tt>File</tt> </td><td class="confluenceTd"> The target file to set as the project's artifact. <br/> Default value: /home/jbonofre/workspace/karaf/karaf/manual/pom.xml </td></tr></table></div> </div> </td> </tr> Modified: karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin.html URL: http://svn.apache.org/viewvc/karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin.html?rev=1484249&r1=1484248&r2=1484249&view=diff ============================================================================== --- karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin.html (original) +++ karaf/site/production/manual/latest/developers-guide/karaf-maven-plugin.html Sun May 19 09:53:10 2013 @@ -93,7 +93,7 @@ <div id="wrapper-menu-page-top"> <div id="wrapper-menu-page-bottom"> <div id="menu-page"> - <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-command.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribut ions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> + <h3 id="Homeindex"><a href="../index.html">Home</a></h3><ul style="list-style: square"><li><a href="../overview.html">Overview</a></li><li><a href="../quick-start.html">Quick Start</a></li></ul><h3 id="UsersGuideusersguideindex"><a href="../users-guide/index.html">Users Guide</a></h3><ul style="list-style: square"><li><a href="../users-guide/installation.html">Installing Karaf</a></li><li><a href="../users-guide/directory-structure.html">Directory Structure</a></li><li><a href="../users-guide/start-stop.html">Starting and stopping Karaf</a></li><li><a href="../users-guide/wrapper.html">OS integration</a></li><li><a href="../users-guide/configuration.html">Configuration</a></li><li><a href="../users-guide/using-console.html">Using the console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li><li><a href="../users-guide/remote-console.html">Remote console</a></li><li><a href="../users-guide/web-console.html">Web console</a></li>< li><a href="../users-guide/deployer.html">Deployer</a></li><li><a href="../users-guide/child-instances.html">Child instances</a></li><li><a href="../users-guide/security.html">Security</a></li><li><a href="../users-guide/failover.html">Failover Deployments</a></li><li><a href="../users-guide/logging-system.html">Logging system</a></li><li><a href="../users-guide/provisioning.html">Provisioning</a></li><li><a href="../users-guide/kar.html">KAR archive</a></li><li><a href="../users-guide/jre-tuning.html">JRE tuning</a></li><li><a href="../users-guide/web-applications.html">Web applications</a></li><li><a href="../users-guide/http.html">HTTP service</a></li><li><a href="../users-guide/jmx.html">JMX for monitoring and administration</a></li></ul><h3 id="DevelopersGuidedevelopersguideindex"><a href="index.html">Developers Guide</a></h3><ul style="list-style: square"><li><a href="connect-console.html">Programmatically connect to the Console</a></li><li><a href="shell-syntax.html"> Shell syntax</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="developer-commands.html">Developer Commands</a></li><li><a href="archetypes.html">Maven Archetypes</a></li><li><a href="extending-console.html">Extending the Console</a></li><li><a href="branding-console.html">Branding the Console</a></li><li><a href="karaf-maven-plugin.html">Using the Karaf Maven plugin</a></li><li><a href="security-framework.html">Security Framework</a></li><li><a href="custom-distribution.html">Custom Distribution</a></li><li><a href="debugging.html">Troubleshooting, Debugging and Profiling</a></li><li><a href="connect-console.html">Programmatically connect to the console</a></li><li><a href="writing-tests.html">Writing integration tests</a></li><li><a href="creating-bundles.html">Creating bundles</a></li><li><a href="shell-syntax.html">Shell syntax</a></li><li><a href="github-contribu tions.html">Github Contributions</a></li></ul><h3 id="Commandscommandscommands"><a href="../commands/commands.html">Commands</a></h3> </div> </div> </div>
