Quickstart:System Setup

Operating System

This guide will assume you are using a Red Hat Linux OS (we used Rocky Linux 9), see our recommended platforms for other options.

Other Tools

EPrints requires Apache (with mod_perl), MySQL and Perl with some extra modules. Various utilities like wget, tar and unzip would also be useful. See our required software page for more details on where to find these tools if you are missing them.

Dependencies

Before we can install the EPrints system, we should install a few packages it relies on.

• Pre-install and enable the EPEL DNF repository.

  • dnf install epel-release

• Pre-install and enable the CodeReady Builder DNF repository.
  • RHEL

    subscription-manager repos --enable "codeready-builder-for-rhel-$(releasever)-$(arch)-rpms"

  • CentOS Stream / Rocky Linux 8

    dnf config-manager --set-enabled powertools

  • CentOS Stream / Rocky Linux 9 and 10

    dnf config-manager --set-enabled crb

• Pre-install MySQL server and client and make sure the former is enabled and running.
  • RHEL / Fedora:

    dnf install mysql-server mysql mysql-devel
 systemctl enable --now mysqld

  • CentOS / Rocky Linux:

    dnf install mariadb-server mariadb mariadb-devel
 systemctl enable --now mariadb

• As root, from a command prompt add the eprints user:

  • adduser eprints

Further 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
Note: 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 Operating System Version Specific Requirements for RHEL / CentOS / Rocky Linux 10 below for more details).

Next Steps

You are now ready to install the EPrints system! Go to the next page of this guide to find out how.