blob: 5d7cf3cbf5653e7b1dca412996d9b255b1ff9962 [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from target/generated-site/xdoc/start-mojo.xml at 2022-08-11
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Apache Sling Feature Launcher Maven Plugin &#x2013; feature-launcher:start</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.11.1.min.css" />
<link rel="stylesheet" href="./css/site.css" />
<link rel="stylesheet" href="./css/print.css" media="print" />
<script src="./js/apache-maven-fluido-1.11.1.min.js"></script>
<!-- Matomo -->
<script>
var _paq = window._paq = window._paq || [];
_paq.push(['disableCookies']);
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="https://analytics.apache.org";
_paq.push(['setTrackerUrl', u+'/matomo.php']);
_paq.push(['setSiteId', '6']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s);
})();
</script>
<!-- End Matomo Code -->
<style>.github-fork-ribbon:before { background-color: gray; }</style>
</head>
<body class="topBarDisabled">
<a class="github-fork-ribbon right-top" href="https://github.com/apache/sling-feature-launcher-maven-plugin" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
<div class="container-fluid">
<header>
<div id="banner">
<div class="pull-left"><a href="https://sling.apache.org/" id="bannerLeft"><img src="https://sling.apache.org/res/logos/sling.svg" alt="Apache Sling" style="width: 123px; height: 63px;" /></a></div>
<div class="pull-right"><a href="https://apache.org/" id="bannerRight"><img src="https://sling.apache.org/res/logos/apache.png" alt="Apache" style="" /></a></div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li class=""><a href="https://sling.apache.org/" class="externalLink" title="Apache Sling">Apache Sling</a><span class="divider">/</span></li>
<li class=""><a href="https://sling.apache.org/components/" class="externalLink" title="Maven Plugins">Maven Plugins</a><span class="divider">/</span></li>
<li class=""><a href="index.html" title="Apache Sling Feature Launcher Maven Plugin">Apache Sling Feature Launcher Maven Plugin</a><span class="divider">/</span></li>
<li class="active ">feature-launcher:start</li>
<li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2022-08-11</li>
<li id="projectVersion" class="pull-right">Version: 0.1.3-SNAPSHOT</li>
</ul>
</div>
</header>
<div class="row-fluid">
<header id="leftColumn" class="span2">
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
<li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
<div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
</div>
</div>
</header>
<main id="bodyColumn" class="span10" >
<section>
<h2><a name="feature-launcher:start"></a>feature-launcher:start</h2>
<p><b>Full name</b>:</p>
<p>org.apache.sling:feature-launcher-maven-plugin:0.1.3-SNAPSHOT:start</p>
<p><b>Description</b>:</p>
<div>Start one or multiple <a class="externalLink" href="https://sling.apache.org/documentation/development/feature-model.html">Sling
Feature(s)</a>.</div>
<p><b>Attributes</b>:</p>
<ul>
<li>Requires a Maven project to be executed.</li>
<li>The goal is not marked as thread-safe and thus does not support parallel builds.</li>
<li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: <code>pre-integration-test</code>.</li>
</ul>
<section>
<h3><a name="Required_Parameters"></a>Required Parameters</h3>
<table class="table table-striped" border="0">
<tr class="a">
<th>Name</th>
<th>Type</th>
<th>Since</th>
<th>Description</th>
</tr>
<tr class="b">
<td align="left"><code><a href="#featureLauncherVersion">&lt;featureLauncherVersion&gt;</a></code></td>
<td><code>String</code></td>
<td><code>-</code></td>
<td>The version of the <a class="externalLink" href="https://github.com/apache/sling-org-apache-sling-feature-launcher">Sling
Feature Launcher</a> to use.<br /><b>Default value is</b>: <code>1.1.4</code>.<br /></td>
</tr>
<tr class="a">
<td align="left"><code><a href="#launches">&lt;launches&gt;</a></code></td>
<td><code>List</code></td>
<td><code>-</code></td>
<td>List of <code>Launch</code> objects to start. Each is having the
following format:
<div>
<pre>
<code>
&lt;id&gt;...&lt;/id&gt; &lt;!-- the id of the launch, must be unique within the list, is mandatory --&gt;
&lt;dependency&gt;...&lt;/dependency&gt; &lt;!-- the Maven coordinates of the feature model --&gt;
&lt;launcherArguments&gt; &lt;!-- additional arguments to pass to the launcher --&gt;
&lt;frameworkProperties&gt;
&lt;org.osgi.service.http.port&gt;8090&lt;/org.osgi.service.http.port&gt;
&lt;/framweworkProperties&gt;
..
&lt;/launcherArguments&gt;
&lt;environmentVariables&gt;&lt;!--additional environment variables to pass to the launcher --&gt;
&lt;JAVA_HOME&gt;...&lt;/JAVA_HOME&gt;
&lt;/environmentVariables&gt;</code>
</pre></div><br /></td>
</tr>
<tr class="b">
<td align="left"><code><a href="#outputDirectory">&lt;outputDirectory&gt;</a></code></td>
<td><code>File</code></td>
<td><code>-</code></td>
<td>The directory in which the features are launched (below its child
directory <code>launchers/&lt;launch-id&gt;</code>).<br /><b>Default value is</b>: <code>${project.build.directory}</code>.<br /><b>User property is</b>: <code>outputDir</code>.<br /></td>
</tr>
</table>
</section>
<section>
<h3><a name="Parameter_Details"></a>Parameter Details</h3>
<section>
<h4><a name="a.3CfeatureLauncherVersion.3E"></a><b><a name="featureLauncherVersion">&lt;featureLauncherVersion&gt;</a></b></h4>
<div>The version of the <a class="externalLink" href="https://github.com/apache/sling-org-apache-sling-feature-launcher">Sling
Feature Launcher</a> to use.</div>
<ul>
<li><b>Type</b>: <code>java.lang.String</code></li>
<li><b>Required</b>: <code>Yes</code></li>
<li><b>Default</b>: <code>1.1.4</code></li>
</ul><hr /></section><section>
<h4><a name="a.3Claunches.3E"></a><b><a name="launches">&lt;launches&gt;</a></b></h4>
<div>List of <code>Launch</code> objects to start. Each is having the
following format:
<div>
<pre>
<code>
&lt;id&gt;...&lt;/id&gt; &lt;!-- the id of the launch, must be unique within the list, is mandatory --&gt;
&lt;dependency&gt;...&lt;/dependency&gt; &lt;!-- the Maven coordinates of the feature model --&gt;
&lt;launcherArguments&gt; &lt;!-- additional arguments to pass to the launcher --&gt;
&lt;frameworkProperties&gt;
&lt;org.osgi.service.http.port&gt;8090&lt;/org.osgi.service.http.port&gt;
&lt;/framweworkProperties&gt;
..
&lt;/launcherArguments&gt;
&lt;environmentVariables&gt;&lt;!--additional environment variables to pass to the launcher --&gt;
&lt;JAVA_HOME&gt;...&lt;/JAVA_HOME&gt;
&lt;/environmentVariables&gt;</code>
</pre></div></div>
<ul>
<li><b>Type</b>: <code>java.util.List</code></li>
<li><b>Required</b>: <code>Yes</code></li>
</ul><hr /></section><section>
<h4><a name="a.3CoutputDirectory.3E"></a><b><a name="outputDirectory">&lt;outputDirectory&gt;</a></b></h4>
<div>The directory in which the features are launched (below its child
directory <code>launchers/&lt;launch-id&gt;</code>).</div>
<ul>
<li><b>Type</b>: <code>java.io.File</code></li>
<li><b>Required</b>: <code>Yes</code></li>
<li><b>User Property</b>: <code>outputDir</code></li>
<li><b>Default</b>: <code>${project.build.directory}</code></li>
</ul>
</section></section>
</section>
</main>
</div>
</div>
<hr/>
<footer>
<div class="container-fluid">
<div class="row-fluid">
<p>&#169; 2022
<a href="https://www.apache.org/">The Apache Software Foundation</a> &vert; <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy Policy</a>
</p>
</div>
</div>
</footer>
<script>
if(anchors) {
anchors.add();
}
</script>
</body>
</html>