Difference between revisions of "Upgrading EPrints 3 versions"

From EPrints Documentation
Jump to: navigation, search
(incorporate instructions from cjg on eprints-tech)
 
m
 
(13 intermediate revisions by 7 users not shown)
Line 1: Line 1:
EPrints developer Christopher Gutteridge gives the following instructions:
+
[[Category:Upgrading]]{{Deprecated|These instructions refer to earlier versions of EPrints 3.  It is advised that if you wish to [[Upgrading|upgrade you do so to the latest version of EPrints 3]]}}
  
Upgrading 3.0.0 to 3.0.1 is very easy - just run <tt>configure</tt> with the  
+
== Upgrading 3.0.x to 3.0.y ==
<tt>--prefix</tt> set to the location of the current repo. It'll upgrade the software.  Then run
+
 
 +
This is very easy - just run <tt>configure</tt> with the  
 +
<tt>--prefix</tt> 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
 
  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.
+
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 [http://www.eprints.org/tech.php/6598.html], 2007-04-13 to eprints-tech)
 
(lightly edited from [http://www.eprints.org/tech.php/6598.html], 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]
 +
* epadmin update [repoid]
 +
* restart Apache ( /etc/init.d/apache2 force-reload )

Latest revision as of 11:14, 6 September 2017

Warning.png

Deprecated
This page has been deprecated.

These instructions refer to earlier versions of EPrints 3. It is advised that if you wish to upgrade you do so to the latest version of EPrints 3

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]
  • epadmin update [repoid]
  • restart Apache ( /etc/init.d/apache2 force-reload )