Log Files

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

...