Log Files

From EPrints Documentation
Jump to: navigation, search


EPrints produces a number of log files, as do the integral components of EPrints such as Apache and MySQL. Below is a list of logs files that may be of interest for debugging EPrints. (Please note that log files may appear in different place for different operating systems):

Name Typical Location on Red Hat based Linux Typical Location on Debian based Linux Purpose Uses
Apache access log /var/log/httpd/access_log /var/log/apache2/access.log Logs all accesses to HTTP URLs hosted by Apache unless an individual access log has been created for a particular "virtualhost". Can be searched over to check IP addresses that are making excessive or malicious requests.
Apache error log /var/log/httpd/error_log /var/log/apache2/error.log Logs all issues that occur with Apache or underlying application (i.e. perl and mod_perl) when attempting to service URL requests. Can be used to debug issues with EPrints code base, where a script cannot or behaves normally when run directly from the command line.
Apache ssl access log /var/log/httpd/ssl_access_log /var/log/apache2/ssl_access.log Logs all accesses to HTTPS URLs hosted by Apache unless an individual access log has been created for a particular "virtualhost". Can be searched over to check IP addresses that are making excessive or malicious requests for HTTPS URLs.
Apache ssl error log /var/log/httpd/ssl_error_log /var/log/apache2/ssl_error.log Logs all issues that occur with Apache or underlying application (i.e. perl and mod_perl) when attempting to service HTTPS URL requests. Can be used to debug issues with EPrints code base, where a script cannot or behaves normally when run directly from the command line.
MySQL log /var/log/mysql/mysql.log or /var/log/mariadb/mariadb.log /var/log/mysql/error.log Logs general operational issue about MySQL and any errors that occur with the application but not specific database queries Only really useful if MySQL / MariaDB will not start properly.
EPrints indexer log EPRINTS_PATH/var/indexer.log EPRINTS_PATH/var/indexer.log Logs information and error messages generated by the EPrints indexer that is used to schedule more processor intensive tasks to ensure EPrints itself remains responsive To find out why tasks in your event queue (see http://EPRINTS_HOSTNAME/cgi/users/home?screen=Listing&dataset=event_queue) have failed.
EPrints openoffice log EPRINTS_PATH/var/openoffice.log EPRINTS_PATH/var/openoffice.log If you have the Coversheets plugin installed it logs information and error messages generated by OpenOffice that runs to generate coversheets to stitch onto the front of uploaded PDF documents This file only really logs issues with OpenOffice general running not specific issues cover-sheeting a particular document. The EPrints indexer log will more likely contain this information.
EPrints login attempts log EPRINTS_PATH/archives/ARCHVEID/var/login_attempts/yyyy/mm/dd.csv EPRINTS_PATH/archives/ARCHVEID/var/login_attempts/yyyy/mm/dd.csv Logs all issues that occur due to login attempts. Can be used to debug issues with failing or erroneous logins.

Parsing the Apache access log

...