Installing DSpace 4.x on Ubuntu 12.04/14.04 LTS

[This installation document is obsoleted. Please visit for latest Dspace installation steps.]

Installation of prerequisite applications

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

apt-get install leafpad
sudo apt-get install openjdk-7-jdk
sudo apt-get install postgresql
sudo apt-get install tomcat7
sudo apt-get install 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 

Configure Tomcat
[If the following command not open, check the tomcat version number and apply in the command]

sudo leafpad /etc/tomcat7/server.xml

Insert the following chunk of text just above the closing </Host>

<!-- Define a new context path for all DSpace web apps -->
<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="/jspui" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

save and close  the file.

Create Dspace directory

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

Download Dsapce to /build directory
You can check latest version of Dspace from here.
Copy paste following line in the terminal,


Extracting Dspace package

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

Enter into Dspace package folder to download packages.

cd dspace/target/dspace-4.2-build
sudo ant fresh_install

Fix Tomcat permissions, and restart the Tomcat server
sudo chown tomcat7:tomcat7 /dspace -R

Restart Tomcat

/etc/init.d/tomcat7 restart

Make an initial administrator account (an e-person) in DSpace:
/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
You can load either one Dspace interface in a browser.