Installing EPrints on Debian/Ubuntu - Revision history

Drn@ecs.soton.ac.uk: Updated to 3.4.7

2025-10-03T10:00:17Z

Updated to 3.4.7

← Older revision		Revision as of 10:00, 3 October 2025
Line 48:		Line 48:
	git clone https://github.com/eprints/eprints3.4.git /opt/eprints3		git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
	cd /opt/eprints3/		cd /opt/eprints3/
	git checkout tags/v3.4.6		git checkout tags/v3.4.7

	==== EPrints 3.4.x from files.eprints.org ====		==== EPrints 3.4.x from files.eprints.org ====

	cd /tmp/		cd /tmp/
	wget https://files.eprints.org/~~3097~~/5/eprints-3.4.6.tar.gz		wget https://files.eprints.org/3288/1/eprints-3.4.7.tar.gz
	tar -xzvf eprints-3.4.6.tar.gz		tar -xzvf eprints-3.4.7.tar.gz

	Then put in the source code in place:		Then put in the source code in place:

	mv eprints-3.4.6 /opt/eprints3		mv eprints-3.4.7 /opt/eprints3
	chmod 2775 /opt/eprints3		chmod 2775 /opt/eprints3
	chown -R eprints:eprints /opt/eprints3		chown -R eprints:eprints /opt/eprints3
Line 64:		Line 64:
	If you want a publications flavoured repository, then also:		If you want a publications flavoured repository, then also:

	wget https://files.eprints.org/~~3097~~/6/eprints-3.4.6-flavours.tar.gz		wget https://files.eprints.org/3288/2/eprints-3.4.7-flavours.tar.gz
	tar -xzvf eprints-3.4.6-flavours.tar.gz		tar -xzvf eprints-3.4.7-flavours.tar.gz
	mv eprints-3.4.6/flavours/pub_lib /opt/eprints3/flavours		mv eprints-3.4.7/flavours/pub_lib /opt/eprints3/flavours
	chmod -R g+w /opt/eprints3/flavours/pub_lib		chmod -R g+w /opt/eprints3/flavours/pub_lib
	chown -R eprints:eprints /opt/eprints3/flavours/pub_lib		chown -R eprints:eprints /opt/eprints3/flavours/pub_lib

Drn@ecs.soton.ac.uk: /* Requirements */ user adduser rather than useradd

2025-08-29T11:06:23Z

Requirements: user adduser rather than useradd

← Older revision		Revision as of 11:06, 29 August 2025
Line 30:		Line 30:
	Next, create the eprints user		Next, create the eprints user

	~~useradd~~ eprints		adduser eprints

	Now add the eprints user to the www-data group and vice-versa		Now add the eprints user to the www-data group and vice-versa

Drn@ecs.soton.ac.uk: /* Requirements */ use apt rather than old apt-get

2025-08-29T11:00:33Z

Requirements: use apt rather than old apt-get

← Older revision		Revision as of 11:00, 29 August 2025
Line 22:		Line 22:
	If you are installing on Ubuntu, install MySQL server and client:		If you are installing on Ubuntu, install MySQL server and client:

	apt~~-get~~ install mysql-server mysql-client libmysqlclient-dev		apt install mysql-server mysql-client libmysqlclient-dev

	If you are installing on Debian, install MariaDB server and client:		If you are installing on Debian, install MariaDB server and client:

	apt~~-get~~ install mariadb-server mariadb-client libmariadb-dev		apt install mariadb-server mariadb-client libmariadb-dev

	Next, create the eprints user		Next, create the eprints user

Drn@ecs.soton.ac.uk: /* Operating System Version Specific Requirements */ Remove Ubuntu 20.04 issues as it is eol

2025-08-29T10:59:52Z

Operating System Version Specific Requirements: Remove Ubuntu 20.04 issues as it is eol

← Older revision		Revision as of 10:59, 29 August 2025
Line 97:		Line 97:

	== Operating System Version Specific Requirements ==		== Operating System Version Specific Requirements ==

	~~=== Ubuntu 20.04 LTS ===~~
	~~{{:Issues with Installing EPrints on Ubuntu 20.04}}~~

	=== Ubuntu 22.04 LTS ===		=== Ubuntu 22.04 LTS ===

