EPrints 2.0.1 Documentation - Troubleshooting


Trouble Shooting

This section covers some things which can go wrong and why. If you have a suggestion for this section, let us know!

It will grow as people suggest new problems and solutions. Check the http://www.eprints.org/ website for the latest version.


Installation of EPrints and Required Software

Apache Crashes with a segmentation fault

Possible cause: apache linked against ``expat'' library. If you did not install apache from source then it is possible it was linked against the ``expat'' library. The problem arrises that it is also linked against mod_perl and when we use the XML::Parser module, that is also linked against expat. 2 expat's in one apache make it seg-fault.

(Under SuSE Linux) Apache has problems compiling the mod rewrite module

With an error something like:

 In file included from mod_rewrite.c:93:
 mod_rewrite.h:133: ndbm.h: No such file or directory

Possible cause: Missing the ndbm library which is required (for some reason).

Solution: It comes as part of gdbm which is free. If working from a package you need gdbm-devel to get the header files (.h files).


Setting Up and Configuring a New Archive

System gives a ``500 Internal Error'' when viewing advanced search or submitting a document

Possible cause: No Subjects, Bug in code.

Solution: Run generate_subjects

If this fails: Look at your apache error log for clues. If reporting a bug, include the errors from the apache error log (often, but now always, found at /usr/local/apache/logs/error_log)


General

Solution: Build apache following the detailed instructions in the ``requried software'' section of the documentation.

Changes to the configuration didn't appear on the website

Possible cause: Several.

Solution: Rebuild everything by re-running (for the archive in question) generate_static, generate_views, generate_apacheconf then stop and start apache. generate_abstracts can take a long time, so don't run it unless you want to update the abstracts themselves.

Latest Page does not update

Possible Cause: EPrints is caching the results. If people look at it alot it will not be erased from the cache for 12 hours!

Solution: In the file cgi/latest find this bit:


  my $searchexp = new EPrints::SearchExpression(
                session => $session,
                use_cache => 1,
                dataset => $ds );

and set it *not* to use the cache:

                use_cache => 0,

Browse View page gives a ``404 not found'' error or fails to update.

Possible Cause: You didn't run the script which makes them!

Solution: Run generate_views, and ideally set it up to run automatically: see ``Browse Views'' in the installation section.

 EPrints 2.0.1 Documentation - Troubleshooting