EPrints 2.0.1 Documentation - Updating from Previous Versions



Updating from EPrints 1

This path is not currently supported, as the software structure underwent fundamental changes. We recommend that you do a clean install of EPrints 2.0.

We hope to provide an v1 to v2 ``upgrade assister'' at some point.


Updating from EPrints2-alpha-2 to EPrints 2.0

Too much of the configuration of the archive has changed to document individually. See the CHANGELOG file if you're really interested. If you have more than one archive, then do each step for each one. Our example is the archive with the ID foobar.

To upgrade we suggest you use the UNIX diff command to make a records of changes you made to the archive config directory.

 diff /opt/eprints2/defaultcfg/ /opt/eprints2/archives/foobar/cfg/

Store the output from diff somewhere safe.

Remove /opt/eprints2/archives/foobar/cfg/

Now install eprints 2.0 and agree to upgrade when it asks.

Copy the new default configuration into your archive dir:

 cp -R /opt/eprints2/defaultcfg/ /opt/eprints2/archives/foobar/cfg/

Work through the ``diff'' you produced, and re-apply the changes to the contents of /opt/eprints2/archives/foobar/cfg/.

You also need to execute the following SQL command.

 UPDATE document SET security='' WHERE security='public';

To connect to mysql via the command line run:

 mysql -u eprints foobar -p

And enter the database password for that archive.

Now re-run generate_apacheconf and restart apache.

Upgrading from 2.0 should be less painful than this, the config files should change less dramatically from now on.


Updating from EPrints 2.0 to EPrints 2.0.1

These release is mostly a bug fix release. There are a few bugs in the config files which you should fix by hand. After upgrading EPrints, repeat these steps for the cfg directory of archive you have:

* In citations-en.xml in the citation for poster, the year field is incorrecly named &years; rename it to &year;

* (This is not essential) Also on the citations file for the ``eprint'' and ``user'' citation types: add a <ep:linkhere> .... </ep:linkhere> just inside the <ep:citation> tag.

* There was a bug in ArchiveFreeTextIndexingConfig.pm which meant that ``return'' was treated as part of a word, rather than a word break. Unless you have modifed that file, just replace it with the new one from /opt/eprints2/defaultcfg/

* (This is not essential) The title for the abstract block never gets added to the page. Edit ArchiveRenderConfig.pm - search for eprint_fieldname_abstract and add the following line as the next line:

  $page->appendChild( $h2 );

 EPrints 2.0.1 Documentation - Updating from Previous Versions