Upgrading EPrints 3 versions

From EPrints Documentation
Revision as of 14:45, 14 May 2009 by Dkane (talk | contribs)
Jump to: navigation, search

EPrints developer Christopher Gutteridge gives the following instructions:

Upgrading 3.0.x to 3.0.y

This is very easy - just run configure with the --prefix set to the location of the current repo (you may also need to set the --with-user and --with-group options). Then run install.pl to upgrade the software. Then run

epadmin upgrade REPOID

For each repository to update the database. Normally minor updates would not update the db at all. In this case all it does is add an SQL index to make things go faster. Restart the webserver in indexer after an upgrade. (or better, shut them off before you start to upgrade)

(lightly edited from [1], 2007-04-13 to eprints-tech)

Upgrading 3.0.x to 3.1.x

This is not yet widely tested, so at your own risk. Initial notes on 3.1.0-beta-2.

  • large repositories can take a significant chunk of time to run epadmin upgrade (many minutes)
  • "Views" get a little screwed up as the new configuration options are slightly altered.
  • New Features in EPrints 3.1 has a list of suggested configuration changes. The "variations" option replaces "subheadings" option.

Known issues:

  • epadmin upgrade reports lots of SQL errors, but these don't cause any problems
  • VLit plugin is broken
  • beta-2 has a bug which means "Smith, J" searches don't work on names but searching "Smith" does.
  • "include" option in view.pl is being ignored.


Upgrading 3.1.x to 3.1.y

  • unpack tar file to /[path]
  • (as root) cd /[path]/eprints-3.1.y
  • ./configure
  • ./install.pl
  • (as eprints) cd /opt/eprints3
  • epadmin upgrade [repoid]
  • restart Apache ( /etc/init.d/apache2 force-reload )