Difference between revisions of "Installing Eprints 3 on Fedora Core 5"

Revision as of 09:44, 23 January 2007

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

Step by step guide to getting EPrints 3 installed on Fedora Core 5.

Much of the text has been shamelessly copied from Installing on Fedora Core 4.

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

Install Fedora Core 5

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. When asked to create a System User, create one with the username eprints.

Install Required Packages

If this is the first time yum has been run, import the GPG-KEYs for the Fedora RPM repositories:

root> rpm --import /usr/share/doc/fedora-release-5/*GPG-KEY*

If your eprints server connects to the Web via a proxy, set the http_proxy environment variable:

root> export http_proxy=http://proxy.yourdomain.com:port/

Use yum to install the Gnome DOM libraries:

root> yum install gdome2 gdome2-devel

.. the wvware Word document libraries:

root> yum install wv

.. and xpdf:

root> yum install xpdf

wvText (from wv) and pdftotext (from xpdf) are used by the EPrints for full text indexing.

Install Required Perl Modules

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

Install Unicode::String using yum:

root> yum install perl-Unicode-String

Install XML::GDOME (and dependancies) from source:

root> cpan XML::LibXML
root> wget http://cpan.uwinnipeg.ca/cpan/authors/id/T/TJ/TJMATHER/XML-GDOME-0.86.tar.gz
root> tar xzvf XML-GDOME-0.86.tar.gz
root> cd XML-GDOME-0.86/
root> perl Makefile.PL
root> make
root> make install

Install Term::ReadKey and MIME::Lite with CPAN

root> cpan Term::ReadKey
root> cpan MIME::Lite

Set up services

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

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

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

Set up apache

Edit the apache config:

root> vi /etc/httpd/conf/httpd.conf

Find the lines:

User apache
Group apache

and change them to:

User eprints
Group eprints

Add this line to the end of httpd.conf:

Include /opt/eprints3/cfg/apache.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 an archive

Start mysql:

root> service mysqld start

Follow the steps in the main EPrints documentation to configure an archive.