This document describes how to

Feel free to make changes to this document.

Deploy Jackrabbit with JCA

  1. If you have not done so already, download the JCR 2.0 specification.

  2. Copy the jcr-2.0.jar from the specification package to $GLASSFISH_HOME/domains/$DOMAIN_NAME/lib. Remember that you must not include the jcr jar in any local client application at the risk of getting ClassCastExceptions when trying to access the repository through JNDI.

  3. Restart the Glassfish domain.
  4. Download the latest Jackrabbit JCA archive and deploy it either through the Glassfish Admin console or by asadmin command line deploy.

bin/asadmin deploy jackrabbit-jca.rar
  1. Create the Connection pool either through Connector -> Connector Connection Pool or by asadmin command line:

  bin/asadmin create-connector-connection-pool --raname $rar-name --connectiondefinition javax.jcr.Repository --property HomeDir=$homeDir --description "Connection Pool" jcr_connection_pool
  1. Create the Connector Resource (JNDI name) to access the Connection Pool either through Connector -> Connector Resources or by asadmin command line:

  bin/asadmin create-connector-resource --poolname jcr_connection_pool --description "JNDI Name to access the Connector Connection Pool jcr_connection_pool" jcr/Repository

Now, jackrabbit is running and available through JNDI at java:jcr/Repository (or whatever other JNDI name you specified).

Common problems faced while configuring jackrabbit on Glassfish

1. I get some issues with Glassfish 3.1 ClassLoadingPolicy. I sent this question to Glassfish Users listhttp://www.java.net/forum/topic/glassfish/glassfish/jackrabbit-jca-classloading-issues.

If Glassfish ClassLoader didn't find the libraries inside the jackrabbit JCA rar. JackRabbit JCA is shipped with JackRabbit Core inside that provides the "server implementation". But the class with this implementation was not found by the classloader.

It happens because by default Glassfish 3.1 or above is configured with the derived classloading policy http://www.java.net/external?url=http://download.oracle.com/docs/cd/E18930_01/html/821-2418/bealr.html#gjjyy. It means that the Applications access resource adapters based on references in their deployment descriptors. These references can be resource-ref, resource-env-ref, resource-adapter-mid, or equivalent annotations. If no references are found on the deployment descriptors, the classes defined inside the Resource Adapter (JackRabbit-JCA) will not be found by the Applications ClassLoader.

If you do not want to define references in deployment descriptors or annotations, you may change the class-loading-policy setting to global. To configure this setting, use the asadmin set command. For example:

asadmin set server.connector-service.class-loading-policy="global"

Or throug Glassfish Admin interface in Configurations -> server-config -> Connector Service -> Connector Classloading Policy (just change it to global and click Save Button).

For details, see the the Oracle GlassFish Server 3.1-3.1.1 Application Development Guide http://www.java.net/external?url=http://download.oracle.com/docs/cd/E18930_01/html/821-2418/bealr.html#gjjyy or the Oracle GlassFish Server 3.1-3.1.1 Reference Manual http://docs.oracle.com/cd/E18930_01/html/821-2433/index.html.

=== === See http://janistoolbox.typepad.com/blog/2011/06/jackrabbitglassfish-31jca-resource-adapter-deployment.html for another reference

JackrabbitOnGlassfish (last edited 2011-12-21 15:11:57 by GustavoOrair)