[CONF] Apache Sling Website > JCR Installer (jcr.jcrinstall and osgi.installer)

[confluence]

JCR Installer (jcr.jcrinstall and osgi.installer) Page added by Bertrand Delacretaz Overview The JCR installer modules install OSGi bundles and configurations found in the JCR repository. The goal is to allow Sling applications to be distributed as "content packages", which install additional services and configurations when copied to the JCR repository. Example Here's a quick walkthrough of the JCR installer functionality. Installation Start the Sling launchpad/app and install and start the following additional bundles: RunMode service (org.apache.sling.runmode) OSGi installer service (org.apache.sling.osgi.installer) JCR installer service (org.apache.sling.jcr.jcrinstall) To watch the logs produced by these modules, you can filter sling/logs/error.log using egrep 'jcrinstall|osgi.installer'. Install and remove a bundle We'll use the Knopflerfish Desktop bundle for this example, it is convenient as it displays a graphical user interface when started. We use curl to create content, to make it easy to reproduce the example by copying and pasting the curl commands. Any other way to create content in the repository will work, of course. By default, JCRinstall picks up bundles found in folders named install under /libs and /apps, so we start by creating such a folder: curl -X MKCOL http://admin:ad...@localhost:8888/apps/jcrtest curl -X MKCOL http://admin:ad...@localhost:8888/apps/jcrtest/install And we copy the bundle to install in that folder (a backslash in command lines means _continued on next line): curl -T desktop_awt_all-2.0.0.jar \ http://admin:ad...@localhost:8888/apps/jcrtest/install/desktop_awt_all-2.0.0.jar That's it. After 2-3 seconds, the bundle should be picked up by JCRinstall, installed and started. If this works you'll see a small Knopflerfish Desktop window on your desktop, and Sling's OSGi console can of course be used to check the details. Removing the bundle from the repository will cause it to be uninstalled, so: curl -X DELETE \ http://admin:ad...@localhost:8888/apps/jcrtest/install/desktop_awt_all-2.0.0.jar Should cause the Knopflerfish Desktop window to disappear as the bundle is uninstalled. TODO: document folder priorities (/apps over /libs), SNAPSHOT handling, bundle start retries. Install, modify and remove a configuration Change Notification Preferences View Online | Add Comment