Revision as of 18:16, 13 December 2006

Setting up Ubuntu

This instructions assume a working Ubuntu 6.10 installation (or close approximation thereof).

Install EPrints Dependencies

Install Apache and mod_perl:

$ sudo apt-get install apache2 libapache-mod-perl

Install MySQL:

$ sudo apt-get install mysql-server

Install EPrints perl dependencies:

$ sudo apt-get install libxml-libxml-perl libunicode-string-perl \
  libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl

This is also needed by Beta 3 (fixed in RC1):

$ sudo cpan install File::BOM

Configuring MySQL

It is strongly recommended that you set a root password in mysql:

$ mysqladmin -u root password <new password>

Create an 'eprints' user

System * Administration * Users and Groups

Add a new user with username 'eprints' and change the Home directory (under Advanced) to '/opt/eprints3'.

Add the 'www-data' user to the 'eprints' group:

$ sudo usermod -a -G eprints www-data

Install EPrints

Download EPrints 3. Unpack and install the tarball:

$ tar xzvf eprints-3.x.y.tar.gz
$ cd eprints-3.x.y
$ ./configure --with-smtp-server smtp.yourdomain
$ sudo ./install.pl

Set up Apache

Edit the Apache configuration file:

$ sudo vi /etc/apache2/apache2.conf

And add this line to the end of apache2.conf:

Include /opt/eprints3/cfg/apache.conf

Set up the indexer as a service

$ sudo ln -s /opt/eprints3/bin/epindexer /etc/init.d/epindexer

Make the indexer start automatically when the machine is rebooted:

$ sudo update-rc.d epindexer defaults 99 99

Configure an archive

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