Difference between revisions of "Upgrading 3.1 to 3.2"

From EPrints Documentation
Jump to: navigation, search
Line 1: Line 1:
== Why must I do this ==
== Why must I do this ==

Revision as of 17:16, 10 March 2010

Why must I do this

This has always been an essential step of upgrading your EPrints repository. However in 3.2 we are making a particularly big deal about it for two reasons:

  1. If you do not do it your server will not work
  2. It takes several hours to do on large databases

What is it doing

It is upgrading the database structure to use UTF8 compatible tables rather than the previous latin1 tables. This means even better and more robust multi-lingual support. It is also adding essential configuration files to your EPrints cfg.d folder. Because EPrints now expects utf8 tables and the new cfg.d files it will not run correctly without performing the following upgrade.

How do I do it?

It's very easy

/etc/init.d/httpd stop
./bin/epadmin upgrade <archive_id>
/etc/init.d/httpd start

Remember ./bin/epadmin upgrade <archive_id> will take serveral hours to run on large repositories because it has to modify every table in the database.

On success you should see the message Database flag set to 3.2.1.

If you have any problems let us know on EP-Tech. For free support and discussion about EPrints you can sign up to the EP-Tech here: http://mailman.ecs.soton.ac.uk/mailman/listinfo/eprints-tech.


  • Critical for the successful running of your repo

./bin/epadmin upgrade <archive_id>

  • This may take some time dependant on the amount of records in your system and number of revisions.
  • The database will be upgraded to be faster and fully UTF8 compatible.
  • It is recommended that your web server (apache) is offline.
  • The final output of the command should be the version number of the database 3.2.1.