User:Ckeene/ep3 upgrade

Eprints 3 upgrade

A journal of our upgrade process from eprints2 to eprints3. This will include my own stupid mistakes and errors, many will be laughable and show my true incompetence. I keep them here so others do not do the same!

Current situation

Current Version: EPrints 2.3.12 (Southern Chicken) [Born on 2005-05-24] Running on Ubuntu 6.06 LTS (based on Debian) Visual look and quite a bit of the wording has been changed, and endnote/BibTeX import functionality has been added (via the downloads from the eprints.org site).

The plan

1. Apache 2 installed, with mod perl and php
2. Other dependencies
3. Install eprints3
4. Create test archive (ep3a)
5. Install and run migration tool. Document results.
6. Look in to problems, use mailing list for support
7. Modify wording of user interface (both for depositors and end users) to follow changes made on eprints2 (where they still apply and where changes were not bought across)
8. Apply Sussex Templates to eprints3
9. Install additional modules to bring in line with extra functionality of our eprints2 setup, see table below
10. Repeat migration process of data to test and address issues.
11. Follow steps to add additional functionality, such as auto-complete features, which are not out-of-the-box, but core features of eprints3.
12. Update documentation and screenshots ready for eprints3
13. Demonstrate to others, solicit feedback
14. Make changes based on user feedback
15. Migrate data one final time, update apache so that eprints.sussex.ac.uk points to eprints3, not eprints2. This will make eprints3 live. woohoo!

Steps to bring eprint3 (out of the box) in-line with our current eprints2

1. Import from Endnote
2. Import from Bibtex
3. LDAP authentication
4. Import/update users from text file
5. Fields created to hold record id (from Uni pub db) and personnel id (for Sussex authors)

Install Apache 2, mod_perl, etc

1. key doc http://wiki.eprints.org/w/Installing_EPrints_3_on_Ubuntu_6.10
2. sudo apt-get install apache2 libapache2-mod-perl2
3. eprints2 is on port 80. vi /etc/apache2/ports.cfg, changed from 80 to 8082
4. /usr/sbin/apache2ctl start
5. http://localhost:8082/ http://researchonline.lib.sussex.ac.uk:8082/ http://eprints.sussex.ac.uk:8082/ all work!
6. [we already have mysql installed - skip step]
7. sudo apt-get install libxml-libxml-perl libunicode-string-perl \

 libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl

1. most of these were already installed. but at least

libterm-readkey-perl libmime-lite-perl were not.

1. /etc/init.d/httpd stop start - eprints2 is still working!
2. sudo cpan install Readonly

Eprints 3 install

1. Follow http://wiki.eprints.org/w/Installing_EPrints_3_on_Ubuntu_6.10
2. We already have an 'eprints' user so I'm going to try and not create one now, the only issue might be that the instructions state the users home should be /opt/eprints3 but I'm going to leave it as /home/eprints/ and see what happens
3. sudo adduser www-data eprints
4. tar xzvf eprints-3.0.2-beta-3.tar.gz (yup I'm installing a beta!)
5. cd eprints-3.0.2-beta-3
6. Remind myself of our smtp server: grep smtp /opt/eprints2/perl_lib/EPrints/SystemSettings.pm
7. ./configure --with-smtp-server=smtp.sussex.ac.uk
8. sudo ./install.pl