EPrints 2.0.1 Documentation - Updating from Previous Versions |
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.
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.
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 |