Difference between revisions of "Quickstart:System Setup"
(→Manager Users) |
|||
| (9 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Quickstart]] | [[Category:Quickstart]] | ||
== Operating System == | == Operating System == | ||
| − | This guide will assume you are using a Red Hat Linux OS ( | + | This guide will assume you are using a Red Hat Linux OS (we used Rocky Linux 9), see our [[Recommended_Platforms | recommended platforms]] for other options. |
== Other Tools == | == Other Tools == | ||
| Line 24: | Line 24: | ||
** CentOS / Rocky Linux: | ** CentOS / Rocky Linux: | ||
**: <code>dnf install mariadb-server mariadb mariadb-devel<br/> systemctl enable --now mariadb</code> | **: <code>dnf install mariadb-server mariadb mariadb-devel<br/> systemctl enable --now mariadb</code> | ||
| − | |||
| − | |||
| − | |||
| − | |||
=== Further Dependencies === | === Further Dependencies === | ||
| − | The following RPMs need to be installed using the dnf command: | + | <p>The following RPMs need to be installed using the dnf command:</p> |
| + | <code>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 </code><br/> | ||
| − | + | <i>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).</i> | |
| − | + | ||
| − | + | == Manager Users == | |
| − | + | <p>'''As root''', from a command prompt add the <tt>eprints</tt> user:</p> | |
| − | + | <code>adduser eprints</code> | |
| − | + | ||
| + | <p>Add the <tt>eprints</tt> user to the <tt>apache</tt> group and vice-versa.</p> | ||
| + | usermod -aG apache eprints | ||
| + | usermod -aG eprints apache | ||
| + | |||
| + | <p>Finally, restart Apache:</p> | ||
| + | service httpd restart | ||
== Next Steps == | == Next Steps == | ||
You are now ready to install the EPrints system! Go to the [[Quickstart:Install EPrints | next page of this guide]] to find out how. | You are now ready to install the EPrints system! Go to the [[Quickstart:Install EPrints | next page of this guide]] to find out how. | ||
Latest revision as of 11:49, 7 October 2026
Contents
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
- RHEL
- 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
- RHEL / Fedora:
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).
Manager Users
As root, from a command prompt add the eprints user:
adduser eprints
Add the eprints user to the apache group and vice-versa.
usermod -aG apache eprints usermod -aG eprints apache
Finally, restart Apache:
service httpd restart
Next Steps
You are now ready to install the EPrints system! Go to the next page of this guide to find out how.
