Scribd
Upload
319 views

How To Install DSpace On Windows64 SantoshGupta 2017

This document provides step-by-step instructions for installing DSpace 5.2 or 6.1 on a Windows 64-bit operating system. It outlines downloading prerequisite software including Java, Ant, Maven, PostgreSQL, Tomcat. It then details installing these components and configuring environment variables before using Maven to build DSpace and Ant to deploy it. The administrator account is then created and DSpace is accessed via a web browser.

Uploaded by

Patricia Rocha Castañeda
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
319 views

How To Install DSpace On Windows64 SantoshGupta 2017

This document provides step-by-step instructions for installing DSpace 5.2 or 6.1 on a Windows 64-bit operating system. It outlines downloading prerequisite software including Java, Ant, Maven, PostgreSQL, Tomcat. It then details installing these components and configuring environment variables before using Maven to build DSpace and Ant to deploy it. The administrator account is then created and DSpace is accessed via a web browser.

Uploaded by

Patricia Rocha Castañeda
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

INSTALLATION OF DSPACE 5.2 OR 6.

1 ON WINDOWS OPERATING SYSTEM

How to Install DSpace 5.2 or 6.1 on Windows 64-bit operating systems

By Dr. Santosh Gupta, Librarian, KVS-ZIET Bhubaneswar

Pre-requisite Software
First download the following software from Internet.
1. UNIX-like OS or Microsoft Windows
2. JAVA JDK 7 or 8 (jdk-8u121-windows-x64)
3. APACHE ANT 1.8 or later (apache-ant-1.9.9-bin)
4. APACHE MAVEN 3.0.5 or later (3.3.9+) (apache-maven-3.3.9-bin)
5. PostgreSQL 9.4 or later (PostgreSQL-9.6.2-2-win64-bigsql)
6. APACHE TOMCAT 7 or later (apache-tomcat-9.0.0.M18)
7. DSpace 5.2 (dspace-5.2-src-release) or DSpace 6.1 (dspace-6.1-src-release)
Steps for Installation DSpace:
1. First Unzip Apache Ant, Apache Maven and DSpace zip files shown above by right click on these
and extract these in to C Drive or copy these unzipped folders into C Drive.
2. Steps to Install JAVA JDK
Run Java JDK Software by double click on jdk-8u121-windows-x64 and install by following the
onscreen instructions and accept the license agreement.
3. Steps to Add Environment Variables:
Open Environment Variables by Right Clicks on Followings:
Compute Properties Advanced System Settings Environment Variables (Click
on PATH) Edit. It will Show:
Variable name: PATH
Variable value: (Something like this)
C:\ProgramData\Oracle\Java\javapath;%SystemRoot%\system32;%SystemRoot%;%SystemRoot
%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0

copy this Variable value in to the notepad.

Now we have to add followings to PATH variables:


C:\apache-ant-1.9.9\bin;C:\apache-maven-3.3.9\bin;C:\Program Files\Java\jdk1.8.0_121\bin

This can be done by following procedures:

a) Go to C Drive on clicking followings:


Local Disk (C:) apache-ant-1.9.9 bin
and copy the path i.e. C:\apache-ant-1.9.9\bin in to the notepad after putting semi
colon;
b) Again go to C Drive on clicking followings:
Local Disk (C:) apache-maven-3.3.9 bin

Dr. Santosh Gupta, Librarian, KVS-ZIET Bhubaneswar 1


INSTALLATION OF DSPACE 5.2 OR 6.1 ON WINDOWS OPERATING SYSTEM

and copy the path i.e. C:\apache-maven-3.3.9\bin in to the notepad after putting semi
colon (;) after C:\apache-ant-1.9.9\bin.

c) Again go to C Drive on clicking followings:


Local Disk (C:) Program Files Java jdk1.8.0_121 bin
and copy the path i.e. C:\Program Files\Java\jdk1.8.0_121\bin in to the notepad after
putting semi colon (;) after C:\apache-maven-3.3.9\bin.

Now copy all text from Notepad and paste in the Variable value of Variable name PATH.
This text will be like this:
C:\ProgramData\Oracle\Java\javapath;%SystemRoot%\system32;%SystemRoot%;%SystemRoot
%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;C:\apache-ant-
1.9.9\bin;C:\apache-maven-3.3.9\bin;C:\Program Files\Java\jdk1.8.0_121\bin

Now Click OK.


After this click on New under Environment variables. A pop up will be opened with title New
User Variable
Type Variable name: ANT_HOME and variable value C:\apache-ant-1.9.9 (i.e. path of apache-ant
in C drive)
Again Click on New under Environment variables. A pop up will be opened with title New User
Variable
Type Variable name: JAVA_HOME and variable value C:\Program Files\Java\jdk1.8.0_121 (i.e.
path of java jdk in C drive)

