{{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

| 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 ==

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