Editing EPrints 3.5.0 Release Candidate 1 (section)

== Installation Instructions ==
=== Red Hat Enterprise Linux / Rocky Linux 9 ===
1. Install and enable MariaDB (you may choose to install MySQL instead).
 yum install mariadb-server mariadb
 systemctl enable --now mariadb
2. Install The EPEL package repository and the subscription-manager and then enable the Code Ready Builder package repository 
 yum install epel-release
 yum config-manager --enable crb 
3. Install prerequite packages and tools. (Some extra packages may be required to build CPAN packages later on). 
 yum install git libxml2 libxslt httpd mod_perl mod_ssl openssl-devel perl-DBD-MySQL tetex-latex wget gzip tar ImageMagick elinks poppler-utils chkconfig unzip cpan python3-html2text expat-devel libxslt-devel
 yum install ffmpeg-free # if you need to process videos
4. Add the eprints user
 adduser eprints
5. Add the eprints user to the apache group and vice-versa
 usermod -a -G eprints apache
 usermod -a -G apache eprints
6. For now disable SELinux.  (If you want to make this permanent you will need to configure /etc/selinux/config and change SELINUX=permissive).  An SELinux policy for EPrints  will be provided with the full release of EPrints 3.5.0.
 setenforce 0
7. Make a directory to checkout EPrints and set appropriate permissions:
 mkdir /opt/eprints3
 chown eprints:eprints /opt/eprints3
 chmod 2775 /opt/eprints3
8. Become the eprints user and clone EPrints 3.5 recursively and checkout v3.5.0-rc1
 su eprints
 cd /opt/eprints3
 git clone https://github.com/eprints/eprints3.5.git --recurse-submodules .

 # if you wish to use changes since RC1, skip this line
 git checkout v3.5.0-rc1
9. Become the root user again and install CPAN modules. (Answer 'y' if prompted whilst running cpan_modules.pl). This could take 10 minutes or more to complete but ensures you get modules tested against this version of EPrints.  It is worth running cpan_modules.pl a second time after it completes, to get a better idea if all CPAN modules have been installed successfully.
 su root
 /opt/eprints3/cpan_modules.pl
10. Be sure to either set a password for the MariaDB root user or create another user (e.g. eprints) that can create new databases and add new MariaDB users
 mysql
 CREATE USER 'eprints'@'localhost' IDENTIFIED by '<CHANGE_ME>';
 GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;
11. Become the eprints user again and create your new EPrints archive using the 'pub' flavour and then follow the interactive instructions.
 su eprints
 /opt/eprints3/bin/epadmin create
12. Become the root user and create an Apache configuration file at /etc/httpd/conf.d/eprints.conf with the following line:
 Include /opt/eprints3/cfg/apache.conf
13. For now, disable /etc/httpd/conf.d/ssl.conf
 mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.disabled
14. Test and start Apache..
 apachectl configtest
 systemctl enable --now httpd
15. Start EPrints indexer.  This can be done either via the '''System Tools''' tab on the Admin page in the web interface or with the following command:
 /opt/eprints3/bin/indexer start

==== Things to try next ====
Set up HTTPS using LetsEncrypt certificates
As the eprints user
  /opt/eprints3/bin/generate_le_cert <REPO> --verbose
As the root user
  Add "Include /opt/eprints3/archives/REPO/ssl/securevhost.conf" to /etc/httpd/conf.d/eprints.conf
  mv /etc/httpd/conf.d/ssl.conf.disabled /etc/httpd/conf.d/ssl.conf
  apachectl restart

Use the new rich text easy pages instead of the standard xpage ones.
As the eprints user
  /opt/eprints3/ingredients/easy_pages/bin/create_standard_pages <REPO>
These can be edited via "Manage records" -> "Page".
Or a new page can be create via "Admin" -> "Config Tools" -> "Create a Page".

=== Ubuntu 24.04 / Debian 13 (Trixie) ===
'''N.B.''' Ubuntu 26.04 LTS is not yet supported due to issue with libxml2.

'''To be written'''