Apache Jackrabbit : ContribTips

Common problems when using / building the jackrabbit jcr-server

  • Follow the build instructions in the README.txt
  • Jackrabbit depends on a "newer" JAXP version than the one shipped with JDK 1.4.x. Xerces 2.6.1 works. Since the xml jars are "endorsed" (javax.xml.xx) you should place them in $JAVA_HOME/jre/lib/ext. If using tomcat you can place the xerces jars in $CATALINA_HOME/common/endorsed
  • You must add the system property java.security.auth.login.config to point to a jaas configuration file. Use the file jackrabbit/application/test/jaas.config. In tomcat, copy the file to "$CATALINA_HOME/conf" and add the following to the environment var CATALINA_OPTS. (If your tomcat is already using jaas, simply merge the content of jaas.config with the file that tomcat uses.)

TODO : Add a list of the exceptions thrown when running without the proper xml api versions, since the exceptions don't give enough hints)