Apache Sling Server Setup Tools

Clone this repo:
  1. db336c0 [maven-release-plugin] prepare for next development iteration by Eric Norman · 7 weeks ago master
  2. acf2f94 [maven-release-plugin] prepare release org.apache.sling.testing.serversetup-1.0.4 by Eric Norman · 7 weeks ago org.apache.sling.testing.serversetup-1.0.4
  3. 5732ab0 SLING-9785 Improve readability of the readme by Eric Norman · 8 weeks ago
  4. e8472df SLING-9785 Provide additional configuration to influence the server by Eric Norman · 8 weeks ago
  5. e1866d6 SLING-9771 Cleanup build warnings from bnd by Eric Norman · 9 weeks ago

Apache Sling

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

Apache Sling Server Setup Tools

This module is part of the Apache Sling project.

Sling Server Setup utilities.

Configuration System Properties

  • test.server.url - If the server is already running, this is the full address of your target server. No default value.

  • test.server.hostname - The hostname for the sling server that will be started. Default value is “localhost”.

  • test.server.username - The username to use to login for interacting with the OSGi web console. Default value is “admin”.

  • test.server.password - The password of the user to use for interacting with the OSGi web console. Default value is “admin”.

  • server.ready.timeout.seconds - The maximum amount of time in seconds to wait for the server to become ready. Default value is 60.

  • server.ready.timeout.initial.delay.seconds - The duration to wait in seconds before checking if the server is ready. Default value is 0.

  • server.ready.timeout.delay.seconds - The duration of the delay in seconds between attempts to check if the server is ready. Defalt value is 1.

  • server.ready.quiet.period.seconds - The duration of a quiet period in seconds after the server has become ready and the tests begin running. Default value is 0.

  • server.ready.path - Prefix for one or more properties whose value describe how to check if the server is ready. The syntax of each value is one of: | Pattern | Description | | ------- | ----------- | | [relative_url]:[response_content_contains] | Load the page and check if the response content contains the string | | [relative_url]:[response_content_pattern]:regexp | Load the page and check if the response content contains the regex pattern |

  • keepJarRunning - Specify if you want the server to remain running - you can then run tests against it from another VM. Default value is false.

  • additional.bundles.path - The value is a comma-separated list of additional bundles to install (or uninstall).

  • additional.bundles.uninstall - If true, treat the additional bundles items as bundles to uninstall. Otherwise, treat those items as bundles to install. Default value is false.

  • sling.additional.bundle - Prefix for zero or more properties whose value describes additional bundles to install.

  • start.bundles.timeout.seconds - The maximum amount of time to wait for the additional bundles to start. Default value is 30.

  • bundle.install.timeout.seconds - The maximum amount of time to wait for the additional bundles to install. Default value is 10.

  • jar.executor.server.port - The port number for the sling server that will be started. Default value is 8765.

  • jar.executor.jar.folder - The folder that contains the executable jar.

  • jar.executor.jar.name.regexp - The name of the executable jar file.

  • jar.executor.vm.options - Additional options to pass along to the spawned jvm.

  • jar.executor.work.folder - The working directory for the executable jar.

  • jar.executor.exit.timeout.seconds - The maximum time in seconds to wait for for the executor process to exit normally. Default value is 30.

  • jar.executor.wait.on.shutdown - True to wait for the executor process to exit normally, false to not wait. Default value is false.

  • jar.executor.java.executable.path - The path to the java executable.

  • jar.executor.synchronous.exec - True to execute synchronous, false otherwise. Default value is false.

  • jar.executor.synchronous.exec.expected.result - The exit code expected from the executor. Default value is 0.