Dspace on Wi ndows.

DSpace is a software of choice for academic, non-profit, and commercial organizations who are
building and running open digital repositories. It is free and easy to install. DSpace preserves and
enables easy and open access to all types of digital content including text, images, videos and data
sets.

Pre-requisite Software:

1. J ava Development Kit.
2. PostgreSQL
3. Apache Tomcat
4. Apache Maven
5. Apache ANT
6. DSpace

Java Development Kit: J DK is a development environment for building applications, applets, and
components using the J ava programming language. You can download it from:
http://java.sun.com/javase/downloads/widget/jdk6.jsp

PostgreSQL: PostgreSQL is a powerful, open source object-relational database system. It has native
programming interfaces for C/C++, J ava, .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

Apache Tomcat: Apache Tomcat is an open source software implementation of the J ava 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

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

Apache ANT: Ant is a J ava-based build tool. In theory, it is kind of like Make, without Make's
wrinkles and with the full portability of pure J ava code. You can download Apache Ant from:
http://ant.apache.org/bindownload.cgi

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
First of all download all above mentioned softwares and save it in one folder.



Software versions used:

J DK : jdk-6u14-javafx-1_2-windows-i586
PostgreSQL : postgresql-8.4.0-1-windows
Apache Tomcat : apache-tomcat-5.5.28
Apache Tomcat : apache-maven-2.2.1-bin
Apache Tomcat : apache-ant-1.8.0-bin
Dspace : dspace-1.5.2-src-release



At first install J DK.
Double click and execute the installer file of J ava which you have downloaded. ( jdk-6u14-javafx-1_2-
windows-i586)



Click on Accept.



Click next here



Installation will start.



Another installer will start for installing J RE. Click next.



Click finish to close the installer.
After this you will also need to set up Environmental variables. And J AVA HOME.
Right click on My computer and to 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 J AVA >J DK 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 J AVA_HOME.

Variable name: J AVA_HOME
Variable Value: C:\Program Files\J ava\jdk1.6.0_14

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 maven 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-2.2.1\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\J ava\jdk1.6.0_14\bin; C:\apache-maven-2.2.1\bin; C:\apache-ant-1.8.0\bin.

Ok its done!!....now define ANT_HOME in user variables

Variable name: ANT_HOME
Variable value: C:\apache-ant-1.8.0


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
C:/ 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.

Now, tick mark all the components in order to do full installation and then click next.

Again click next here.

In this window give your username and password, that will give you access to monitor and control you
tomcat server web interface.
Then click next.


Make sure that your java virtual machine path is appropriate with your J RE installation folder.
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.

But first of all check that for installing PostgreSql, the file system of your local disc must be NTFS
To identify this, right click the local disc(C; E; Fetc), select Properties, see the File system
If all the drives in your system are FAT, then convert a convenient disc to NTFS For converting, go to
command prompt and type C:\>CONVERT C: /fs:ntfs this command will convert your c drive into
NTFS filesystem. But if you already have C drive with NTFS filesystem partition, you can simply
proceed to 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.

Click finish to exit the installer.
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 8.4 (localhost:5432)


Database will start... and then create login roll.

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

Fill up the fields of role name with dspace and your desired password...
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.

Right click on Database icon and click New Database.

Fill up Database name: dspace and select database owner dspace.
Click ok.

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.5.2-src-release will be created in C drive.
Here you create one more folder named DSpace in C drive


Open C:\dspace-1.5.2-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. di r =C: / DSpace

Here you can also make other changes. Like your mail server, your Dspace URL.
If you are going to use dspace on you Local machine only, you must leave the URL as it is
http://localhost:8080/jspui
But if you want to run it on your LAN then you must replace localhost with the IP address of your pc.
e.g http://10.0.0.100:8080/jspui (10.0.0.100 is IP address of my pc)

Make other changes if you want to, those are optional, (you will be able to do it later also). But above
mentioned two changes are compulsory. After changing it, save and close the file.

Now we will run mvn package to make installer for Dspace. But first make sure that postgreSQL
service is running. If it is not then restart it from Start >>all programs >>PostgreSQL 8.4 >>Restart
Server.


After this open command prompt and go to DSpace directory by typing the following command.

C:\>cd dspace-1.5.2-src-release\dspace

Then type mvn package


DOS Screen will start running like this

This may take a bit long (be sure your internet connection is running properly while performing this
task. These two tasks are very critical, so better leave the system free while performing this. Play
safe!!).

If it successfully completes it must show this screen.


Yeah !!

This will generate the installer package in your C:\dspace-1.5.2-src-release\dspace\target\dspace-1.5.2-
build.dir directory.
Now open command prompt and switch to C:\dspace-1.5.2-src-release\dspace\target\dspace-1.5.2-
build.dir. with this command

C:\>cd dspace-1.5.2-src-release\dspace\target\dspace-1.5.2-build.dir

And now run this command here

Ant fresh_install


After finishing the task, this will show this screen...


You made it dude!!

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 5.5\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 only thing required is just to create an Administrator account for DSpace.

Open command prompt and give the following command...

C:\>DSpace\bin\dsrun org.dspace.administer.CreateAdministrator



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



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



Now you will be able to browse your Dspace from any pc on the network.

Congrats buddy !!
U made it!






Regards
Rupinder singh Dhammu
IIAS | Shimla
jesse@email.ru
www.Rupindersingh.co.nr