View source for Installing EPrints 3 on Debian

{{Installation}}
[[Category:Debian and Ubuntu]]
See also: [[Installing EPrints 3 via apt (Debian/Ubuntu)]]

== Setting up Debain ==

This instructions assume a working Debian ("Edgy Eft") installation (or close approximation thereof).

== Install EPrints Dependencies ==


Install Apache and mod_perl:

 root@debian$  apt-get install apach2-mpm-prefork libapache2-mod-perl2

Install MySQL:

 root@debian$ apt-get install install mysql-server

Install perl dependencies:

 root@debian$ apt-get install libxml-libxml-perl libunicode-string-perl \
   libterm-readkey-perl libmime-lite-perl libdbd-mysql-perl libxml-parser-perl.

== Auxiliary Packages ==

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

Packages for building eprints:

 root@debian$ apt-get install gzip tar unzip make lynx wget ncftp ftp

Programs for extracting content:

 root@debian$ apt-get install gs xpdf xv antiword elinks

Programs making pictures, formulas, etc.

 root@debian$ apt-get 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 ==
 root@debain$ adduser --system --home /opt/eprints3 --group eprints 

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

 root@debain$ 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

== Set up Apache2 ==

Add this line to <tt>/etc/apache2/sites-available/eprints</tt>
 Include /opt/eprints3/cfg/apache.conf
and enable the site
 $ sudo a2ensite eprints
(this leaves <tt>/etc/apache2/apache.conf</tt> 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.
* [[Getting Started with EPrints 3]]

== Restarting Apache ==

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