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.
Contents
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