Jackrabbit Deployment Models - HOWTO
  1. Place the jackrabbit jar file and all the dependencies under [tomcat folder]/webapps/[your app]/WEB-INF/lib.
  2. Register a bindable repository factory in the context scope. Configure the Java class name of the factory implementation, as well as the repository configuration file path and the repository home directory path. Use the full path in both cases.
  3. Declare the JNDI address under which you will request the repository instance in the web application.
  4. Code your application to use the resource.

Limitations: the application should not be redeployed during the same jvm process. In case you want to redeploy your application be sure to shutdown the repository when your application is undeployed. It can be done by calling RepositoryImpl.shutdown() (e.g. in the destroy() method of a servlet).

In server.xml under the "context" tag (steps #2)

<Resource name="jcr/repositoryFactory" auth="Container" type="org.apache.jackrabbit.core.jndi.BindableRepository"/> <ResourceParams name="jcr/repositoryFactory"> <parameter> <name>factory</name> <value> org.apache.jackrabbit.core.jndi.BindableRepositoryFactory </value> </parameter> <parameter> <name>configFilePath</name> <value> [full path to repository.xml] </value> </parameter> <parameter> <name>repHomeDir</name> <value> [full path to the repository home folder] </value> </parameter> </ResourceParams>

In web.xml (steps #3)

<resource-env-ref> <description> Jackrabbit repository factory </description> <resource-env-ref-name> jcr/repositoryFactory </resource-env-ref-name> <resource-env-ref-type> org.apache.jackrabbit.core.jndi.BindableRepository </resource-env-ref-type> </resource-env-ref>

Java code (step #4)

InitialContext ctx = new InitialContext(); Context env = (Context) ctx.lookup("java:comp/env"); Repository repo = (Repository) env.lookup("jcr/repositoryFactory");

Same as Model 1 with the following modifications.

  1. Place the jackrabbit jar file and all the dependencies under [tomcat folder]/common/lib.
  2. Register the bindable repository factory as a global resource (same as model 1 but place the resource under "GlobalNamingResources" tag) and link the global resource to a context scoped JNDI address.

In server.xml under "GlobalNamingResources" tag. (step #2)

<Resource name="jcr/globalRepositoryFactory" auth="Container" type="org.apache.jackrabbit.core.jndi.BindableRepository"/> <ResourceParams name="jcr/globalRepositoryFactory"> <parameter> <name>factory</name> <value> org.apache.jackrabbit.core.jndi.BindableRepositoryFactory </value> </parameter> <parameter> <name>configFilePath</name> <value> [full path to repository.xml] </value> </parameter> <parameter> <name>repHomeDir</name> <value> [full path to the repository home folder] </value> </parameter> </ResourceParams>

In server.xml under the "context" tag (step #2)

<ResourceLink name="jcr/repositoryFactory" global="jcr/globalRepositoryFactory" type="org.apache.jackrabbit.core.jndi.BindableRepository"/>