Page History
...
Table of Contents | ||||
---|---|---|---|---|
|
Error Log Files
*DSpace log:* {{\Wiki Markup [dspace
\]/log/dspace.log
}} (_usually_)- unmigrated-wiki-markup
- {{\
[dspace
\]
}} is the location where DSpace is installed.
- {{\
- Tomcat log directory:* {{\
[tomcat
\]/logs
}} (_usually_)- unmigrated-wiki-markup
- {{\
[tomcat
\]
}} is the location where Tomcat is installed.
- {{\
- (XMLUI Only) Cocoon log:
- unmigrated-wiki-markup
- DSpace 1.5.1 or previous: {{\
[tomcat
\]/webapps/<name-of-webapp>/WEB-INF/logs/
}}unmigrated-wiki-markup - DSpace 1.5.2 or later: {{\
[dspace
\]/log/cocoon.log
}}
- DSpace 1.5.1 or previous: {{\
Resources
- Search All DSpace mailing lists (along with the Issue Tracker): http://dspace.2283337.n4.nabble.com/
- Browse or Search dspace-tech mailing list: http://www.mail-archive.com/dspace-tech@lists.sourceforge.net/
- Browse or Search the issue tracker for known/fixed bugs: https://jira.duraspace.org/browse/DS
- DSpace technical FAQ: TechnicalFaq
...
Finding the Error Message in your Log Files
...
- If the expected information simply never appears, leaving a blank browser screen, the problem is likely with either a servlet (for JSPUI) or an XSLT Theme (for XMLUI). The error message should be in either {{\
[dspace
\]/log/dspace.log
}} OR {{\[tomcat
\]/logs/
}}. For the XMLUI, you may also want to check the Cocoon logs (see above for path) to see if any extra information can be found there. If you get an "Internal Server Error" message, you will have to check the log files for a full error listing. If your email address is set up in dspace.cfg ({{Wiki Markup alert.recipient
}}) as the DSpace Administrator, you should receive an email with this full error listing. If not, move into the DSpace log directory ({{\[dspace
\]/log
}}) and view the end of the log file:- (Linux or Mac OSX) Go to the DSpace log directory via the command line and enter:
tail -100 dspace.log
Alternatively, you can open up the dspace.log file in your favorite text editor and look near the bottom of the file for the error message. - (Windows) Go to the DSpace log directory, and open dspace.log in your favorite text editor. Look near the bottom for the error message.
- (Linux or Mac OSX) Go to the DSpace log directory via the command line and enter:
- Usually, the culprit error is in the first five to ten lines of the error stack listing. The error stack starts with a line similar to one of the following:
yyyy-mm-dd time ERROR ...
OR,yyyy-mm-dd time WARN ...
...
- Usually the easiest way to search our lists is using Nabble. It actually allows you to search all of the DSpace mailing lists at the same time (along with issues from our issue tracker): http://dspace.2283337.n4.nabble.com/
- NOTE: Key words in the error often are useful search terms.
- You may also choose to search the the dspace-tech mailing list and DSpace technical FAQ for information on the error.
Turning on Debugging (optional)
If you'd like to try and do some debugging yourself, you can change the DSpace logger settings to {{Wiki Markup DEBUG
}} which will sometimes provide you with more information about the error. To turn on debugging, visit the {{\[dspace
\]/config/log4j.properties
}} file and do the following:- To enable DEBUG logging in the
dspace.log
file, change thelog4j.rootCategory
andlog4j.logger.org.dspace
settings toDEBUG
rather thanINFO
. - (XMLUI Only) To enable DEBUG logging in the
cocoon.log
file, change thelog4j.logger.org.apache.cocoon
setting toDEBUG
rather thanINFO
. - NOTE: You'll need to restart Tomcat after enabling DEBUG mode in the
log4j.properties
file. - WARNING: Make sure to turn off debugging once you are finished. Leaving debugging turned on will cause the log files to grow very large very quickly!
- To enable DEBUG logging in the
...
Overview
Content Tools