Jump to content
Wiki Home
EPrints Home
Bazaar
Files
Main menu
Main menu
move to sidebar
hide
Navigation
Front Page
EPrints 3 Manual
EPrints Training Course
EPrints Glossary
Installing EPrints
How-to Configure EPrints
EPrints 3.2+ API
EPrints 3 Reference
EPrints Plugins
Wiki
All categories
Recent changes
Main Page
Help
EPrints Documentation
Search
Search
Appearance
Log in
Request account
Personal tools
Log in
Request account
Pages for logged out editors
learn more
Contributions
Talk
Editing
Installing EPrints on RHEL/Fedora/CentOS
Page
Discussion
British English
Read
Edit
View history
Tools
Tools
move to sidebar
hide
Actions
Read
Edit
View history
General
What links here
Related changes
Special pages
Page information
Appearance
move to sidebar
hide
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
{{manual}} [[Category:Installation]] == 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 [[#RHEL / CentOS / Rocky 10|number of issues]], some which should be resolved in later version of these Linux OSs). == Prerequisites == * Pre-install and enable the EPEL DNF repository. **: <code>dnf install epel-release</code> * Pre-install and enable the CodeReady Builder DNF repository. ** RHEL **: <code>subscription-manager repos --enable "codeready-builder-for-rhel-$(releasever)-$(arch)-rpms"</code> ** CentOS Stream / Rocky Linux 8 **: <code>dnf config-manager --set-enabled powertools</code> ** CentOS Stream / Rocky Linux 9 and 10 **: <code>dnf config-manager --set-enabled crb</code> * Pre-install MySQL server and client and make sure the former is enabled and running. ** RHEL / Fedora: **: <code>dnf install mysql-server mysql mysql-devel<br/> systemctl enable --now mysqld</code> ** CentOS / Rocky Linux: **: <code>dnf install mariadb-server mariadb mariadb-devel<br/> systemctl enable --now mariadb</code> * From the MySQL command prompt, pre-configure an eprints user with password for MariaDB/MySQL, which can be used as the Database super user when creating the database for an archive. (Be sure to change the password from "changeme"): *: <code>CREATE USER 'eprints'@'localhost' IDENTIFIED by 'changeme';<br/> GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;</code> * As root, from a command prompt add the <tt>eprints</tt> user: *: <code>adduser eprints</code> == Dependencies == The following RPMs need to be installed using the dnf command: dnf install libxml2 libxslt httpd mod_perl perl-Apache-DBI perl-DBI perl-DBD-MySQL perl-IO-Socket-SSL \ perl-Time-HiRes perl-CGI perl-Digest-MD5 perl-Digest-SHA perl-Digest-SHA1 perl-JSON perl-XML-LibXML \ perl-XML-LibXSLT perl-XML-SAX perl-MIME-Lite perl-Text-Unidecode perl-JSON perl-Unicode-Collate \ perl-LWP-Protocol-https perl-IO-String tetex-latex wget gzip tar ImageMagick poppler-utils \ chkconfig unzip cpan python3-html2text expat-devel libxslt-devel '''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.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. == Downloading and Deploying EPrints Source == === Create initial directory with correct permissions === As root: mkdir /opt/eprints3 chown eprints:eprints /opt/eprints3 chmod 2775 /opt/eprints3 === Cloning from Git === Clone the Git repository from GitHub to <tt>/opt/</tt> and set the <tt>eprints</tt> user as the owner. It is probably best to checkout the latest release rather than using HEAD, which may have known issues: dnf install git su eprints git clone https://github.com/eprints/eprints3.4.git /opt/eprints3 cd /opt/eprints3/ git checkout tags/v3.4.7 == Configuration == <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. == Post-configuration == Add the <tt>eprints</tt> user to the <tt>apache</tt> group and vice-versa. usermod -aG apache eprints usermod -aG eprints apache Finally, restart Apache: service httpd restart === SELinux === 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: SELINUX=disabled == Non-critical Dependencies == Some of EPrints non-core functionality may not work out of the box as these dependencies are not included as part of the installation process. Here is a list of known additional packages (and the DNF repositories in which they can be found) or CPAN modules than can be installed. The latter should be installed using the ''cpan'' command as the root user. * '''perl-Geo-IP (epel)''' - Allows IRstats2 to determine the location of views/downloads for publications. (RHEL/CentOS/Rocky Linux 8 only) * '''perl-GeoIP2 (@System and epel)''' - Allows IRstats2 to determine the location of views/downloads for publications. (RHEL/CentOS/Rocky Linux 9+) * '''perl-Spreadsheet-WriteExcel (epel)''' - To allow Multiline Excel export. * '''CPAN module Text::Refer''' - Required for EndNote import. * '''CPAN module TeX::Encode''' - Required for BibTex export needed for publications flavour. * '''perl-Image-ExifTool (epel)''' - Sometimes needed to support generation of thumbnails for uploaded documents/images. * '''perl-LWP-Protocol-https (base)''' - Needed by DataCite plugin to register repository DOIs. == Operating System Version Specific Requirements == === RHEL / CentOS / Rocky 8 === {{:Issues with installing EPrints on RHEL / CentOS / Rocky 8}} === RHEL / CentOS / Rocky 9 === {{:Issues with installing EPrints on RHEL / CentOS / Rocky 9}} === RHEL / CentOS / Rocky 10 === {{:Issues with installing EPrints on RHEL / CentOS / Rocky 10}} == Troubleshooting == * If setup is successful but then you cannot access EPrints through your web browser this is often due to firewalld being enabled by default on recent versions of RHEL, Fedora and CentOS. If firewalld is running either disable it (<tt>systemctl disable --now firewalld</tt>) or [https://docs.rackspace.com/support/how-to/allow-web-traffic-in-a-firewalld-software-firewall/ configure it to allow HTTP/HTTPS traffic]. * If you are running a version of EPrints below 3.4.6 you cannot run Apache in MPM event mode and you need to use MPM prefork instead. This is due to Perl's <tt>XML::LibXSLT</tt> being initiated at the wrong time leading earlier version of EPrints to cause Apache (httpd) to segfault when started. If you are running an earlier version and want to run Apache in MPM event mode, you can uninstall <tt>XML::LibXSLT</tt> either as the RPM perl-XML-LibXSLT or possible from CPAN using <code>cpanm --uninstall XML::LibXSLT</code>. * If you are having problems uploading files or similar functional issues, this may be due to SELinux being enabled. [[EPrints and SELinux|See advice for enabling SELinux with EPrints]]. * If you are having trouble getting additional subdomains beyond username.eprints-hosting.org working, then it could be you need wildcards enabled on the DNS records to facilitate the likes of somethingcoolhere.username.eprints-hosting.org urls.
Summary:
Please note that all contributions to EPrints Documentation may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see
EPrints Documentation:Copyrights
for details).
Do not submit copyrighted work without permission!
Cancel
Editing help
(opens in new window)
Templates used on this page:
Issues with installing EPrints on RHEL / CentOS / Rocky 10
(
edit
)
Issues with installing EPrints on RHEL / CentOS / Rocky 8
(
edit
)
Issues with installing EPrints on RHEL / CentOS / Rocky 9
(
edit
)
Template:Box
(
edit
)
Template:Manual
(
edit
)