Drn@ecs.soton.ac.uk: /* Requirements */ Remove Debian and Ubuntu versions that are eol

2025-08-29T10:59:28Z

Requirements: Remove Debian and Ubuntu versions that are eol

← Older revision		Revision as of 10:59, 29 August 2025
Line 3:		Line 3:

	== Requirements ==		== Requirements ==
	* Ubuntu ~~20.04 LTS,~~ 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)		* Ubuntu 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)
	* ~~Debian 10 (Buster),~~ Debian 11 (Bullseye) or Debian 12 (Bookworm) - These are not as comprehensively tested as Ubuntu LTS versions.		* Debian 11 (Bullseye) or Debian 12 (Bookworm) - These are not as comprehensively tested as Ubuntu LTS versions.

	=== Dependencies and Pre-configuration ===		=== Dependencies and Pre-configuration ===

Drn@ecs.soton.ac.uk: /* Requirements */

2025-08-29T10:57:21Z

Requirements

← Older revision		Revision as of 10:57, 29 August 2025
Line 13:		Line 13:
	First, as the root user install all the dependencies for EPrints ('''N.B.''' Some dependencies may not be able in certain versions of Debian/Ubuntu. See [[#Operating System Version Specific Requirements\|Operating System Version Specific Requirements]] towards the end of this page):		First, as the root user install all the dependencies for EPrints ('''N.B.''' Some dependencies may not be able in certain versions of Debian/Ubuntu. See [[#Operating System Version Specific Requirements\|Operating System Version Specific Requirements]] towards the end of this page):

	apt~~-get~~ install perl libncurses5 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \		apt install perl libncurses5 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \
	libunicode-string-perl libterm-readkey-perl libmime-lite-perl libmime-types-perl libdigest-sha-perl \		libunicode-string-perl libterm-readkey-perl libmime-lite-perl libmime-types-perl libdigest-sha-perl \
	libdbd-mysql-perl libxml-parser-perl libxml2-dev libxml-twig-perl libarchive-any-perl libjson-perl \		libdbd-mysql-perl libxml-parser-perl libxml2-dev libxml-twig-perl libarchive-any-perl libjson-perl \

Drn@ecs.soton.ac.uk: /* Installing from Debian package */ Removed section

2025-07-31T17:00:25Z

Installing from Debian package: Removed section

← Older revision		Revision as of 17:00, 31 July 2025
Line 69:		Line 69:
	chmod -R g+w /opt/eprints3/flavours/pub_lib		chmod -R g+w /opt/eprints3/flavours/pub_lib
	chown -R eprints:eprints /opt/eprints3/flavours/pub_lib		chown -R eprints:eprints /opt/eprints3/flavours/pub_lib

	~~== Installing from Debian package ==~~
	As of EPrints 3.4.5 Debian (.deb) packages will no longer be produced. Due to the complexity of the installation process there are a number of inherent problems with installing using a Deb package. As new operating systems (e.g. Debian and Ubuntu) are released the available packages have changed. This often leads to packages upon which that EPrints depends ceasing to be available. This makes it very difficult or impossible to install the Debian package, as well as requiring retrospective effort to install packages using other sources, (e.g. additional APT repositories or using CPAN). However, the main concern of installation the Debian package, particularly through EPrints' APT repository, is that it can lead to EPrints being upgraded automatically to a new version. Upgrading EPrints using a Debian package is likely to lead to EPrints producing errors, as configuration changes are often required as part of the upgrade process. Automating these changes within the Debian package would be all but impossible due to EPrints' high level of customisability.

	== Configuration ==		== Configuration ==

Drn@ecs.soton.ac.uk: /* Configuration */

2025-07-31T17:00:08Z

Configuration

← Older revision		Revision as of 17:00, 31 July 2025
Line 76:		Line 76:
	Next, as the eprints user copy <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm.tmpl</code> to <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm</code>, if it does not already exist.		Next, as the eprints user copy <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm.tmpl</code> to <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm</code>, if it does not already exist.

	<code>EPRINTS_PATH</code> ~~will~~ be ~~either~~ <code>/opt/eprints3/</code>, ~~<code>/usr/share/eprints3/</code> or <code>/usr/share/eprints</code> depending on which instructions you followed above~~.		<code>EPRINTS_PATH</code> should now always be <code>/opt/eprints3</code>. However, historically other paths have been used when EPrints was available as a Deb package.

	EPrints is now fully installed at <code>EPRINTS_PATH/</code>. However, you will not yet have a running archive. Follow the [[Getting Started with EPrints 3]] instructions to set this up.		EPrints is now fully installed at <code>EPRINTS_PATH/</code>. However, you will not yet have a running archive. Follow the [[Getting Started with EPrints 3]] instructions to set this up.

Drn@ecs.soton.ac.uk: Updated to use consistent EPrints path

2025-07-31T16:58:16Z

Updated to use consistent EPrints path

← Older revision		Revision as of 16:58, 31 July 2025
Line 5:		Line 5:
	* Ubuntu 20.04 LTS, 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)		* Ubuntu 20.04 LTS, 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)
	* Debian 10 (Buster), Debian 11 (Bullseye) or Debian 12 (Bookworm) - These are not as comprehensively tested as Ubuntu LTS versions.		* Debian 10 (Buster), Debian 11 (Bullseye) or Debian 12 (Bookworm) - These are not as comprehensively tested as Ubuntu LTS versions.

	~~== Installing EPrints from Source ==~~

	=== Dependencies and Pre-configuration ===		=== Dependencies and Pre-configuration ===
Line 60:		Line 58:
	Then put in the source code in place:		Then put in the source code in place:

	mv eprints-3.4.6 /~~usr~~/~~share/eprints~~		mv eprints-3.4.6 /opt/eprints3
	chmod 2775 /~~usr/share~~/~~eprints~~		chmod 2775 /opt/eprints3
	chown -R eprints:eprints /~~usr~~/~~share/eprints~~		chown -R eprints:eprints /opt/eprints3

	If you want a publications flavoured repository, then also:		If you want a publications flavoured repository, then also:
Line 68:		Line 66:
	wget https://files.eprints.org/3097/6/eprints-3.4.6-flavours.tar.gz		wget https://files.eprints.org/3097/6/eprints-3.4.6-flavours.tar.gz
	tar -xzvf eprints-3.4.6-flavours.tar.gz		tar -xzvf eprints-3.4.6-flavours.tar.gz
	mv eprints-3.4.6/flavours/pub_lib /~~usr~~/~~share/eprints~~/flavours		mv eprints-3.4.6/flavours/pub_lib /opt/eprints3/flavours
	chmod -R g+w /~~usr/share~~/~~eprints~~/flavours/pub_lib		chmod -R g+w /opt/eprints3/flavours/pub_lib
	chown -R eprints:eprints /~~usr~~/~~share/eprints~~/flavours/pub_lib		chown -R eprints:eprints /opt/eprints3/flavours/pub_lib

	== Installing from Debian package ==		== Installing from Debian package ==

Libjlrs: /* Configuration */

2025-04-09T19:21:17Z

Configuration

← Older revision		Revision as of 19:21, 9 April 2025
Line 78:		Line 78:
	Next, as the eprints user copy <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm.tmpl</code> to <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm</code>, if it does not already exist.		Next, as the eprints user copy <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm.tmpl</code> to <code>EPRINTS_PATH/perl_lib/EPrints/SystemSettings.pm</code>, if it does not already exist.

	<code>EPRINTS_PATH</code> will be either <code>/usr/share/eprints3/</code> or <code>/usr/share/eprints</code> depending on which instructions you followed above.		<code>EPRINTS_PATH</code> will be either <code>/opt/eprints3/</code>, <code>/usr/share/eprints3/</code> or <code>/usr/share/eprints</code> depending on which instructions you followed above.

	EPrints is now fully installed at <code>EPRINTS_PATH/</code>. However, you will not yet have a running archive. Follow the [[Getting Started with EPrints 3]] instructions to set this up.		EPrints is now fully installed at <code>EPRINTS_PATH/</code>. However, you will not yet have a running archive. Follow the [[Getting Started with EPrints 3]] instructions to set this up.