How to install DSpace 6 on Ubuntu 20.04

How to install DSpace 6 on Ubuntu 20.04

In this tutorial we will learn how to install DSpace on Ubuntu 20.04. DSpace is open source software for building repositories, generally used by academic institutions.

Hardware Recommendations

Recommended hardware as a DSpace server.

Minimal DSpace Production

  • 3-4GB RAM
  • 20GB Storage

Mid-range DSpace Production

  • 5-6GB RAM
  • 200GB Storage

High-end DSpace Production

  • 9-10GB RAM
  • 1TB Storage

Software Requirements

Software needed to run DSpace.

  • Java JDK 8
  • Apache Maven
  • Apache Ant
  • PostgreSQL
  • Apache Tomcat

Create User

Create a dspace user.

Install PostgreSQL

Install PostgreSQL database.

Create user dspace with password dspace in PostgreSQL.

Create a database for dspace.

Activating the pgcrypto extension.

Open the PostgreSQL configuration file pg_hba.conf.

Add the following configuration.

PostgreSQL configuration pg_hba.conf
PostgreSQL configuration pg_hba.conf

Restart PostgreSQL.

Building DSpace

Install OpenJDK 8.

If another version of OpenJDK has been installed previously, change the default java to OpenJDK 8.

Install ant and maven.

Create a dspace folder.

Create a build folder for building DSpace.

Download DSpace 6.3 from GitHub.

Extract dspace*.tar.gz.

Move to the dspace-6.3-src-release folder.

Copy the local.cfg file.

Compile the DSpace package.

Compile DSpace package
Compile the DSpace package

Install DSpace.

DSpace installation
DSpace installation

Install Apache Tomcat

Download and extract Apache Tomcat 9.

Rename the apache-tomcat-9.0.41 folder to tomcat.

Open the /etc/profile file.

Add configuration environment variables for Java.

Java environment variables
Java environment variables

Copy dspace webapps to tomcat webapps.

Create a bash script so that Tomcat can run automatically.

Enter the following bash script.

Give executable permissions and set it as a service.

Run Tomcat server and check the status.

DSpace Administrator

Create a DSpace administrator account.

Create administrator account
Create administrator account

Delete the build folder.

Browse DSpace site.

  1. http://localhost:8080/xmlui atau http://serverIP:8080/xmlui
  2. http://localhost:8080/jspui atau http://serverIP:8080/jspui

Access with Subdomain

Install Nginx web server.

Create a Nginx server block configuration file for the dspace.musaamin.my.id subdomain.

Enter the configuration below.

Nginx configuration test.

If there is no mistake.

Restart Nginx.

Browse http://dspace.musaamin.my.id

DSpace repository site (xmlui)
DSpace repository site (xmlui)

Install SSL Let’s Encrypt

Install certbot Let’s Encrypt.

Request SSL for the subdomain dspace.musaamin.my.id on Nginx.

If the SSL install is successful, the message below will be displayed.

Browse https://dspace.musaamin.my.id

Good luck 🙂

3 Comments

  1. Thank you for this manual for installing DSpace on Ubuntu20.04 LTS. I’ve been getting BUILD FAILURE when try to use the command “sudo ant fresh_install”. Kindly help me to overcome this challenge. Thank you.

Leave a Reply