Author: bdelacretaz
Date: Wed Jun 22 12:59:48 2016
New Revision: 1749677
URL: http://svn.apache.org/viewvc?rev=1749677&view=rev
Log:
Document :repoinit in provisioning model
Modified:
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
Modified:
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext?rev=1749677&r1=1749676&r2=1749677&view=diff
==============================================================================
---
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
(original)
+++
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
Wed Jun 22 12:59:48 2016
@@ -61,4 +61,21 @@ The language is self-explaining but plea
## Embedding repoinit statements in the Sling provisioning model
-TODO: explain this
\ No newline at end of file
+The `slingstart-maven-plugin`, from V1.4.2 on, allows for embedding "special"
sections in the Sling provisioning model by starting
+their name with a colon.
+
+The `o.a.s.repoinit.oak-jcr` bundle uses this feature to execute `repoinit`
statements provided by Sling provisioning models, as in this
+example:
+
+ [:repoinit]
+ create path /repoinit/provisioningModelTest
+
+ create service user provisioningModelUser
+
+The `org.apache.sling.repoinit.jcr.RepositoryInitializer` component reads the
provisioning model text using a configurable URL, which defaults to
`context:/resources/provisioning/model.txt` to get the model that our
`maven-slingstart-plugin` embeds in the Sling launchpad, the `context:`
protocol being handled by the launchpad's `ContextProtocolHandler`.
+
+Configuring a different URL and if needed creating a protocol handler will
allow other launchers to provide the provisioning model, or directly provide
repoinit statements.
+
+This also requires the `org.apache.sling.provisioning.model` bundle, version
1.4.2 or later.
+
+All bundles required for this feature need to be active before the
`SlingRepository` service starts.
\ No newline at end of file
