Troubleshooting

If you experience problems with the Jackrabbit JCR server, please check the following:

  1. Did you encounter an exception? Copy the exception stack trace somewhere so you don't loose it. The stack trace contains valuable information for the Jackrabbit developers if you need to file a bug report for the problem you encountered.
  2. Is the repository up and running? Try browsing the default workspace to check if you can still see any content in the repository. You will see an error message if the repository is not available.
  3. What were you trying to do? Try to verify that your client code or other manner of repository use is correct. Did it work before or are you trying to do something new?
  4. Are there any notable log entries? Check the log files for any related warnings or errors. By default the Jackrabbit JCR Server writes log entries to the standard output of the servlet container. You can customize logging by editing the /WEB-INF/log4j.xml file and redeploying this web application.

If none of the above steps help you identify or resolve the problem, you can contact the Jackrabbit users mailing list or report the problem in the Jackrabbit issue tracker to get support from the Jackrabbit community. When contacting the community, please include any relevant details related to the above questions and the environment information shown at the end of this page.

Jackrabbit mailing list

The Jackrabbit user mailing list, users@jackrabbit.apache.org, is the place to discuss any problems or other issues regarding the use of Apache Jackrabbit (or JCR content repositories in general).

Feel free to subscribe the mailing list or browse the archives listed as described in the Jackrabbit mailing lists page.

Jackrabbit issue tracker

If you think you've identified a defect in Jackrabbit, you're welcome to file a bug report in the Jackrabbit issue tracker. You can also use the issue tracker to request new features and other improvements.

You need an account in the issue tracker to report new issues or to comment on existing. Use the registration form if you don't already have an account. No account is needed browsing and searching existing issues.

Environment information

This instance of the Jackrabbit JCR Server is running in a Apache Tomcat/8.5.32 servlet container that supports the Java Servlet API version 3.1.

Details of the Java and operating system environment are included in the system properties shown below:

-- listing properties --
java.vendor=Oracle Corporation
java.rmi.server.useLocalHostname=true
sun.java.launcher=SUN_STANDARD
catalina.base=/home/jakarta/tomcat
sun.management.compiler=HotSpot 64-Bit Tiered Compilers
catalina.useNaming=true
os.name=Linux
sun.boot.class.path=/home/java/jre/lib/resources.jar:/hom...
java.util.logging.config.file=/home/jakarta/tomcat/conf/logging.pro...
java.vm.specification.vendor=Oracle Corporation
java.runtime.version=1.8.0_144-b01
user.name=root
tomcat.util.scan.StandardJarScanFilter.jarsToScan=log4j-web*.jar,log4j-taglib*.jar,log4...
shared.loader=
tomcat.util.buf.StringCache.byte.enabled=true
user.language=en
java.naming.factory.initial=org.apache.naming.java.javaURLContext...
sun.boot.library.path=/home/java/jre/lib/amd64
jdk.tls.ephemeralDHKeySize=2048
java.version=1.8.0_144
java.util.logging.manager=org.apache.juli.ClassLoaderLogManager
user.timezone=America/Los_Angeles
sun.arch.data.model=64
org.apache.jackrabbit.core.util.RepositoryLock:/home/allsearch/jackrabbit=org.apache.jackrabbit.core.util.Repos...
java.util.concurrent.ForkJoinPool.common.threadFactory=org.apache.catalina.startup.SafeForkJ...
java.endorsed.dirs=/home/java/jre/lib/endorsed
sun.cpu.isalist=
sun.jnu.encoding=UTF-8
file.encoding.pkg=sun.io
package.access=sun.,org.apache.catalina.,org.apache....
file.separator=/
java.specification.name=Java Platform API Specification
java.class.version=52.0
user.country=US
java.home=/home/java/jre
java.vm.info=mixed mode
os.version=3.10.0-957.5.1.el7.x86_64
sun.font.fontmanager=sun.awt.X11FontManager
path.separator=:
java.vm.version=25.144-b01
java.rmi.server.useCodebaseOnly=true
java.protocol.handler.pkgs=org.apache.catalina.webresources
java.awt.printerjob=sun.print.PSPrinterJob
sun.io.unicode.encoding=UnicodeLittle
awt.toolkit=sun.awt.X11.XToolkit
package.definition=sun.,java.,org.apache.catalina.,org.a...
java.naming.factory.url.pkgs=org.apache.naming
user.home=/root
org.apache.catalina.security.SecurityListener.UMASK=0027
java.specification.vendor=Oracle Corporation
tomcat.util.scan.StandardJarScanFilter.jarsToSkip=bootstrap.jar,commons-daemon.jar,tomc...
java.library.path=/usr/java/packages/lib/amd64:/usr/lib...
java.vendor.url=http://java.oracle.com/
java.vm.vendor=Oracle Corporation
common.loader="${catalina.base}/lib","${catalina.ba...
java.runtime.name=Java(TM) SE Runtime Environment
sun.java.command=org.apache.catalina.startup.Bootstrap...
java.class.path=/home/jakarta/tomcat/bin/bootstrap.ja...
java.vm.specification.name=Java Virtual Machine Specification
java.vm.specification.version=1.8
catalina.home=/home/jakarta/tomcat
sun.cpu.endian=little
sun.os.patch.level=unknown
java.io.tmpdir=/home/jakarta/tomcat/temp
java.vendor.url.bug=http://bugreport.sun.com/bugreport/
server.loader=
os.arch=amd64
java.awt.graphicsenv=sun.awt.X11GraphicsEnvironment
java.ext.dirs=/home/java/jre/lib/ext:/usr/java/pack...
user.dir=/home/allsearch
line.separator=

java.vm.name=Java HotSpot(TM) 64-Bit Server VM
ignore.endorsed.dirs=
file.encoding=UTF-8
java.specification.version=1.8