Thursday, October 10, 2019

Install DSpace 6.x on Ubuntu 16.04 LTS

Installation of prerequisite applications
Open  Applications > Accessories > Terminal and execute the following commands. Apply following commands,

sudo apt update
sudo apt upgrade
sudo apt install leafpad openjdk-8-jdk ant maven

Install PostgreSQL
Apply the following commands one by one to install PostgreSQL 9.6.

sudo sh -c 'echo "deb xenial-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

wget --quiet -O - | sudo apt-key add -

sudo apt-get update

sudo apt install postgresql-9.6

Login to PostgreSQL and create the database

sudo su postgres

createuser --username=postgres --no-superuser --pwprompt dspace

Enter a 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]

createdb --username=postgres --owner=dspace --encoding=UNICODE -T template0 dspace

psql --username=postgres dspace -c "CREATE EXTENSION pgcrypto;"


Open the following file,

sudo leafpad /etc/postgresql/9.6/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 /etc/init.d/postgresql restart

Create a DSpace user
Apply the following commands one by one,

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

Create a directory to build Dspace

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

Download DSpace into /build directory
Copy-paste following line in the terminal,


You can find the latest updated of Dspace 6.x version from this page and copy the link to download latest version.

Extracting Dspace package

tar -zxf dspace-6.3-src-release.tar.gz

Open following file and remove a piece of lines.

sudo leafpad /build/dspace-6.3-src-release/dspace-api/pom.xml

Remove the following group of codes. Carefully check the lines in the file.


Save and close the file.

Installation of Dspace
Enter into Dspace package folder and apply following commands one by one.

cd /build/dspace-6.3-src-release
sudo mvn -U package 

cd dspace/target/dspace-installer
sudo ant fresh_install

Installation of Tomcat
Download the and extract the Tomcat package,

cd /opt

sudo wget

If the above mentioned link not working, visit Tomcat website and download the package.

sudo tar xvzf apache-tomcat-8.5.50.tar.gz

Rename folder "apache-tomcat-8.5.50" to "tomcat"

sudo mv apache-tomcat-8.5.50 tomcat

Delete the Tomcat package file from /opt folder

sudo rm apache-tomcat-8.5.50.tar.gz

Open the following file, 

sudo 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-8-openjdk-amd64
export CATALINA_HOME=/opt/tomcat

Copy Dspace web apps 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,

sudo leafpad  /etc/init.d/tomcat

Add following lines in the file,

# Provides:        tomcat8
# 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 the following commands too;

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

Start Tomcat server,

sudo service tomcat start

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

sudo service tomcat start
sudo service tomcat stop
sudo service tomcat restart

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

Apply following command in a terminal,

sudo /dspace/bin/dspace create-administrator

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

Delete the build folder

sudo rm -rf /build

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



No comments:

Post a Comment