Difference between revisions of "Installing EPrints on Debian/Ubuntu"

From EPrints Documentation
Jump to: navigation, search
(Setting up a Repository)
(video no longer plays)
(16 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
[[Category:Debian and Ubuntu]]
 
[[Category:Debian and Ubuntu]]
 +
[[Category:Installation]]
  
David Tarrant has built a Debian/Ubuntu package for Eprints.
 
  
 
=APT Mirrors=
 
=APT Mirrors=
Line 7: Line 7:
 
<b>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.</b>
 
<b>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.</b>
  
==EPrints 3.1==
+
==EPrints Latest==
===Stable Release===
 
  
Add the following to /etc/apt/sources.list:
+
To install the testing build add the following to /etc/apt/sources.list:
  
deb http://deb.eprints.org/3.1/ stable/
+
===Stable Builds===
deb-src http://deb.eprints.org/3.1/ source/
 
  
===Unstable Release===
+
deb http://deb.eprints.org/ stable/
  
To install the latest '''unstable''' release add the following to /etc/apt/sources.list:
+
=Installing Eprints via apt-get
 
 
deb http://deb.eprints.org/3.1/ unstable/
 
deb-src http://deb.eprints.org/3.1/ source/
 
 
 
===Nightly Build===
 
 
 
To install the nightly build add the following to /etc/apt/sources.list:
 
 
 
deb http://deb.eprints.org/3.1/ nightly/
 
deb-src http://deb.eprints.org/3.1/ source/
 
 
 
==EPrints 3.0==
 
To install the old 3.0 branch follow the same instructions as above replacing 3.1 with 3.0 in all instances.
 
 
 
==EPrints 3.2 (Current Trunk Build)==
 
 
 
This is available as a nightly build only and offers no guarantees.
 
 
 
To install the nightly build add the following to /etc/apt/sources.list:
 
 
 
deb http://deb.eprints.org/3.2/ nightly/
 
deb-src http://deb.eprints.org/3.2/ source/
 
 
 
 
 
=Installing Eprints via apt-get=
 
  
 
To install Eprints and all its dependencies execute the following (as root):
 
To install Eprints and all its dependencies execute the following (as root):
Line 65: Line 38:
  
 
If you have any problems getting set up you can get free help and support from the EP-Tech mailing list. {{EPrintsTech}}
 
If you have any problems getting set up you can get free help and support from the EP-Tech mailing list. {{EPrintsTech}}
 +
 +
== Setting up your crontab ==
 +
 +
See [[Automating your maintenance]]
  
 
=Getting and Compiling from Source (not required)=
 
=Getting and Compiling from Source (not required)=
Line 75: Line 52:
  
 
The source will be saved to a tarball in the current directory.
 
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.
 +
 +
A complete HOW-TO guide to install EPrints3 on Ubuntu 14.04 is available [http://wiki.unimas.my/unimaswiki//bin/view/HOW-TO,+Tutorial+&+User+Manual/HOW-TO+:+Install+Eprints+v3.3.12++on+Ubuntu+14.04+With+LDAP+Authentication 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)
 +
 +
*access_compat.load                   
 +
*alias.conf                                   
 +
*alias.load                             
 +
*auth_basic.load                           
 +
*authn_core.load
 +
*authn_file.load
 +
*authz_core.load
 +
*authz_host.load
 +
*authz_user.load
 +
*autoindex.conf
 +
*autoindex.load
 +
*deflate.conf
 +
*deflate.load
 +
*dir.conf
 +
*dir.load
 +
*env.load
 +
*filter.load
 +
*mime.conf
 +
*mime.load
 +
*mpm_prefork.conf
 +
*mpm_prefork.load
 +
*negotiation.conf
 +
*negotiation.load
 +
*perl.load
 +
*php5.conf
 +
*php5.load
 +
*setenvif.conf
 +
*setenvif.load
 +
*status.conf
 +
*status.load

Revision as of 08:49, 1 August 2016


APT Mirrors

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.

EPrints Latest

To install the testing build add the following to /etc/apt/sources.list:

Stable Builds

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 EP-Tech.

Setting up your crontab

See Automating your maintenance

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.

A complete HOW-TO guide to install EPrints3 on Ubuntu 14.04 is available here

Current patches on github are:


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)

  • access_compat.load
  • alias.conf
  • alias.load
  • auth_basic.load
  • authn_core.load
  • authn_file.load
  • authz_core.load
  • authz_host.load
  • authz_user.load
  • autoindex.conf
  • autoindex.load
  • deflate.conf
  • deflate.load
  • dir.conf
  • dir.load
  • env.load
  • filter.load
  • mime.conf
  • mime.load
  • mpm_prefork.conf
  • mpm_prefork.load
  • negotiation.conf
  • negotiation.load
  • perl.load
  • php5.conf
  • php5.load
  • setenvif.conf
  • setenvif.load
  • status.conf
  • status.load