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 you’ll 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 it’s 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….Let’s 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 don’t 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.