You are on page 1of 30

Dspace Installation Guide

(Windows 2003 Server)


Pre-requisite Software:
Java Development Kit.
PostgreSQL
Apache Tomcat
Apache Maven
Apache ANT
DSpace
1. Java Development Kit: JDK is a development environment for building
applications, applets, and components using the Java programming
language. You can download it from:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. PostgreSQL: PostgreSQL is a powerful, open source object-relational
database system. It has native programming interfaces for C/C++, Java,
.Net, Perl, Python, Ruby, Tcl, ODBC, among others. We will be using it
for storing the database of our repository. You can download it from:
http://www.postgresql.org/download/windows
3. Apache Tomcat: Apache Tomcat is an open source software
implementation of the Java Servlets. This will work and help us to make
our own Web server. You can download it from:
http://tomcat.apache.org/download-60.cgi
4. Apache Maven: Apache Maven is a software project management and
comprehension tool. Based on the concept of a project object model
(POM), Maven can manage a project's build, reporting and documentation
from a central piece of information. You can get it from:
http://maven.apache.org/download.html
5. Apache ANT: Ant is a Java-based build tool. In theory, it is kind of like
Make, without Make's wrinkles and with the full portability of pure Java
code. You can download Apache Ant from:
http://ant.apache.org/bindownload.cgi
6. DSpace: You know about it already, this will be everything youll need to
set up a repository. You will get it at:
http://sourceforge.net/projects/dspace/files
7. First of all download all above mentioned softwares and save it in one
folder.
Software versions used:
JAVA SDK: jdk-6u24-windows-i586.exe
APACHE MAVEN: apache-maven-3.0.3-bin.zip
APACHE ANT: apache-ant-1.8.2-bin.zip
APACHE TOMCAT: apache-tomcat-7.0.11.exe
POSTGRESQL: postgresql-9.0.3-1-windows.exe
DSPACE: dspace-1.8.0-src-release.zip
At first install JDK.

Double click and execute the installer file of Java which you have downloaded.
(jdk-6u24-windows-i586.exe)


Another installer will start for installing JRE. Click next.

Click finish to close the installer.

After this you will also need to set up Environmental variables and JAVA HOME.

Right click on My computer and click Properties.

Go to Advanced TAB. And click on Environmental variables.

Here select PATH in system variables section and click EDIT button.

Open your program files directories in C drive and locate JAVA > JDK x.x.x.x.>
bin folder. Now copy the file path from the address bar of windows explorer. Like
this.

Paste this path in system variable window, Use ; as a separator. Click ok














Now in User Variable segment. Click on NEW to set up a new user variable of
JAVA_HOME.
Variable name: JAVA_HOME
Variable Value: C:\Program Files\Java\jdk1.6.0_24
Paste here the path of you java home directory in program files.
Click ok, and apply the settings.
After this we will install Apache maven. Apache maven is binary distribution,
there is no installer file in that. So we will just Extract the zip folder of apache ant
in to root of C drive. C:\



This will make the folder of apache maven in C drive.

Extract the files of apache ant into C drive, same way. And a folder for apache ant
will be created in C drive.

Now give path for apache maven in system variables the same way like we did.
Right click My Computer >> Properties >> Advanced >> Environmental
variables
Click on path and edit it.
Add path C:\apache-maven-3.0.3\bin (use semicolon to add with existing Path)

Now define path variable for apache ant in the same way we did earlier. Open the
extracted folder of apache ant in C drive, copy the folder path from windows
explorer address bar and paste it in system path.
Click ok.
So all system paths are defined.
C:\Program Files\Java\jdk1.6.0_24\bin;
C:\apache-maven-3.0.3\bin;
C:\apache-ant-1.8.2\bin.
Ok its done!!....now define ANT_HOME in user variables

Variable name: ANT_HOME
Variable value: C:\apache-ant-1.8.2
Click ok and apply the settings.
All system paths and user variables are defined.
We can also check, what we have done till now.

Open command prompt and run the following command to see the java version
java -version
Same way you can check
ant -version
mvn version
and the command prompt will show the following screen.

It means all packages java, maven and ant are successfully installed and paths are
appropriately defined.
After this we will install Apache Tomcat,
Double click on Apache tomcat installer file and follow the instruction.
Click next.

Click I Agree.

Click next
In this window give your username and password, that will give you access to
monitor and control your tomcat server web interface.
Then click next.
Make sure that your java virtual machine path is appropriate with your JRE
installation folder.
Click next.

Click Install

Click finish.. And then tomcat service will start automatically.

And you will see this type of icon in Notification area of Taskbar.
Ok now.Lets install PostgreSQL.
Double click the Installer file of postgreSQL. And installer will start.

