SUNScholar/Troubleshooting

Back to Optimisations

Logs Debug Mode

Turning on Debugging (optional) If you'd like to try and do some debugging yourself, you can change the DSpace logger settings to DEBUG which will sometimes provide you with more information about the error.

1. To turn on debugging, visit the /home/dspace/config/log4j.properties file and modify log levels as needed.
2. To enable DEBUG logging in the /home/dspace/log/dspace.log file, change the log4j.rootCategory and log4j.logger.org.dspace settings to DEBUG rather than INFO.
3. (XMLUI Only) To enable DEBUG logging in the /home/dspace/log/cocoon.log file, change the log4j.logger.org.apache.cocoon setting to DEBUG rather than INFO.
4. With DSpace versions =>4.X, log levels can now be set in the /home/dspace/source/build.properties file. To change log levels, edit the /home/dspace/source/build.properties, then rebuild DSpace.

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!

References

• https://wiki.duraspace.org/display/DSPACE/Troubleshoot+an+error
• https://wiki.duraspace.org/display/DSDOC4x/Troubleshooting+Information