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

From EPrints Documentation
Jump to: navigation, search
(Updated structure of page to be similar to RHEL installation guide.)
Line 2: Line 2:
 
[[Category:Installation]]
 
[[Category:Installation]]
  
 +
== Requirements ==
 +
* Ubuntu 14.04 LTS or 16.04 LTS (non-LTS versions not recommended) or Debian 7 (Wheezy) or 8 (Jessie).
  
=APT Mirrors=
+
== Installing form EPrints 3.3.x DEB ===
 
+
<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 Latest==
+
 
+
To install the testing build add the following to /etc/apt/sources.list:
+
 
+
===Stable Builds===
+
  
 
  deb http://deb.eprints.org/ stable/
 
  deb http://deb.eprints.org/ stable/
  
=Installing Eprints via apt-get
+
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 39: Line 33:
 
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 ==
+
== 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 [https://github.com/eprints/eprints EPrints Core Git repository].'''
  
See [[Automating your maintenance]]
+
...
  
=Getting and Compiling from Source (not required)=
+
==Getting Started==
  
To install dependencies and retrieve the Eprints source execute the following:
+
See [[Getting Started with EPrints 3]].
  
apt-get update
 
apt-get build-dep eprints
 
apt-get source eprints
 
  
The source will be saved to a tarball in the current directory.
+
== Troubleshooting ==
  
 
+
===Issues with Ubuntu 14.04 (Apache 2.3/2.4)===
=Issues with Ubuntu 13/14 (Apache 2.3/2.4)=
+
  
 
Apache 2.3+ and PERL v5.16+ introduce a few changes which break EPrints.
 
Apache 2.3+ and PERL v5.16+ introduce a few changes which break EPrints.
Line 66: Line 57:
 
* https://github.com/eprints/eprints/issues/236 [ Order allow,deny deprecated ]
 
* https://github.com/eprints/eprints/issues/236 [ Order allow,deny deprecated ]
 
* https://github.com/eprints/eprints/commit/157db0d27d423d38f9c0fc31ce47e519cd861d45 [ utf8::decode and URI parameters ]
 
* https://github.com/eprints/eprints/commit/157db0d27d423d38f9c0fc31ce47e519cd861d45 [ utf8::decode and URI parameters ]
 
  
  

Revision as of 10:38, 1 September 2017


Requirements

  • Ubuntu 14.04 LTS or 16.04 LTS (non-LTS versions not recommended) or Debian 7 (Wheezy) or 8 (Jessie).

Installing form 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.

...

Getting Started

See Getting Started with EPrints 3.


Troubleshooting

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:


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