Installing EPrints on RHEL/Fedora/CentOS - Revision history

Drn@ecs.soton.ac.uk: Added to manual

2026-01-26T09:03:52Z

Added to manual

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

2025-10-03T10:01:35Z

Updated to 3.4.7

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

2025-08-04T15:34:09Z

‎Requirements

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

2025-08-04T15:33:31Z

‎Requirements

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

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

2025-08-04T15:14:24Z

‎Post-configuration

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

2025-08-04T15:13:37Z

‎Post-configuration

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

2025-08-04T15:04:42Z

‎SELinux

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

2025-08-04T15:04:00Z

‎SELinux

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 09:03, 26 January 2026
Line 1:		Line 1:
		+	{{manual}}
	[[Category:Installation]]		[[Category:Installation]]

@@ 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).
-== 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.
@@ Line 47: / Line 47: @@
   git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
   cd /opt/eprints3/
-  git checkout tags/v3.4.6
+  git checkout tags/v3.4.7
 === From files.eprints.org ===
 Download and unpack the core codebase tarball for files.eprints.org.
   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:
-  mv eprints-3.4.6 /opt/eprints3
+  mv eprints-3.4.7 /opt/eprints3
   chmod 2775 /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:
-  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
   chown -R eprints:eprints /opt/eprints3/flavours/pub_lib

@@ Line 2: / Line 2: @@
 == 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 ==

@@ Line 2: / Line 2: @@
 == 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 ==

← 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.

@@ Line 73: / Line 73: @@
 == 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.
   usermod -aG apache eprints
   usermod -aG eprints apache

@@ Line 73: / Line 73: @@
 == 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
   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
 Finally, restart Apache:

@@ Line 83: / Line 83: @@
 === 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
 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:

@@ Line 83: / Line 83: @@
 === 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:
 == Non-critical Dependencies ==