Installing EPrints on RHEL/Fedora/CentOS - Revision history

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

2025-10-03T10:01:35Z

Updated to 3.4.7

← Older revision		Revision as of 10:01, 3 October 2025
Line 34:		Line 34:
	'''N.B.''' If you are running RHEL / CentOS / Rocky Linux 10, '''perl-Apache-DBI''' is no longer available and will need to be installed with CPAN and '''python3-html2text''' will not be available until RHEL / CentOS / Rocky Linux 10.1. You should exclude these when running the dnf command above. (See [[#RHEL_.2F_CentOS_.2F_Rocky_10\|Operating System Version Specific Requirements for RHEL / CentOS / Rocky Linux 10]] below for more details).		'''N.B.''' If you are running RHEL / CentOS / Rocky Linux 10, '''perl-Apache-DBI''' is no longer available and will need to be installed with CPAN and '''python3-html2text''' will not be available until RHEL / CentOS / Rocky Linux 10.1. You should exclude these when running the dnf command above. (See [[#RHEL_.2F_CentOS_.2F_Rocky_10\|Operating System Version Specific Requirements for RHEL / CentOS / Rocky Linux 10]] below for more details).

	== Installing EPrints 3.4.6 from Source ==		== Installing EPrints 3.4.7 from Source ==
	'''Ideally you will install from source from [https://github.com/eprints/eprints3.4 EPrints Core Git repository], which includes the core codebase and the publications flavour. However, you may choose to download tarballs of the EPrints core codebase and publications flavour from files.eprints.org as an alternative means of installation.		'''Ideally you will install from source from [https://github.com/eprints/eprints3.4 EPrints Core Git repository], which includes the core codebase and the publications flavour. However, you may choose to download tarballs of the EPrints core codebase and publications flavour from files.eprints.org as an alternative means of installation.

Line 47:		Line 47:
	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

	=== From files.eprints.org ===		=== From files.eprints.org ===
	Download and unpack the core codebase tarball for files.eprints.org.		Download and unpack the core codebase tarball for 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 move in the source code into place:		Then move in the source code into 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

	If you want a publications flavoured repository, then you will also need to download, unpack and move that into the appropriate location:		If you want a publications flavoured repository, then you will also need to download, unpack and move that into the appropriate location:
	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 */

2025-08-04T15:34:09Z

Requirements

← Older revision		Revision as of 15:34, 4 August 2025
Line 2:		Line 2:

	== Requirements ==		== Requirements ==
	* Red Hat Enterprise (RHEL) / CentOS / Rocky Linux 8 or 9. (EPrints can be installed on RHEL / CentOS / Rocky Linux 10 but there are currently a number of issues, some which should be resolved in later version of these Linux OSs).		* Red Hat Enterprise (RHEL) / CentOS / Rocky Linux 8 or 9. (EPrints can be installed on RHEL / CentOS / Rocky Linux 10 but there are currently a [[#RHEL / CentOS / Rocky 10\|number of issues]], some which should be resolved in later version of these Linux OSs).

	== Prerequisites ==		== Prerequisites ==

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

2025-08-04T15:33:31Z

Requirements

← Older revision		Revision as of 15:33, 4 August 2025
Line 2:		Line 2:

	== Requirements ==		== Requirements ==
	* Red Hat Enterprise (RHEL) / CentOS / Rocky Linux 8 or 9		* Red Hat Enterprise (RHEL) / CentOS / Rocky Linux 8 or 9. (EPrints can be installed on RHEL / CentOS / Rocky Linux 10 but there are currently a number of issues, some which should be resolved in later version of these Linux OSs).

	== Prerequisites ==		== Prerequisites ==

Drn@ecs.soton.ac.uk: /* Configuration */ SystemSettings.pm is omnipresent in 3.4.x

2025-08-04T15:17:37Z

Configuration: SystemSettings.pm is omnipresent in 3.4.x

← Older revision		Revision as of 15:17, 4 August 2025
Line 68:		Line 68:

	== Configuration ==		== Configuration ==
	~~As the <tt>eprints</tt> user copy /opt/eprints3/perl_lib/EPrints/SystemSettings.pm.tmpl to /opt/eprints3/perl_lib/EPrints/SystemSettings.pm~~

	<span id="getting_started_and_apache">EPrints</span> is now fully installed at <tt>/opt/eprints3</tt>. However, you will not yet have a running archive. Follow the [[Getting Started with EPrints 3]] instructions to set this up.		<span id="getting_started_and_apache">EPrints</span> is now fully installed at <tt>/opt/eprints3</tt>. 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: /* Post-configuration */

2025-08-04T15:14:24Z

Post-configuration

← Older revision		Revision as of 15:14, 4 August 2025
Line 73:		Line 73:

	== Post-configuration ==		== Post-configuration ==
	~~Now update Apache configuration to set it up to use the eprints user and group, by ensuring the following lines are set thus in '''/etc/httpd/conf/httpd.conf''':~~		Add the <tt>eprints</tt> user to the <tt>apache</tt> group and vice-versa.
	~~User eprints~~
	~~Group eprints~~
	~~Now add the file '''/etc/httpd/conf.d/eprints.conf''' with the following line:~~
	~~Include /opt/eprints3/cfg/apache.conf~~

	~~Alternatively, you could add~~ the <tt>eprints</tt> user to the <tt>apache</tt> group and vice-versa ~~and then leave ''/etc/httpd/conf/httpd~~.~~conf'' unchanged:~~
	usermod -aG apache eprints		usermod -aG apache eprints
	usermod -aG eprints apache		usermod -aG eprints apache

Drn@ecs.soton.ac.uk: /* Post-configuration */

2025-08-04T15:13:37Z

Post-configuration

← Older revision		Revision as of 15:13, 4 August 2025
Line 73:		Line 73:

	== Post-configuration ==		== Post-configuration ==
	Now update Apache configuration to set it up to use the eprints user and group, by ensuring the following lines are set thus in /etc/httpd/conf/httpd.conf:		Now update Apache configuration to set it up to use the eprints user and group, by ensuring the following lines are set thus in '''/etc/httpd/conf/httpd.conf''':
	User eprints		User eprints
	Group eprints		Group eprints
	Now add the file /etc/httpd/conf.d/eprints.conf with the following line:		Now add the file '''/etc/httpd/conf.d/eprints.conf''' with the following line:
	Include /opt/eprints3/cfg/apache.conf		Include /opt/eprints3/cfg/apache.conf

			Alternatively, you could add the <tt>eprints</tt> user to the <tt>apache</tt> group and vice-versa and then leave ''/etc/httpd/conf/httpd.conf'' unchanged:
			usermod -aG apache eprints
			usermod -aG eprints apache

	Finally, restart Apache:		Finally, restart Apache:

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

2025-08-04T15:04:42Z

SELinux

← Older revision		Revision as of 15:04, 4 August 2025
Line 83:		Line 83:

	=== SELinux ===		=== SELinux ===
	There is a fair chance your operating system will have SELinux enabled. If so, follow the advice at [[SELinux ~~with EPrints~~]] for how to let EPrints do what it needs to do through SELinux. Otherwise, you could disable SELinux with the following:		There is a fair chance your operating system will have SELinux enabled. If so, follow the advice at [[EPrints and SELinux]] for how to let EPrints do what it needs to do through SELinux. Otherwise, you could disable SELinux with the following:
	setenforce 0		setenforce 0
	However, that will only disable it until the next reboot. You should also edit '''/etc/selinux/config''' and make sure the <code>SELINUX=enforcing</code> is set to:		However, that will only disable it until the next reboot. You should also edit '''/etc/selinux/config''' and make sure the <code>SELINUX=enforcing</code> is set to:

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

2025-08-04T15:04:00Z

SELinux

← Older revision		Revision as of 15:04, 4 August 2025
Line 83:		Line 83:

	=== SELinux ===		=== SELinux ===
	There is a fair chance your operating system will have SELinux enabled. If so, follow the ~~instructions under~~ [[~~#Troubleshooting\|Troubleshooting~~]] for how to let EPrints do what it needs to do through SELinux. Otherwise, you could disable SELinux with the following:		There is a fair chance your operating system will have SELinux enabled. If so, follow the advice at [[SELinux with EPrints]] for how to let EPrints do what it needs to do through SELinux. Otherwise, you could disable SELinux with the following:
	setenforce 0		setenforce 0
	However, that will only disable it until the next reboot. You should also edit '''/etc/selinux/config''' and make sure the <code>SELINUX=enforcing</code> is set to:		However, that will only disable it until the next reboot. You should also edit '''/etc/selinux/config''' and make sure the <code>SELINUX=enforcing</code> is set to:

Drn@ecs.soton.ac.uk: /* SELinux */ Added more SELinux advide

2025-08-04T15:02:40Z

SELinux: Added more SELinux advide

← Older revision		Revision as of 15:02, 4 August 2025
Line 83:		Line 83:

	=== SELinux ===		=== SELinux ===
	There is a fair chance your operating system will have SELinux enabled. If so, follow the instructions under [[#Troubleshooting\|Troubleshooting]] for how to let EPrints do what it needs to do through SELinux.		There is a fair chance your operating system will have SELinux enabled. If so, follow the instructions under [[#Troubleshooting\|Troubleshooting]] for how to let EPrints do what it needs to do through SELinux. Otherwise, you could disable SELinux with the following:
			setenforce 0
			However, that will only disable it until the next reboot. You should also edit '''/etc/selinux/config''' and make sure the <code>SELINUX=enforcing</code> is set to:
			SELINUX=disabled

	== Non-critical Dependencies ==		== Non-critical Dependencies ==

Drn@ecs.soton.ac.uk: /* Post-configuration */

2025-08-04T14:58:40Z

Post-configuration

← Older revision		Revision as of 14:58, 4 August 2025
Line 78:		Line 78:
	Now add the file /etc/httpd/conf.d/eprints.conf with the following line:		Now add the file /etc/httpd/conf.d/eprints.conf with the following line:
	Include /opt/eprints3/cfg/apache.conf		Include /opt/eprints3/cfg/apache.conf
	~~There is a good chance your operating system will have SELinux enabled. If so, follow the instructions under Troubleshooting for how to let EPrints do what it needs to do through SELinux.~~

	Finally, restart Apache:		Finally, restart Apache:
	service httpd restart		service httpd restart

			=== SELinux ===
			There is a fair chance your operating system will have SELinux enabled. If so, follow the instructions under [[#Troubleshooting\|Troubleshooting]] for how to let EPrints do what it needs to do through SELinux.

	== Non-critical Dependencies ==		== Non-critical Dependencies ==