<%-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --%><%@page import="org.apache.jackrabbit.util.Text, java.io.StringWriter, java.io.PrintWriter"%><% request.setAttribute("title", "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 <%= Text.encodeIllegalXMLCharacters(application.getServerInfo()) %> servlet container that supports the Java Servlet API version <%= application.getMajorVersion() %>.<%= application.getMinorVersion() %>.

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

<% StringWriter buffer = new StringWriter(); System.getProperties().list(new PrintWriter(buffer)); %>
<%= Text.encodeIllegalXMLCharacters(buffer.toString()) %>