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

From EPrints Documentation
Jump to: navigation, search
m
Line 6: Line 6:
  
 
== Installing from EPrints 3.3.x DEB ==
 
== Installing from EPrints 3.3.x DEB ==
 +
As the root user create a file at /etc/apt/sources.list.d/eprints.list and add the following line
  
 
  deb http://deb.eprints.org/ stable/
 
  deb http://deb.eprints.org/ stable/
  
Installing Eprints via apt-get
+
Now to install EPrints and all its dependencies execute the following command, again as the root user:
 
+
To install Eprints and all its dependencies execute the following (as root):
+
  
 
  apt-get update
 
  apt-get update
 
  apt-get install eprints
 
  apt-get install eprints
  
=== Setting up a Repository ===
+
EPrints will now be installed at /usr/share/eprints3. However, you will not yet have a running archive.  Follow the [[Getting Started with EPrints 3]] instructions to set this up.
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]]'''
 
 
<b>Read First: Known issues with the Debian/Ubuntu package can be found at [[Debian Known Issues]].</b>
 
 
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. {{EPrintsTech}}
 
  
 
== Installing EPrints 3.3.x from Source ==
 
== Installing EPrints 3.3.x from Source ==
Line 38: Line 23:
 
...
 
...
  
== Getting Started ==
+
EPrints will now be installed at /opt/eprints3.  However, you will not yet have a running archive.  Follow the [[Getting Started with EPrints 3]] instructions to set this up.
 
+
See [[Getting Started with EPrints 3]].
+
  
  

Revision as of 10:48, 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 from EPrints 3.3.x DEB

As the root user create a file at /etc/apt/sources.list.d/eprints.list and add the following line

deb http://deb.eprints.org/ stable/

Now to install EPrints and all its dependencies execute the following command, again as the root user:

apt-get update
apt-get install eprints

EPrints will now be installed at /usr/share/eprints3. However, you will not yet have a running archive. Follow the Getting Started with EPrints 3 instructions to set this up.


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.

...

EPrints will now be installed at /opt/eprints3. However, you will not yet have a running archive. Follow the Getting Started with EPrints 3 instructions to set this up.


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