About Features Downloads Getting Started Documentation Events Support GitHub

Site Tools


development:troubleshooting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
development:troubleshooting [2019/03/07 08:45]
demiankatz
development:troubleshooting [2019/05/03 07:52] (current)
demiankatz [Check the Apache Error Log]
Line 2: Line 2:
  
 When VuFind doesn'​t behave as expected, there are several things you can do to gain more information about what is going wrong. When VuFind doesn'​t behave as expected, there are several things you can do to gain more information about what is going wrong.
 +
 +===== Check Error Logs =====
 +
 +If you are not seeing on-screen errors, it is possible that they are being captured by the Apache error log (often found in /​var/​log/​apache2/​error.log,​ /​var/​log/​httpd/​error.log,​ or a similar path). Checking the end of this log (or watching it with the "tail -f" command) may reveal useful information.
 +
 +Some operating systems use [[https://​php-fpm.org/​|PHP-FPM]] to run PHP, and the PHP-FPM error log is another place to check in this case. It is often found at /​var/​log/​php-fpm/​www-error.log (or something similar).
  
 ===== Turn on Development Mode ===== ===== Turn on Development Mode =====
Line 10: Line 16:
  
 When in doubt, empty the contents of $VUFIND_LOCAL_DIR/​cache -- this can solve several common problems, such as changes to language files not appearing immediately. When in doubt, empty the contents of $VUFIND_LOCAL_DIR/​cache -- this can solve several common problems, such as changes to language files not appearing immediately.
 +
 +===== Check Permission / Security Settings =====
 +
 +If Apache is not allowed to read or write certain directories (particularly the cache), VuFind may have problems. The $VUFIND_LOCAL_DIR/​cache directory (and all of its subdirectories except "​cli"​) should be writable by the user running Apache (often named www-data or apache, depending on your operating system). The $VUFIND_LOCAL_DIR/​cache/​cli directory (and all of its subdirectories) should be writable by the user running command-line utilities. Also make sure that SELinux is not interfering with VuFind'​s operations; see the [[installation:​fedora|Fedora Installation Instructions]] for more details on SELinux.
  
 ===== Turn on Debug Mode ===== ===== Turn on Debug Mode =====
development/troubleshooting.1551966346.txt.gz · Last modified: 2019/03/07 08:45 by demiankatz