Click Next

Check installation directory and click next.

Check data directory and click next.

In this window you must provide the database password which will allow you to
administrate your DATABASE.
Click next.

Check DATABASE port no. The port no. should be 5432.
Click next.

Installation will start.

You may be asked to Launch Stack Builder at Exit Please do not check if you
dont want to install additional tools (not required for DSpace). Click on Finish
button to complete the installation
Ok. So postgreSQL has been installed. And now we will create database and login
rolls. ..
So open pgAdmin III

pgAdmin will start.

Click on small icon of postgreSQL 9.0 (localhost:5432)
Database will start... and then create login role.


Right click on Login roles icon and click New Login Role.

Now create a user named dspace with your desired password (in this case
password is dspace) as shown in following screen and click OK. Then open role
privileges tab.

Tick mark on icons named: Can create database objects, and can create roles. And
then click ok.
Login role is created. Now create Database.
To create a data base right click on Databases and click on New Database as
shown in figure below:

You will get following screen, in that enter database name as dspace , select
Owner as dspace and choose Encoding as UTF8 (this is required for handling
multilingual data) and click on ok button.

Dspace database is created. You can close the postgreSQL window now.
We have reached to the final step
Extract Dspace zip folder in C drive.

A directory dspace-1.8.8-src-release will be created in C drive.

Here you create one more folder named DSpace in C drive

Open C:\dspace-1.8.0-src-release\dspace\config\dspace.cfg.
Open this dspace.cfg file in wordpad. We need to edit this file here.
In this configuration file, change the Dspace installation directory path.

Change it to. dspace.dir = C:/DSpace
Here you can also make other changes. Like your mail server, your Dspace URL.
Make other changes if you want to, those are optional, (you will be able to do it
later also). But above mentioned change is compulsory. After changing it, save
and close the file.
Once you have edited dspace configuration file open the command prompt and go
to C:\ dspace-1.8.0-src-release \dspace folder

Now type mvn package and press enter
Please note that internet connection is required to perform this operation, Maven
will download dspace source dependencies online.
When the execution is successfully over you will get following message:

Now go to C:\ dspace-1.8.0-src-release\dspace\target\dspace-1.8.0-build on
command prompt
CD C:\ dspace-1.8.0-src-release\dspace\target\dspace-1.8.0-build and execute
command ant fresh_install.
After successful execution you will get following message:


Finally you need to copy directories of your dspace web applications (jspui,
xmlui, oai) into your webservers folder.
Dspace webapps directories are in C:/DSpace/webapps folder.
You must copy 3 folders jspui, xmlui and oai and paste these folders in
C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps

Open your web browser and open the url http://localhost:8080/jspui
Or http://localhost:8080/xmlui
You will see the following screen...


Now it is time to create default system administrator. To create administrator
execute following command:
C:\dspace\bin\dspace create-administrator
Here it will ask you for some more inputs, like E-mail Address, first name, last
name, password, (while giving password be careful coz the console will display
the password on the screen).

Ok your administrator account has been created.

You can use this email id and password to login on DSpace administrator window
and to manage your Dspace from http://localhost:8080/jspui/password-login or
http://localhost:8080/xmlui/password-login.

And if your login is successful you can create community and collection in this
window.

Dspace Installation Guide
(Windows 2003 Server)
Pre-requisite Software:
Java Development Kit.
PostgreSQL
Apache Tomcat
Apache Maven
Apache ANT
DSpace
1. Java Development Kit: JDK is a development environment for building
applications, applets, and components using the Java programming
language. You can download it from:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. PostgreSQL: PostgreSQL is a powerful, open source object-relational
database system. It has native programming interfaces for C/C++, Java,
.Net, Perl, Python, Ruby, Tcl, ODBC, among others. We will be using it
for storing the database of our repository. You can download it from:
http://www.postgresql.org/download/windows
3. Apache Tomcat: Apache Tomcat is an open source software
implementation of the Java Servlets. This will work and help us to make
our own Web server. You can download it from:
http://tomcat.apache.org/download-60.cgi
4. Apache Maven: Apache Maven is a software project management and
comprehension tool. Based on the concept of a project object model
(POM), Maven can manage a project's build, reporting and documentation
from a central piece of information. You can get it from:
http://maven.apache.org/download.html
5. Apache ANT: Ant is a Java-based build tool. In theory, it is kind of like
Make, without Make's wrinkles and with the full portability of pure Java
code. You can download Apache Ant from:
http://ant.apache.org/bindownload.cgi
6. DSpace: You know about it already, this will be everything youll need to
set up a repository. You will get it at:
http://sourceforge.net/projects/dspace/files
7. First of all download all above mentioned softwares and save it in one
folder.