Installing DSpace 1.6.0 on Window

Bharat M. ChaudhariSchool of Petroleum Management,

PANDIT DEENDAYAL PETROLEUM UNIVERSIRY, GANDHINAGAR

bharat.chaudhari@ipmg.ac.in

1

DSpace 1.6.0 an Outline

Build architecture with maven

►xmlui (aka. Manakin)

►SWORD Interface

►LNI (Lightweight Network Interface)

2

Prerequisite Software

► Microsoft Windows 2000/XP

► Java JDK 1.6 or later

► Apache Maven 2.0.8 or later (Java build tool)

► Apache Ant 1.6.2 or later (Java build tool)

► Relational Database: (PostgreSQL or Oracle)

► Servlet Engine: (Apache Tomcat 6.0.7 or Jetty )

3

4

Prerequisite Software

Installation Steps

Java SDK 1.6 or later (standard SDK is fine, you don't need J2EE) form

www.java.sun.com

Relational Database server: PostgreSQL from www.postgresql.org/ftp

Apache Maven 2.0.8 or later from http://maven.apache.org

Apache Ant 1.6.2 or later from http://ant.apache.org

Apache Tomcat 6.x or later from http://tomcat.apache.org

5

Installing Java platform

Installation of Java JDK 1.6

6

SETTING Environment Variable

1. Add system variable JAVA_HOME with value C:\Program Files\Java\jdk1.6.0_18

7

1. Copy apache-maven-2.0.9 package into C:\and add C:\apache-ant-1.6.2\bin to the PATH environment variable.

2. Copy apache-ant-1.7.0 package C:\and add C:\apache-ant-1.6.2\bin to the PATH environment variable.

Installing Apache Maven and Apache Ant

8

Installing PostgreSQL 8.1

9

Creating a Database with PostgreSQL 8.1

After installing ensure the PostgreSQL service is running, and then run pgAdminIII (Start -> PostgreSQL 8.0 -> pgAdminIII). Connect to the local database as the postgres user and:

Create a 'Login Role' (user) called dspace with the password dspaceCreate a database called dspace owned by the user dspace, with UTF-8 encoding

10

Creating a Database with PostgreSQL 8.1

11

Installing DSpace

1. Copy DSpace 1.6.0 source package into C:/ and

You may download the DSpace source from SourceForge and un tar it (Win Zip will do this) from URL: http://sourceforge.net/projects/dspace

12

Update the Config file

Update paths in [dspace-source]\dspace\config\dspace.cfg. Note: Use forward slashes / for path separators, though you can still use drive letters, e.g.: dspace.dir = C:/DSpaceMake sure you change all of the parameters with file paths to suit, specifically:

dspace.dir config.templatelog4j.properties s

config.template.log4j-handle-plugin.properties

config.template.oaicat.properties

assetstore.dir log.dir

upload.temp.dirreport.dir handle.dir

» Create the directory for the DSpace installation (e.g. C:\DSpace)13

Generate the Dspace Installation

Generate the DSpace installation package by running the following from command line(cmd) from your [dspace-source]/dspace/ directory: Create a new directory in mvn package or install

Note #1: This will generate the DSpace installation package in your [dspace-source]/dspace/target/dspace-[version]-build.dir/ directory.

Note #2: Without any extra arguments, the DSpace installation package is initialized for PostgreSQL. If you want to use Oracle instead, you should build the DSpace installation package as follows:mvn-Ddb.name=oracle package

14

Generate the Dspace Installation

15

Generate the Dspace Installation

Initialize the DSpace database and install DSpace to [dspace](e.g. C:\DSpace) by running the following from command line from your[dspace-source]/dspace/target/dspace-[version]-build.dir/ directory:ant fresh_install

Note: to see a complete list of build targets, runant help

16

Create an Administer Account

Create an administrator account, by running the following from your [dspace](e.g. C:\DSpace) directory

c:\dspace\bin\dsrun org.dspace.administer.CreateAdministrator

and enter the required information

17

Installing Apache Tomcat 6.0.7

Run Apache Tomcat 6.0.7 .exe to install tomcat

18

Tomcat Configuration

Copy the Web application directories from[dspace]\webapps\to Tomcat's webappsdir, which should be somewhere like C:\Program Files\Apache Software Foundation\Tomcat 5.5\webappsAlternatively, Tell your Tomcat installation where to find your DSpace web application(s). As an example, in the

<Host> section of your [tomcat]/conf/server.xml you could add lines similar to the following (but replace [dspace]with your installation location):

<!--DEFINE A CONTEXT PATH FOR DSpace JSP User Interface --> <Context path="/jspui" docBase="[dspace]\webapps\jspui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/> <!--DEFINE A CONTEXT PATH FOR DSpace OAI User Interface --> <Context path="/oai" docBase="[dspace]\webapps\oai" debug="0" reloadable="true" caching Allowed="false" allowLinking="true"/>

19

Tomcat Configuration

Start the Tomcat service and browse to either http://localhost:8080/jspui or http://localhost:8080/xmlui. You should see the DSpace home page for either the JSPUI or XMLUI, respectively

20

Your Dspace 1.5.2 is live

21

Bharat M. Chaudhari

22