Apache Sling Feature Launcher

Clone this repo:
  1. 0190cf0 SLING-10186: Fixes in cli options by Stefan Bischof · 2 days ago master
  2. 4d66743 [maven-release-plugin] prepare for next development iteration by Carsten Ziegeler · 6 weeks ago
  3. 8ef1da3 [maven-release-plugin] prepare release org.apache.sling.feature.launcher-1.1.18 by Carsten Ziegeler · 6 weeks ago
  4. 7070353 Specify bnd maven plugin version by Carsten Ziegeler · 6 weeks ago
  5. 7d039ac Update to parent 41 and sling feature model 1.2.22 by Carsten Ziegeler · 6 weeks ago

Apache Sling

Build Status Test Status Coverage Sonarcloud Status JavaDoc Maven Central feature License

Feature Model Launcher

The Feature Model Launcher can launch an feature model application file to a running process.

The launcher can be executed as follows:

java org.apache.sling.feature.launcher.impl.Main

or via the Java Main class of the jar file:

java -jar org.apache.sling.feature.launcher.jar

The launcher creates a local cache, by default in a subdirectory called launcher. If you want to run the launcher with a clean start, delete this directory before invoking the launcher.

The following command line options are supported:

$ rm -rf launcher && java -jar org.apache.sling.feature.launcher.jar -h
usage: launcher
 -C <arg>    Set artifact clash override
 -CC <arg>   Set config class override
 -c <arg>    Set cache dir
 -D <arg>    Set framework properties
 -f <arg>    Set feature files (relative and absolute file path or URL including classloader resources)
 -p <arg>    Set home dir
 -u <arg>    Set repository url
 -V <arg>    Set variable value
 -ec <arg>   Set Extension Configuration (format: extensionName:key1=val1,key2=val2)
 -fv <arg>   Set Felix Framework version
 -fa <arg>   Set Framework Artifact (overrides felix framework version)
 -v          Verbose

Note: if feature files are provided as a Classloader Resource like in an executable JAR file or classpath resource then it's Resource URL can be handed over to the Launcher as feature file (-f option):

java.net.URL url = getClass().getResource("/my-feature-file.json");
String[] arguments = new String[] {
    "-f", url.toString()

For further documentation see: https://github.com/apache/sling-org-apache-sling-feature/blob/master/readme.md