Installing EPrints on Debian/Ubuntu
David Tarrant has built a Debian/Ubuntu package for Eprints.
- 1 APT Mirrors
- 2 Installing Eprints via apt-get
- 3 Setting up a Repository
- 4 Getting and Compiling from Source (not required)
- 5 Issues with Ubuntu 13/14 (Apache 2.3/2.4)
Add one of the following mirrors (2 lines) to your /etc/apt/sources.list file as the root user. Please ensure that there is only one set in the file or you may not experience the correct behaviour.
To install the testing build add *one* the following to /etc/apt/sources.list:
deb http://deb.eprints.org/ stable/ deb-src http://deb.eprints.org/ source/
deb http://deb.eprints.org/ unstable/ deb-src http://deb.eprints.org/ source/
Rather than the above add the following to /etc/apt/sources.list (note that this code is in developement and will not neccessarily compile):
deb http://deb.eprints.org/ nightly/ deb-src http://deb.eprints.org/ source/
EPrints 3.X (Specific Version Locking)
Add the following to /etc/apt/sources.list:
deb http://deb.eprints.org/3.X/ stable/ deb-src http://deb.eprints.org/3.X/ source/
To install the latest unstable release add the following to /etc/apt/sources.list:
deb http://deb.eprints.org/3.X/ unstable/ deb-src http://deb.eprints.org/3.X/ source/
To install the nightly build add the following to /etc/apt/sources.list:
deb http://deb.eprints.org/3.X/ nightly/ deb-src http://deb.eprints.org/3.X/ source/
Installing Eprints via apt-get
To install Eprints and all its dependencies execute the following (as root):
apt-get update apt-get install eprints
Setting up a Repository
You should now have a working installation of eprints in /usr/share/eprints3/. Please follow the on-screen instructions to set up an eprints repository. You probably want to start with (as root):
For more information about setting up an EPrints repository take a look at Getting Started with EPrints 3
Read First: Known issues with the Debian/Ubuntu package can be found at Debian Known Issues.
su eprints cd ./bin/epadmin create logout a2ensite eprints3 apache2ctl restart
If you have any problems getting set up you can get free help and support from the EP-Tech mailing list. 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.
Getting and Compiling from Source (not required)
To install dependencies and retrieve the Eprints source execute the following:
apt-get update apt-get build-dep eprints apt-get source eprints
The source will be saved to a tarball in the current directory.
Issues with Ubuntu 13/14 (Apache 2.3/2.4)
Apache 2.3+ and PERL v5.16+ introduce a few changes which break EPrints.
Current patches on github are:
- See last comment on https://github.com/eprints/eprints/issues/214 [ use of remote_ip ]
- https://github.com/eprints/eprints/issues/237 [ NameVirtualHost deprecated ]
- https://github.com/eprints/eprints/issues/236 [ Order allow,deny deprecated ]
- https://github.com/eprints/eprints/commit/157db0d27d423d38f9c0fc31ce47e519cd861d45 [ utf8::decode and URI parameters ]
Ensure that mpm_prefork module is enabled in /etc/apache2/mods-enabled (among others).
Complete list of modules for a working repository include the following (although some may be surplus to requirements e.g. php5 is not strictly necessary)