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

From EPrints Documentation
Redirect page
Jump to: navigation, search
 
 
(12 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Installation}}
+
#REDIRECT [[Installing Eprints 3 on Fedora Core 12]]
 
+
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
+
 
+
==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
+
 
+
==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==
+
 
+
Include the Eprints configuration in Apache's config:
+
 
+
root> echo "Include /opt/eprints3/cfg/apache.conf" > /etc/httpd/conf.d/eprints3.conf
+
 
+
Also check if SELinux is either Permissive or Disabled:
+
 
+
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> chkconfig --add epindexer
+
 
+
Make the indexer start automatically when the machine is rebooted:
+
 
+
root> chkconfig epindexer on
+
 
+
Start the indexer:
+
 
+
root> service epindexer start
+
 
+
==Setup MySQL==
+
 
+
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:
+
 
+
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
+

Latest revision as of 15:56, 29 April 2010