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.
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