Difference between revisions of "Installing EPrints 3 on Ubuntu 6.10"

From EPrints Documentation
Jump to: navigation, search
(Further Packages)
(aptitude recommended over apt-get.)
Line 9: Line 9:
 
Install Apache and mod_perl. Some installations are coming with an apache1 or apache2 installation. Make sure that they do not interfere with your work. (The simplest solution is to remove them first.)
 
Install Apache and mod_perl. Some installations are coming with an apache1 or apache2 installation. Make sure that they do not interfere with your work. (The simplest solution is to remove them first.)
  
  $ sudo apt-get install apache2 libapache2-mod-perl2
+
  $ sudo aptitude install apache2 libapache2-mod-perl2
  
 
Ubuntu 7.04 comes with threaded apache2. '''Do not use threaded version''', rather install the pre-fork one, see the [http://www.eprints.org/tech.php/6940.html Tech list 6940] article
 
Ubuntu 7.04 comes with threaded apache2. '''Do not use threaded version''', rather install the pre-fork one, see the [http://www.eprints.org/tech.php/6940.html Tech list 6940] article
  
  U7.04$ sudo apt-get install apach2-mpm-prefork libapache2-mod-perl2
+
  U7.04$ sudo aptitude install apach2-mpm-prefork libapache2-mod-perl2
  
 
Install MySQL:
 
Install MySQL:
  
  $ sudo apt-get install mysql-server
+
  $ sudo aptitude install mysql-server
  
 
Install EPrints perl dependencies:
 
Install EPrints perl dependencies:
  
  $ sudo apt-get install libxml-libxml-perl libunicode-string-perl \
+
  $ sudo aptitude install libxml-libxml-perl libunicode-string-perl \
 
   libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl libxml-parser-perl.
 
   libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl libxml-parser-perl.
  
 
In Ubuntu 7.05 the package libxml-libxml-perl is not complete, thus you need to install it from cpan. It requires two extra packages as well:
 
In Ubuntu 7.05 the package libxml-libxml-perl is not complete, thus you need to install it from cpan. It requires two extra packages as well:
  
  U7.04$ sudo apt-get install libxml2-dev gcc
+
  U7.04$ sudo aptitude install libxml2-dev gcc
 
  U7.04$ sudo cpan XML::LibXML
 
  U7.04$ sudo cpan XML::LibXML
  
Line 41: Line 41:
 
Auxiliary programs (they might be needed before running cpan):
 
Auxiliary programs (they might be needed before running cpan):
  
  $ sudo apt-get install gzip tar unzip make lynx wget ncftp ftp
+
  $ sudo aptitude install gzip tar unzip make lynx wget ncftp ftp
  
 
Programs for extracting content:
 
Programs for extracting content:
  
  $ sudo apt-get install gs xpdf xv antiword elinks
+
  $ sudo aptitude install gs xpdf xv antiword elinks
  
 
Programs making pictures, formulas, etc.
 
Programs making pictures, formulas, etc.
  
  $ sudo apt-get install pdftk tetex-bin psutils imagemagick
+
  $ sudo aptitude install pdftk tetex-bin psutils imagemagick
  
 
== Configuring MySQL ==
 
== Configuring MySQL ==

Revision as of 12:14, 8 August 2007

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


Setting up Ubuntu

This instructions assume a working Ubuntu 6.10 ("Edgy Eft") installation (or close approximation thereof). Some further remarks are added for installation on Ubuntu 7.04 (on 27 June 2007).

Install EPrints Dependencies

Install Apache and mod_perl. Some installations are coming with an apache1 or apache2 installation. Make sure that they do not interfere with your work. (The simplest solution is to remove them first.)

$ sudo aptitude install apache2 libapache2-mod-perl2

Ubuntu 7.04 comes with threaded apache2. Do not use threaded version, rather install the pre-fork one, see the Tech list 6940 article

U7.04$ sudo aptitude install apach2-mpm-prefork libapache2-mod-perl2

Install MySQL:

$ sudo aptitude install mysql-server

Install EPrints perl dependencies:

$ sudo aptitude install libxml-libxml-perl libunicode-string-perl \
  libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl libxml-parser-perl.

In Ubuntu 7.05 the package libxml-libxml-perl is not complete, thus you need to install it from cpan. It requires two extra packages as well:

U7.04$ sudo aptitude install libxml2-dev gcc
U7.04$ sudo cpan XML::LibXML

Install Readonly (you will need to configure CPAN if not already done):

$ sudo cpan install Readonly

If XML::GDOME should be used instead of XML::DOM, you could try if the unofficial Debian package works for you.

Further Packages

You need further packages for the seamless work of Eprints; these might or might not be installed on the system:

Auxiliary programs (they might be needed before running cpan):

$ sudo aptitude install gzip tar unzip make lynx wget ncftp ftp

Programs for extracting content:

$ sudo aptitude install gs xpdf xv antiword elinks

Programs making pictures, formulas, etc.

$ sudo aptitude install pdftk tetex-bin psutils imagemagick

Configuring MySQL

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

$ mysqladmin -u root password <new password>

Create an 'eprints' system user

$ sudo adduser --system --home /opt/eprints3 --group eprints 

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

$ sudo adduser www-data eprints

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

The Ubuntu 7.04 kernel does not support the syscalls Eprints uses for determining the free disk size. Thus you must disable df as well:

U7.04$ ./configure --with-smtp-server=smtp.yourdomain --disable-diskfree

Set up Apache2

Add this line to /etc/apache2/sites-available/eprints

Include /opt/eprints3/cfg/apache.conf

and enable the site

$ sudo a2ensite eprints

(this leaves /etc/apache2/apache.conf untouched, making future Apache upgrades easier)

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.

Restarting Apache

$ sudo /etc/init.d/apache2 force-reload