sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bdelacre...@apache.org
Subject svn commit: r1611639 - /sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext
Date Fri, 18 Jul 2014 13:14:23 GMT
Author: bdelacretaz
Date: Fri Jul 18 13:14:23 2014
New Revision: 1611639

URL: http://svn.apache.org/r1611639
Log:
SLING-3771 - Health Checks as server-side JUnit tests

Modified:
    sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext

Modified: sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext
URL: http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext?rev=1611639&r1=1611638&r2=1611639&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext (original)
+++ sling/site/trunk/content/documentation/bundles/sling-health-check-tool.mdtext Fri Jul
18 13:14:23 2014
@@ -79,6 +79,7 @@ The Health Check subsystem consists of t
 * `org.apache.sling.hc.jmx` provides JMX MBeans that execute `HealthCheck`s.
 * `org.apache.sling.junit.healthcheck` provides a `HealthCheck` service that executes JUnit
tests in the server-side OSGi context.
 * `org.apache.sling.hc.samples` provides sample OSGi configurations and `HealthCheck` services.
The sample configurations are provided as Sling content, so the Sling Installer is required
to activate them.
+* `org.apache.sling.hc.junit.bridge` makes selected Health Checks available as server-side
JUnit tests. See below for more info. 
 
 ## Out-of-the-box `HealthCheck` services
 
@@ -139,3 +140,22 @@ The MBean gives access to the `Result` a
 See the example configurations of the `org.apache.sling.hc.samples` for more details.
 
 ![JConsole showing Sling Health Check MBeans](jconsole-hc.jpg)
+
+## Health Checks as server-side JUnit tests
+The `org.apache.sling.hc.junit.bridge` bundle makes selected Health Checks available as server-side
JUnit tests. 
+
+It requires the `org.apache.sling.junit.core bundle` which provides the server-side JUnit
tests infrastructure.
+
+The idea is to implement the smoke tests of your system, for example, as health checks. You
can then run them
+as part of integration testing, using the  [Sling Testing Tools]({{ refs.sling-testing-tools.path
}})  
+remote testing utilities, and also as plain Health Checks for monitoring or troubleshooting
Sling instances.
+
+To use this module, configure sets of tags at `/system/console/configMgr/org.apache.sling.hc.junitbridge.HealthCheckTestsProvider`
+using the standard `includeThisTag,-omitThatTag` syntax, and JUnit tests will be available
at /system/sling/junit/HealthChecks.html 
+to run the corresponding Health Checks.
+
+To run the Health Check tests at build time, see the [testing/samples/integration-tests](http://svn.apache.org/repos/asf/sling/trunk/testing/samples/integration-tests)
+sample module.
+  
+
+



Mime
View raw message