EPrints3 Installation on Ubuntu Via apt-get

So I have been evaluating the flexibility of existing digital repository software tools and decided to install the Eprints Ubuntu package via apt-get –I must say, I was rather impressed with the package. Not only does it work flawlessly, but the overall installation process is so very user friendly. All software dependencies are automatically installed during the installation process –including configuration of third party component tools such as MySQL. It took me less than 30 minutes to set it up on my local machine and all I had to do is follow the steps below.

Operating Environment

phiri@PHRLIG001:/var/log/apache2$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=11.10
DISTRIB_CODENAME=oneiric
DISTRIB_DESCRIPTION="Ubuntu 11.10"
phiri@PHRLIG001:/var/log/apache2$

STEP 1: Add APT mirros to sourcelist
The latest stable release builds are located here [1] and including them to the sourcelist is trivial –all that needs to be done is edit the soruces.list file and add the appropriate build (note line 12 below).

phiri@PHRLIG001:~$ sudo vi /etc/apt/sources.list

## Phiri's additions
## November 10, 2011
deb http://download.virtualbox.org/virtualbox/debian oneiric contrib

## Phiri's additions
#September 20, 2011
# deb http://download.virtualbox.org/virtualbox/debian oneiric contrib # disabled on upgrade to oneiric

# December 21, 2011
deb http://deb.eprints.org/ stable/

STEP 2: Update sourcelist
Resynchronise the package index files from the just added sources from their locations

phiri@PHRLIG001:~$ sudo apt-get update

Ign http://deb.eprints.org stable/ InRelease
:
Ign http://deb.eprints.org stable/ Release
:
Ign http://deb.eprints.org stable/ Packages/DiffIndex
:
Hit http://deb.eprints.org stable/ Packages
Ign http://deb.eprints.org stable/ Translation-en_ZA
Ign http://deb.eprints.org stable/ Translation-en

STEP 3: Install Eprints
After the update is successful, installing eprints3 should be fairly straight forward.

phiri@PHRLIG001:~$ sudo apt-get install eprints3
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following packages were automatically installed and are no longer required:
:
:
0 upgraded, 32 newly installed, 0 to remove and 1 not upgraded.
Need to get 14.6 MB of archives.
After this operation, 49.7 MB of additional disk space will be used.
Do you want to continue [Y/n]?

:
:
:
:
Setting up eprints (3.3.7) ...
update-rc.d: warning: /etc/init.d/epindexer missing LSB information
update-rc.d: see <http://wiki.debian.org/LSBInitScripts>
###################################################################
## ##
## Welcome to EPrints 3 ##
## ##
###################################################################
## ##
## For known issues please check: ##
## http://wiki.eprints.org/w/Debian_Known_Issues ##
## ##
## Getting Started: ##
## Before you can start using eprints you need to ##
## configure your install, follow these simple steps: ##
## ##
## # su eprints ##
## You have to logged in as the eprints user to operate ##
## with eprints ##
## # cd ##
## To the eprints home directory (/usr/share/eprints3) ##
## ##
## # ./bin/epadmin create ##
## Follow the instruction to create your archive. ##
## ##
## # exit ##
## ##
## # a2ensite eprints3 ##
## ##
## # apache2ctl restart ##
## ##
## ##### DONE ##### ##
## ##
## For more documentation please see the eprints wiki: ##
## http://wiki.eprints.org/w/Documentation ##
## ##
###################################################################
Setting up libbsd-resource-perl (1.2904-1build1) ...
Processing triggers for libc-bin ...
ldconfig deferred processing now taking place
phiri@PHRLIG001:~$

Don’t worry about the warning on “missing LSB information”; its something that is trivial and is a well documented [2, 3] warning message.

STEP 4: Go to eprints user home directory and run scripts
You need to switch users and login as eprints user to run the neccessary scripts that will create and configure the database and also create an archive.

phiri@PHRLIG001:~$ sudo su eprints
[sudo] password for phiri:
eprints@PHRLIG001:/home/phiri$ cd
eprints@PHRLIG001:~$ pwd
/usr/share/eprints3
eprints@PHRLIG001:~$ ./bin/epadmin create

Create an EPrint Repository

Please select an ID for the repository, which will be used to create a directory
and identify the repository. Lower case letters and numbers, may not start with
a number. examples: "lemurprints" or "test3"

Archive ID?
:
:

STEP 5: Configure Apache2

phiri@PHRLIG001:/etc/apache2/sites-available$ sudo a2ensite eprints3
Enabling site eprints3.
To activate the new configuration, you need to run:
service apache2 reload
phiri@PHRLIG001:/var/log/apache2$ sudo invoke-rc.d apache2 reload
 * Reloading web server config apache2 [ OK ]
phiri@PHRLIG001:/var/log/apache2$

EPrints version information

eprints@PHRLIG001:~$ ./bin/epadmin --version
epadmin 3.3.7 [Schema 3.3.2]

Copyright 2000-2011 University of Southampton.

This file is part of EPrints L<http://www.eprints.org/>.

EPrints is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

EPrints is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.

You should have received a copy of the GNU General Public License
along with EPrints. If not, see L<http://www.gnu.org/licenses/>.

eprints@PHRLIG001:~$

The resulting product looks like the snapshot below.

Eprints3 Demo Installation

Eprints3 Demo Installation


References

[1] http://wiki.eprints.org/w/Installing_EPrints_3_via_apt_%28Debian/Ubuntu%29#Stable_Builds
[2] http://ubuntuforums.org/showthread.php?t=1115013
[3] http://www.eprints.org/tech.php/thread-10324.html

One Pingback/Trackback