Sei sulla pagina 1di 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: santosh.guptaa@gmail.com
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 santosh.guptaa@gmail.com and dspace) we
can start working on DSpace.

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

For any query mail me at: santosh.guptaa@gmail.com or contact at my mobile: 9040022440


THANK YOU.

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

Potrebbero piacerti anche