Installation of DSpace 6.3 on Ubuntu 18.04.1 LTS

-


Hi, friends, 
    I could install  Dspace 6.3 (latest) on Ubuntu 18.04.1 LTS successfully after fixing bugs which occurred in the installation process. Here I provide a note for the installation by which you can try. 
(NB: I highly recommend you to install Ubuntu 18.04.1 minimal or Ubuntu 16.04  or any other lite weight Ubuntu flavors for the fast performance) 

Installation of prerequisite applications
  • Java Development Kit (JDK)
  • PostgreSQL Database
  • DSpace Software
  • Apache Ant (Pure Java Build Tool)
  • Apache Maven (Apache Build Automation Tool for Java Projects)
  • Apache Tomcat (Web Server for hosting Dspace)

Open  Applications > Accessories > Terminal and execute the following commands.

sudo apt update  

sudo apt upgrade -y

sudo apt-get install openjdk-8-jdk postgresql ant maven

Choose OpenJDK-8 as default for that run this command

sudo update-alternatives --config java 

Create the database user

sudo -i -u postgres

createuser -U postgres -d -A -P dspace

Enter the 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 nano /etc/postgresql/10/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.

Login to the database as a superuser, and enable the pgcrypto

extension on this database

sudo su postgres

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

exit

sudo /etc/init.d/postgresql restart

Create a directory to build, give all permissions and Download DSpace into /build directory

sudo mkdir /build  

sudo chmod -R 777 /build 

cd /build 

sudo wget https://github.com/DSpace/DSpace/releases/download/dspace-6.3/dspace-6.3-src-release.tar.gz

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

Extracting Dspace package

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

Open the following file and remove a piece of lines.

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

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

<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>buildnumber-maven-plugin</artifactId>
<version>1.4</version>
<executions><execution>
<phase>validate</phase>
<goals>
<goal>create</goal>
</goals>
</execution>
</executions>
</plugin>

Save and close the file.

Installation of DSpace

Enter into the Dspace package folder and apply the 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 http://apachemirror.wuchna.com/tomcat/tomcat-9/v9.0.37/bin/apache-tomcat-9.0.37.tar.gz

Or you can visit the Tomcat website and download the latest package.

Extract Tomcat package

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

Rename folder "apache-tomcat-9.0.37" to "tomcat" and Delete the Tomcat archive file from /opt folder

sudo mv apache-tomcat-9.0.37 tomcat 

sudo rm apache-tomcat-9.0.37.tar.gz

Open the following file,

sudo nano /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 the following file in a Terminal,

sudo nano  /etc/init.d/tomcat

Add following lines in the file,

#!/bin/bash
### BEGIN INIT INFO
# 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
### END INIT INFO

PATH=/sbin:/bin:/usr/sbin:/usr/bin

start() {
 sh /opt/tomcat/bin/startup.sh
}

stop() {
 sh /opt/tomcat/bin/shutdown.sh
}

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

save and close the file.

Apply the following commands too;

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

Restart Tomcat server and Postgresql database

sudo service tomcat start 

sudo service tomcat stop 

sudo service tomcat restart
 
sudo /etc/init.d/postgresql restart  

sudo /etc/init.d/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 the user login.
Enter an email address (e.g. dspace@localhost).
Enter First name and surname (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.

Comments

Post a Comment

Popular posts from this blog

BASIC LINUX COMMANDS

-
Image
  Display information about the Operating  System hostnamectl   Display information about the CPU architecture lscpu   Listing files and directories   ls   Detailed listing   ls -l   Lots of details about the contents of your directory   The * wildcard   ls d*   This will list all files in the current directory starting with d   Making Directories   mkdir tom   Changing to a different directory   cd tom   Change to the parent directory   cd ..   will take you one directory up the hierarchy. Command Meaning ls List files and directories ls -a List all files and directories mkdir Make directory cd directory Change directory cd Change to the home directory cd ~ Change to the home directory...
continue reading »

Header on DSpace JSPUI interface

-
Image
  Customised header on DSpace JSPUI interface Prepare a header image and place in Dspace folder e.g.  cp header.png /opt/tomcat/webapps/jspui/image Hide Dspace brand heading Open header-default.jsp file using Terminal. Apply following commands, sudo su gedit  /opt/tomcat /webapps/jspui/layout/header-default.jsp Find following lines  </header> <main id="content" role="main"> <div class="container banner">     <div class="row">         <div class="col-md-9 brand">             <h1><fmt:message key="jsp.layout.header-default.brand.heading" /></h1>             <fmt:message key="jsp.layout.header-default.brand.description" />         </div>         <div class="col-md-3"><img clas...
continue reading »

Install LibreOffice

-
Image
  How to Install LibreOffice    The default LibreOffice office suite reached the new major 6.2 released a few days ago. Here’s how you can install it in Ubuntu 18.04, Ubuntu 16.04, Linux Mint 18/19, and derivatives.According to  Libreoffice 6.2 release  note, the new release brings new icon themes and app icons, better KDE integration, reworked image handling, improvements to Excel 2003 XML import, continued GTK3/GNOME improvements, and more. How to Install LibreOffice 6.2 via Snap in Ubuntu: While LibreOffice PPA is not ready for the new release at the moment, you can install the snap package in Ubuntu 18.04 and/or Ubuntu 16.04 easily via following steps.Snap is containerized software package, designed to work securely within most Linux desktop. It bundles all its dependencies and auto-updates itself. To install LibreOffice 6.2 snap, simply open Ubuntu Software, search for and install the first ‘libreoffice’ package from Snappy store. Or open terminal (Ctrl+Alt...
continue reading »