Installing Eprints 3 on Fedora Core 12

Download EPrints Releases: http://files.eprints.org/view/type/release.html

---

Please add bugs and comments at the end of this page.

Install Fedora Core

When setting up prior to install, select Web Server and Software Development. Also select Customize now and on the next screen click on Servers and MYSQL Database, then click the Optional Packages button and tick everything.

On the first boot, when setting up the computer, set the Firewall and SELinux to Disabled.

Install Required Packages

Use yum to install the TeX system and ImageMagick if you want LaTeX equation rendering:

root> yum install tetex-latex ImageMagick

.. the antiword Word document libraries (see note below):

root> yum install antiword

.. and xpdf:

root> yum install xpdf

antiword and pdftotext (from xpdf) are used by EPrints for full text indexing. (Antiword from 3.3. onwards is only used for the Word -> PDF converter to so not strictly necessary)

Install Required Perl Modules

The majority of perl modules needed by EPrints are already installed.

Install MIME::Lite, XML::LibXML, and XML::Parser

root> yum install perl-MIME-Lite perl-XML-LibXML perl-XML-Parser

Install Term::ReadKey with CPAN (if this is the first time you've run CPAN you will be asked to configure it):

root> cpan Term::ReadKey

Set up services

Make apache and mysql start automatically when the machine is rebooted:

root> /sbin/chkconfig mysqld on
root> /sbin/chkconfig httpd on

Start mysql:

root> service mysqld start

Set a root password (Eprints can set up the database for you if you have the root password):

root> mysqladmin -u root password <new password>

Also check if SELinux is either Permissive or Disabled:

root> getenforce

If getenforce gives Enforcing, then disable SELinux:

root> setenforce 0

(Comment: This is not a good solution. With FC11 it was not that hard to setup SELinux for eprints. I'll document the steps here next time I install)

Add the Eprints User and Group

Add the eprints user:

root> useradd -M -d /opt/eprints3 -s /sbin/nologin eprints

Add apache to the eprints group:

root> usermod -a -G eprints apache

Install EPrints

Download the Eprints tar.gz file

root> tar xzvf eprints3.x.x.x
root> cd eprints3.x.x.x/

Find out the name of your outgoing SMTP (email) server.

root> ./configure --with-smtp-server=smtp.yourdomain
root> ./install.pl

Add Eprints to Apache

Include the Eprints configuration in Apache's config:

root> echo "Include /opt/eprints3/cfg/apache.conf" > /etc/httpd/conf.d/eprints3.conf

Set up the indexer as a service

root> ln -s /opt/eprints3/bin/epindexer /etc/init.d/epindexer
root> chkconfig --add epindexer

Make the indexer start automatically when the machine is rebooted:

root> chkconfig epindexer on

Start the indexer:

root> service epindexer start

Configure a Repository

Change to the eprints user:

root> su -s /bin/sh eprints
eprints> cd /opt/eprints3

To start setting up a repository use epadmin:

eprints> bin/epadmin create

(Re)Start the Web Server

root> service httpd restart