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 jetty/9.4.33.v20201020 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=Azul Systems, Inc.
org.apache.xml.security.ignoreLineBreaks=true
sun.java.launcher=SUN_STANDARD
g1.server.resource.dir=D:\Appli\Spectrum\server\archive\bundles
sun.management.compiler=HotSpot 64-Bit Tiered Compilers
sun.nio.ch.bugLevel=
com.atomikos.icatch.hide_init_file_path=false
os.name=Windows Server 2012 R2
sun.boot.class.path=C:\Program Files\Zulu\zulu-8\jre\lib\...
spectrum.services.namespace=http://www.pb.com/spectrum/services/
sun.desktop=windows
java.vm.specification.vendor=Oracle Corporation
g1.server.version=20.1
java.runtime.version=1.8.0_462-b08
wrapper.native_library=wrapper
wrapper.key=ZmdPfE-NS8WkpqTEV7fJBjODy8tVn8QN
user.name=zsjp_spectrum
g1.server.conf.dir=D:\Appli\Spectrum\server\conf
jboss.node.name=localhost
g1.server.modules.dir=D:\Appli\Spectrum\server\modules
wrapper.jvm.port.min=31000
user.language=en
sun.boot.library.path=C:\Program Files\Zulu\zulu-8\jre\bin
hazelcast.security.secret.strength.policy.class=com.pb.spectrum.platform.server.conta...
java.version=1.8.0_462
user.timezone=Europe/Paris
java.net.preferIPv4Stack=true
g1.server.microflow.dir=D:\Appli\Spectrum\server\tmp\microflow
org.omg.PortableInterceptor.ORBInitializerClass.org.omg.PortableInterceptor.RuxitOrbInitializer=
sun.arch.data.model=64
java.endorsed.dirs=C:\Program Files\Zulu\zulu-8\jre\lib\...
g1.server.archive.dir=../archive
sun.cpu.isalist=amd64
sun.jnu.encoding=Cp1252
file.encoding.pkg=sun.io
file.separator=\
java.specification.name=Java Platform API Specification
g1.server.deploy.dir=D:\Appli\Spectrum\server\deploy
java.class.version=52.0
com.atomikos.icatch.file=/D:/Appli/Spectrum/server/tmp/discove...
jetty.git.hash=1be68755656cef678b79a2ef1c2ebbca99e25420
user.country=US
java.home=C:\Program Files\Zulu\zulu-8\jre
spectrum.lib.dir=lib
java.vm.info=mixed mode
wrapper.version=3.5.39-st
os.version=6.3
g1.server.tmp.dir=../tmp
path.separator=;
java.vm.version=25.462-b08
wrapper.pid=6496
wrapper.jvm.port.max=31999
wrapper.lang.folder=../lang
java.rmi.server.useCodebaseOnly=true
user.variant=
com.pb.midev.repository.jackrabbit.enable.user.creation=false
g1.server.dir=D:\Appli\Spectrum\server
wrapper.java.pid=13556
sun.awt.enableExtraMouseButtons=true
java.awt.printerjob=sun.awt.windows.WPrinterJob
java.security.policy=../conf/server.policy
g1.server.import.dir=D:\Appli\Spectrum\server\import
sun.io.unicode.encoding=UnicodeLittle
java.specification.maintenance.version=6
awt.toolkit=sun.awt.windows.WToolkit
org.teiid.enforceSingleMaxBufferSizeEstimate=false
user.script=
g1.server.types.dir=D:\Appli\Spectrum\server\types
user.home=C:\Users\zsjp_spectrum
java.specification.vendor=Oracle Corporation
java.vendor.url=http://www.azul.com/
java.library.path=../bin;../bin/wrapper
spectrum=
java.vm.vendor=Azul Systems, Inc.
wrapper.jvmid=1
g1.server.display.version=20.1
java.runtime.name=OpenJDK Runtime Environment
wrapper.lang.domain=wrapper
java.class.path=../lib/spectrum-server-boot-20.1.jar;...
sun.java.command=org.tanukisoftware.wrapper.WrapperSim...
java.vm.specification.name=Java Virtual Machine Specification
java.vm.specification.version=1.8
spectrum.services.package=com.pb.spectrum.
sun.os.patch.level=
sun.cpu.endian=little
java.awt.headless=true
java.io.tmpdir=../tmp
wrapper.cpu.timeout=10
java.vendor.url.bug=http://www.azul.com/support/
org.teiid.widenComparisonToString=true
java.awt.graphicsenv=sun.awt.Win32GraphicsEnvironment
os.arch=amd64
spectrum.help.url=http://support.pb.com/ekip/apps/redirect
java.ext.dirs=C:\Program Files\Zulu\zulu-8\jre\lib\...
user.dir=D:\Appli\Spectrum\server\bin
g1.server.log.dir=D:\Appli\Spectrum\server\logs
g1.server.exports.dir=D:\Appli\Spectrum\server\exports
line.separator=

java.vm.name=OpenJDK 64-Bit Server VM
jdk.vendor.version=Zulu 8.88.0.19-CA-win64
file.encoding=Cp1252
java.specification.version=1.8
g1.server.jdbc.drivers.dir=D:\Appli\Spectrum\server\drivers
wrapper.service=TRUE
wrapper.port=32001
g1.server.artifacts.dir=D:\Appli\Spectrum\server\artifacts
wrapper.arch=x86