SLING-9830 - update setup and instructions for server-side debugging of the tests
diff --git a/.gitignore b/.gitignore
index 5b783ed..58f6f36 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,3 +15,4 @@
.DS_Store
jcr.log
atlassian-ide-plugin.xml
+launcher/
diff --git a/README.md b/README.md
index 54dd4af..c22b18e 100644
--- a/README.md
+++ b/README.md
@@ -6,25 +6,24 @@
This module is part of the [Apache Sling](https://sling.apache.org) project.
-This module builds a Sling instance using bundles from the trunk, and
-runs integration tests against it via HTTP.
+It builds a Sling instance using the [Sling Starter Feature](https://github.com/apache/sling-org-apache-sling-starter) which has the same version has this module, and runs integration tests against it via HTTP.
-## Default build with integration tests
+The tests are provided by the sibling [sling-org-apache-sling-launchpad-integration-tests](https://github.com/apache/sling-org-apache-sling-launchpad-integration-tests)
+module.
-The integration tests are provided by the sibling [sling-org-apache-sling-launchpad-integration-tests](https://github.com/apache/sling-org-apache-sling-launchpad-integration-tests)
-module. By default the Sling instance to test is started, including a
-few test-specific bundles, the integration tests are executed and
-the instance is stopped.
-
-## Executing individual tests
+## How to execute and debug individual tests
To start a Sling instance with the exact same setup used in the full
-build of this module, use
+build of this module, run
- mvn clean install -Dlaunchpad.keep.running=true -Dhttp.port=8080
+ mvn clean package
-Adding `-Dsling.debug.options="<debug options>"` for server-side debugging if needed.
+and then use
-Use CTRL-C to stop that instance.
+ java -jar target/dependency/org.apache.sling.feature.launcher.jar -f target/slingfeature-tmp/feature-testing-oak_tar.json
-The tests of the [sling-org-apache-sling-launchpad-integration-tests](https://github.com/apache/sling-org-apache-sling-launchpad-integration-tests) module can then be run against this instance, as described there.
+To start the Sling instance to test on port 8080 by default, using appropriate `java` options for server-side debugging
+as needed. CTRL-C stops that instance.
+
+The tests of the [sling-org-apache-sling-launchpad-integration-tests](https://github.com/apache/sling-org-apache-sling-launchpad-integration-tests) module can then be run against this instance, as described
+in the README of that module.
diff --git a/pom.xml b/pom.xml
index ca25cb4..7649bda 100644
--- a/pom.xml
+++ b/pom.xml
@@ -189,6 +189,23 @@
</systemPropertyVariables>
</configuration>
</plugin>
+ <plugin>
+ <artifactId>maven-dependency-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>prepare-feature-launcher</id>
+ <goals>
+ <goal>get</goal>
+ <goal>copy</goal>
+ </goals>
+ <phase>package</phase>
+ <configuration>
+ <artifact>org.apache.sling:org.apache.sling.feature.launcher:1.1.4</artifact>
+ <stripVersion>true</stripVersion>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
</plugins>
</build>
