Page History

Log File

What's In It

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="f02bba72b8414339-af13d5a2-47c2476c-adc59bfd-bba4ebe089d545c6e0c4e3c2"><ac:plain-text-body><![CDATA[

[dspace]/log/dspace.log.yyyy-mm-dd

Main DSpace log file. This is where the DSpace code writes a simple log of events and errors that occur within the DSpace code. You can control the verbosity of this by editing the [dspace-source]/config/templates/log4j.properties file and then running "ant init_configs".

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="cb5a80b2171969ca-de6a2a2d-438b4e54-9c6ab65d-fe8e0622cb2514b85b50dae6"><ac:plain-text-body><![CDATA[

[dspace]/log/cocoon.log.yyyy-mm-dd

Apache Cocoon log file for the XMLUI. This is where the DSpace XMLUI logs all of its events and errors.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="4bf7cc3f0e110a68-0e622800-45c146ce-b3abaf6f-a6d608343411a17361ee87cd"><ac:plain-text-body><![CDATA[

[tomcat]/logs/catalina.out

This is where Tomcat's standard output is written. Many errors that occur within the Tomcat code are logged here. For example, if Tomcat can't find the DSpace code (dspace.jar), it would be logged in catalina.out.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="81034d0673560524-dde9d33e-42184bf9-a1f4b6e5-6851a5508a3cd2e1b6f5bc19"><ac:plain-text-body><![CDATA[

[tomcat]/logs/hostname_log.yyyy-mm-dd.txt

If you're running Tomcat stand-alone (without Apache), it logs some information and errors for specific Web applications to this log file. hostname will be your host name (e.g. dspace.myu.edu) and yyyy-mm-dd will be the date.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b4bb1a0ad99a2f8e-4227f790-4ceb4d44-927a8f13-7264787cfa6423fd02d72cf4"><ac:plain-text-body><![CDATA[

[tomcat]/logs/apache_log.yyyy-mm-dd.txt

If you're using Apache, Tomcat logs information about Web applications running through Apache (mod_webapp) in this log file (yyyy-mm-dd being the date.)

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="4befdb0e4b048936-d1774744-411241d3-b647916e-b991fc08f52c51d07c7d8fd2"><ac:plain-text-body><![CDATA[

[apache]/error_log

Apache logs to this file. If there is a problem with getting mod_webapp working, this is a good place to look for clues. Apache also writes to several other log files, though error_log tends to contain the most useful information for tracking down problems.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="af8c732d3b5e8716-9f3b556b-4c96452a-8139a87c-26ee14e7f43632564f31ca1d"><ac:plain-text-body><![CDATA[

[dspace]/log/handle-plug.log

The Handle server runs as a separate process from the DSpace Web UI (which runs under Tomcat's JVM). Due to a limitation of log4j's 'rolling file appenders', the DSpace code running in the Handle server's JVM must use a separate log file. The DSpace code that is run as part of a Handle resolution request writes log information to this file. You can control the verbosity of this by editing [dspace-source]/config/templates/log4j-handle-plugin.properties.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="75058f3ca7caf1e4-4d8f586f-46ac469a-9eb7bb4d-685552e1cc3dbe8173e294db"><ac:plain-text-body><![CDATA[

[dspace]/log/handle-server.log

This is the log file for CNRI's Handle server code. If a problem occurs within the Handle server code, before DSpace's plug-in is invoked, this is where it may be logged.

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="4ca9bb40ad54766a-04725d51-41fd4999-bd67aa8b-bae366c83444b6992e2f6ba6"><ac:plain-text-body><![CDATA[

[dspace]/handle-server/error.log

On the other hand, a problem with CNRI's Handle server code might be logged here.

]]></ac:plain-text-body></ac:structured-macro>

PostgreSQL log

PostgreSQL also writes a log file. This one doesn't seem to have a default location, you probably had to specify it yourself at some point during installation. In general, this log file rarely contains pertinent information--PostgreSQL is pretty stable, you're more likely to encounter problems with connecting via JDBC, and these problems will be logged in dspace.log.