Saturday, March 5, 2016

Install DSpace 5.x on Ubuntu 14.04 LTS

Installation of prerequisite applications

Open  Applications > Accessories > Terminal and execute following commands. Text in italics are commands to be executed.

sudo su
apt-get install leafpad openjdk-7-jdk postgresql ant maven

Create the database user

sudo su postgres
createuser -U postgres -d -A -P dspace

Enter password for new role: [Enter a password e.g. dspace]
Shall the new role be allowed to create more new roles? (y/n) n
[Enter n and press enter button]

Type exit

Allow the database user (dspace) to connect to the database
[If the following command not open, check the postgresql version number and apply in the command]

sudo leafpad /etc/postgresql/9.3/main/pg_hba.conf

Add this line to the configuration file at the end:  

local all dspace md5

save and close the file

Restart PostgreSQL :

sudo su
/etc/init.d/postgresql restart

Create Dspace user  

sudo useradd -m dspace
sudo passwd dspace
[enter a password for the new user dspace]
sudo mkdir /dspace
sudo chown dspace /dspace

Create the PostgreSQL 'dspace' database

sudo -u dspace createdb -U dspace -E UNICODE dspace  

save and close  the file.
Create Dspace directory

sudo mkdir /build
sudo chmod -R 777 /build
cd /build

Download Dsapce to /build directory
Copy paste following line in the terminal,


You can find latest version from this page and copy the link to download latest version.

Extracting Dspace package

tar -zxf dspace-5.6-src-release.tar.gz
cd /build/dspace-5.6-src-release
mvn -U package 

Enter into Dspace package folder to download packages.

cd dspace/target/dspace-installer
sudo ant fresh_install

Installation of Tomcat

Download the and extract the Tomcat package,

cd /opt


tar xvzf apache-tomcat-8.0.37.tar.gz

Rename folder "apache-tomcat-8.0.37" to "tomcat"

mv apache-tomcat-8.0.37 tomcat

Delete the package file from /opt folder

rm apache-tomcat-8.0.37.tar.gz

Open following file, 

leafpad /etc/profile

Setup environment variables
Environment variables to find JAVA.

Add following lines at the bottom of the file,

export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
export CATALINA_HOME=/opt/tomcat

Copy Dspace webapps files to Tomcat folder 

sudo cp -r /dspace/webapps/* /opt/tomcat/webapps

Running Tomcat automatically
You can set up to start the Tomcat server start automatically at the time of system turn on.

Open following file in a Terminal,

leafpad  /etc/init.d/tomcat

Add following lines in the file,

# Provides:        tomcat7
# Required-Start:  $network
# Required-Stop:   $network
# Default-Start:   2 3 4 5
# Default-Stop:    0 1 6
# Short-Description: Start/Stop Tomcat server


start() {
 sh /opt/tomcat/bin/

stop() {
 sh /opt/tomcat/bin/

case $1 in
  start|stop) $1;;
  restart) stop; start;;
  *) echo "Run as $0 <start|stop|restart>"; exit 1;;

save and close the file.

Apply following commands too,

chmod +x /etc/init.d/tomcat
update-rc.d tomcat defaults

Start Tomcat server,

service tomcat start

Now you can start and stop Tomcat server using following commands;

service tomcat start
service tomcat stop
service tomcat restart

Make an initial administrator account (an e-person) in DSpace:

Apply following command in a terminal,
/dspace/bin/dspace create-administrator

It will ask to enter email address for user login.
Enter an email address (e.g. dspace@localhost).
Enter First name and surename (e.g. dspace)
Enter a password.

Open Dspace in your browser
Dspace has two interfaces; xmlui and jspui. You can load either one Dspace interface in a browser.