Installing EPrints on Debian/Ubuntu
- Ubuntu 14.04 LTS or 16.04 LTS (non-LTS versions not recommended) or Debian 7 (Wheezy) or 8 (Jessie).
Installing from EPrints 3.3.x DEB
deb http://deb.eprints.org/ stable/
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.
Installing EPrints 3.3.x from Source
N.B. Installing from source is generally discouraged particularly for production repositories. However, if want to develop the EPrints code or a plugin or Bazaar package it may be useful to install from source, ideally from EPrints Core Git repository.
Issues with Ubuntu 14.04 (Apache 2.3/2.4)
Apache 2.3+ and PERL v5.16+ introduce a few changes which break EPrints.
A complete HOW-TO guide to install EPrints3 on Ubuntu 14.04 is available here
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)