Now open the Command prompt and verify the java, maven and ant versions by typing following
commands one by one in command prompt:
C:\Users\(Name of Computer)> java version (It will show: java version "1.8.0_121); again type
C:\Users\(Name of Computer)> ant version (It will show: Apache Ant(TM) version 1.9.9..); again type
C:\Users\(Name of Computer)> mvn -version (It will show: Apache Maven 3.3.9)..;
This shows that all platforms are installed successfully.
4. Installation of PostgreSQL
Click on PostgreSQL-9.6.2-2-win64-bigsql and follow the onscreen instructions to install this.
Give password dspace when asked for password. Uncheck (Remove ) when asked for the Stack
Builder during installation.
Now open PG Admin3 in computer. Right Click on Server localhost (localhost:5432) and connect
server using password dspace.
i. Right Click on Login Roles New Login Role. Give Role Name: dspace and click all under all
Role privileges and click OK. (In this way New Login Role named dspace will be created).

Dr. Santosh Gupta, Librarian, KVS-ZIET Bhubaneswar 2


INSTALLATION OF DSPACE 5.2 OR 6.1 ON WINDOWS OPERATING SYSTEM

ii. Now Right Click on Databases New Databases. Give Name: dspace and choose owner
dspace. Then under definition select pg_default under Tablespace. Then click OK. (In this way
New database named dspace will be created).
iii. Now close the PGAdmin3

5. Installation of Apache Tomcat


Click on apache-tomcat-9.0.0.M18 and follow onscreen to install it. At the end click on Start to
start Apache Tomcat Server.

6. Installation of DSpace Software


i. First create a folder named dspace in C Drive.
ii. Copy the path C:\dspace-6.1-src-release\dspace or from C Drive and paste it in the
Command prompt prefix cd.
C:\Users\(Name of Computer)>cd C:\dspace-6.1-src-release\dspace and press enter.
After this type mvn package in the command prompt like this:

C:\dspace-6.1-src-release\dspace>mvn package (then press Enter)


* Remember Internet is required to install DSpace.
At the end of Installation BUILD SUCCESSFUL will be appeared on screen.

iii. Now again copy the path C:\dspace-6.1-src-release\dspace\target\dspace-installer and


paste it in command prompt prefixing cd.
C:\Users\(Name of Computer)>cd C:\dspace-6.1-src-release\dspace\target\dspace-
installer (press Enter). After this type ant fresh_install in the command prompt like this:
C:\dspace-6.1-src-release\dspace\target\dspace-installer> ant fresh_install (then press
Enter)
(This will copy dspace software in to dspace director in C Drive.
WARNING AND ERROR RECTIFICATION:
If it shows BUILD FAILED, and asks to run following commands CREATE EXTENSION pgcrypto;
manually.
In this case open PGAdmin from windows button (i.e. PostgrSQL), then click on pgconsole given under
Plugins. Command Window (C:\PostgreSQL\pg96\bin\psql.exe) will be opened with the command
prompt dspace=#. Then type following command:
dspace=# CREATE EXTENSION pgcrypto;
CREATE EXTENSION
dspace=#
postgres=# SELECT gen_random_uuid();
postgres=# select * from pg_available_extensions where name='pgcrypto';

Dr. Santosh Gupta, Librarian, KVS-ZIET Bhubaneswar 3


INSTALLATION OF DSPACE 5.2 OR 6.1 ON WINDOWS OPERATING SYSTEM

postgres=pg_dumpall (Press Enter and then type)>db.out


postgres=pg_dumpall>db.out
Again type:
postgres=# select * from pg_available_extensions where name='pgcrypto';
postgres=# psql-f db.out postgres
postgres=# CREATE EXTENSION pgcrypto;
Then close Window and restart Tomcat Server and then again type the following in DOS command.
C:\dspace-5.2-src-release\dspace\target\dspace-installer> ant fresh_install
This time it will show BUILD SUCCESSFUL.
7. Creating Administrator
Now dspace administrator will be created by copying the path C:\dspace\bin from C
Drive and paste it in command prompt prefixing cd.
C:\Users\(Name of Computer)>cd C:\dspace\bin (press Enter). After this type dspace
create-administrator in the command prompt like this:
C:\ dspace\bin> dspace create-administrator (then press Enter) and give details like this
one.
E-mail address: [email protected]
First name: Santosh
Last name: Gupta
Password: dspace (This password will not be displaced on Screen)
Again to Confirm: (Re-type password i.e. dspace)
Is the above data correct? (y or n) Press Y.
8. Copying the Webapps to Tomcat Server
Now open C:\dspace\webapps by clicking on:
Compute Local Disk (C:) dspace webapps
Then copy three folders namely jspui, xmlui and solr and paste in C:\Program
Files\Apache Software Foundation\Tomcat 9.0\webapps directory.
9. Opening DSpace in Browser:
First Start tomcat service if it is already not running by following method:
Control Panel Administrative Tools Services Apache Tomcat 9.0 Tomcat9 and clicking on
Start.
Then Open browser and type: http://localhost:8080/jspui
DSpace screen will appear then Click on Sign on to (shown in upper right corner) and Click on
My DSpace.
Then putting E-mail Address and Password (Here [email protected] and dspace) we
can start working on DSpace.

************************

For any query mail me at: [email protected] or contact at my mobile: 9040022440


THANK YOU.

Dr. Santosh Gupta, Librarian, KVS-ZIET Bhubaneswar 4

You might also like