Difference between revisions of "Log Files"

From EPrints Documentation
Jump to: navigation, search
m
(Added indexer and openoffice log files.)
 
Line 1: Line 1:
{{Work in Progress|Only some of the log files produced by EPrints and associated applications have been listed so far.}}
 
 
 
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):
 
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):
  
Line 40: Line 38:
 
| Logs general operational issue about MySQL and any errors that occur with the application but not specific database queries
 
| 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.
 
| 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.
 
|}
 
|}
  
 
== Parsing the Apache access log ==
 
== Parsing the Apache access log ==

Latest revision as of 12:40, 8 September 2017

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.

Parsing the Apache access log