Installing DSpace on Window Bharat M. Chaudhari School of Petroleum Management, PANDIT DEENDAYAL PETROLEUM UNIVERSIRY, GANDHINAGAR 1
DSpace 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 or later (Java build tool) ► Apache Ant or later (Java build tool) ► Relational Database: (PostgreSQL or Oracle) ► Servlet Engine: (Apache Tomcat or Jetty ) 3
4 Prerequisite Software
Installation Steps Java SDK 1.6 or later (standard SDK is fine, you don't need J2EE) form Relational Database server: PostgreSQL from Apache Maven or later from Apache Ant or later from Apache Tomcat 6.x or later from 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 package into C:\and add C:\apache-ant-1.6.2\bin to the PATH environment variable. 2. Copy apache-ant 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 dspace Create a database called dspace owned by the user dspace, with UTF-8 encoding 10
Creating a Database with PostgreSQL
Installing DSpace 1.Copy DSpace source package into C:/ and You may download the DSpace source from SourceForge and un tar it (Win Zip will do this) from URL: 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:/DSpace Make 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, run ant 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 Run Apache Tomcat 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\webapps Alternatively, Tell your Tomcat installation where to find your DSpace web application(s). As an example, in the section of your [tomcat]/conf/server.xml you could add lines similar to the following (but replace [dspace]with your installation location): 19
Tomcat Configuration Start the Tomcat service and browse to either or You should see the DSpace home page for either the JSPUI or XMLUI, respectively 20
Your Dspace is live 21
Bharat M. Chaudhari 22