Editing User:Ckeene/ep3 upgrade (section)

=== Configure an archive ===
# Documentation a little unclear here, the Ubuntu docs tell us to follow the 'main eprints3 documentation', so from the main Eprints3 page I clicked on 'installation' and then followed [[Getting Started]] on the right, this seems half updated for eprints3 but also referes to eprints2. 
# However I also found on the main Eprints 3 docs page a link to [[Getting Started with EPrints 3] which I shall follow here. I also found the bottom of [https://wiki.eprints.org/w/Installing_EPrints_3_on_RedHat_Enterprise_4 Installing EPrints 3 on RedHat Enterprise 4]] useful. (I've updated the Ubuntu page to link to these two pages).
# cd /opt/eprints3/
# bin/epadmin create
# (at this point I create a cname in our dns for ep3v.lib.sussex.ac.uk as an alias for eprints.lib.sussex.ac.uk, the v is for vanilla as this will be a eprints3 install with no changes made to it for reference)
# archiveID is ep3v
# continue to enter details as prompted, at db username i accept the default it suggests. Get stuck with db password, reports 'bad input'. I quit out of this, and then played with epadmin config_db. In the end had a database but no user and it just didn't seem happy. Easy option, delete directory and start again!
# epadmin create, again, good until, complains "EPrints can create the database, and grant the correct permissions." when doing the db stuff, this was because I had forgotten to delete the ep3v db (which I should have done when I deleted the directory). 
# because the create process terminated prematurely I need to run some commands manually
# run bin/epadmin config_db ep3v
# run bin/create_user ep3v (seems to have a fairly strict password criteria, a 7 digit combination of numbers and letters produced 'bad input')
# bin/generate_static ep3v
# bin/import_subjects ep3v
# bin/generate_apacheconf
# sudo /usr/sbin/apache2ctl stop
# It works!
# http://ep3v.lib.sussex.ac.uk:8082/

22 June 2007