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

From EPrints Documentation
Jump to: navigation, search
 
Line 11: Line 11:
 
On the first boot, when setting up the computer, set the Firewall and SELinux to ''Disabled''.
 
On the first boot, when setting up the computer, set the Firewall and SELinux to ''Disabled''.
  
==Install Required Packages==
+
===Install Required Packages===
  
 
Use yum to install the Gnome DOM libraries:
 
Use yum to install the Gnome DOM libraries:
Line 27: Line 27:
 
antiword and pdftotext (from xpdf) are used by EPrints for full text indexing.
 
antiword and pdftotext (from xpdf) are used by EPrints for full text indexing.
  
==Install Required Perl Modules==
+
===Install Required Perl Modules===
  
 
The majority of perl modules needed by EPrints are already installed.
 
The majority of perl modules needed by EPrints are already installed.
Line 52: Line 52:
 
  root> make install
 
  root> make install
  
==Add the Eprints User and Group==
+
===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
 +
 
 +
===Add the Eprints User and Group===
  
 
Add the eprints user:
 
Add the eprints user:
Line 61: Line 84:
  
 
  root> usermod -a -G eprints apache
 
  root> usermod -a -G eprints apache
 
==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==
 
==Install EPrints==
Line 81: Line 97:
 
  root> ./install.pl
 
  root> ./install.pl
  
==Set up apache==
+
===Add Eprints to Apache===
  
 
Include the Eprints configuration in Apache's config:
 
Include the Eprints configuration in Apache's config:
Line 87: Line 103:
 
  root> echo "Include /opt/eprints3/cfg/apache.conf" > /etc/httpd/conf.d/eprints3.conf
 
  root> echo "Include /opt/eprints3/cfg/apache.conf" > /etc/httpd/conf.d/eprints3.conf
  
Also check if SELinux is either Permissive or Disabled:
+
===Set up the indexer as a service===
 
+
root> getenforce
+
 
+
If getenforce gives Enforcing, then disable SELinux:
+
 
+
root> setenforce 0
+
 
+
==Set up the indexer as a service==
+
  
 
  root> ln -s /opt/eprints3/bin/epindexer /etc/init.d/epindexer
 
  root> ln -s /opt/eprints3/bin/epindexer /etc/init.d/epindexer
Line 108: Line 116:
 
  root> service epindexer start
 
  root> service epindexer start
  
==Setup MySQL==
+
===Configure a Repository===
 
+
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>
+
 
+
==Configure a Repository==
+
  
 
Change to the eprints user:
 
Change to the eprints user:

Revision as of 12:01, 26 February 2007

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


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

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

Install Fedora Core 6

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 Gnome DOM libraries:

root> yum install gdome2 gdome2-devel

.. the antiword Word document libraries:

root> yum install antiword

.. and xpdf:

root> yum install xpdf

antiword and pdftotext (from xpdf) are used by EPrints for full text indexing.

Install Required Perl Modules

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

Install Unicode::String and MIME::Lite:

root> yum install perl-Unicode-String perl-MIME-Lite

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

Install XML::LibXML (will pull in XML dependencies)

root> cpan XML::LibXML

Install XML::GDOME from source:

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

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

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