Troubleshoot an error (JSP)

From DSpace Wiki

[edit] Directories/files:

• DSpace log file: [dspace]/log/dspace.log (usually)
• Tomcat log directory: [Tomcat]/logs (usually)
• [dspace-source]/jsp/local/
• Servlet directory: [dspace-source]/src/org/dspace/app/webui/servlet

[edit] Websites:

• DSpace technical FAQ: http://wiki.dspace.org/TechnicalFaq
• DSpace Sourceforge page: http://sourceforge.net/projects/dspace/
• Search dspace-tech mailing list: http://sourceforge.net/mailarchive/forum.php?forum=dspace-tech

[edit] Instructions:

1. If the expected information simply never appears, leaving a blank browser screen, the problem is almost certainly with a servlet. The error message should be in either [dspace]/log/dspace.log or [Tomcat]/logs/
2. If you get an Internal Server Error, a JSP or some source code could be the problem. If your email address is set up in dspace.cfg as the DSpace administrator, check your email for the error listing. If not, ssh to the DSpace machine, cd to the log directory and tail -100 dspace.log.
   • (Windows) Go to the DSpace log directory, and open dspace.log in your favorite text editor. Look near the bottom for the error message.
3. Usually, the culprit file is in the first five to ten lines of the error stack listing. The error stack starts with a line similar to:

   yyyy-mm-dd time WARN … 

   (OR)

   yyyy-mm-dd time ERROR … 

4. Search the DSpace technical FAQ and the dspace-tech mailing list for information on the error. Key words in the error often are useful search terms.
5. If all else fails, email a description of the error along with the error stack listing to mailto:dspace-tech@lists.sourceforge.net.