Tuesday, January 18, 2011

Installing DSpace 1.6. 2 on Window XP

1. Pre-requisite Software
You'll need to install following pre-requisite software:
·         Java SDK 1.6.x or later (standard SDK is fine, you don't need J2EE)

If you install PostgreSQL, it's recommended to select to install the pgAdmin III tool

·         Apache Ant 1.7.x or later. Unzip the package in C:\ and add C:\apache-ant-1.6.2\bin to the PATH environment variable. For Ant to work properly, you should ensure that JAVA_HOME is set.
·         Jakarta Tomcat 6.x or later
·         Apache Maven 2.0.8 or later

2. Installation Steps
  1. Download the DSpace source from SourceForge and untar it (WinZip will do this)
  2. Ensure the PostgreSQL service is running, and then run pgAdmin III (Start -> PostgreSQL 8.0 -> pgAdmin III). 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  
  3. 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.template.log4j.properties
config.template.log4j-handle-plugin.properties
config.template.oaicat.properties
assetstore.dir
log.dir
upload.temp.dir
report.dir
handle.dir
  1. Create the directory for the DSpace installation (e.g. C:\DSpace)
  2. Generate the DSpace installation package by running the following from commandline (cmd) from your [dspace-source]/dspace/ directory:
6.  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
  1. Initialize the DSpace database and install DSpace to [dspace] (e.g. C:\DSpace) by running the following from commandline from your [dspace-source]/dspace/target/dspace-[version]-build.dir/ directory:
8.  ant fresh_install
Note: to see a complete list of build targets, run
ant help
  1. Create an administrator account, by running the following from your [dspace] (e.g. C:\DSpace) directory
[dspace]\bin\dsrun org.dspace.administer.CreateAdministrator
and enter the required information
    • Alternatively, 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):
o    <!-- DEFINE A CONTEXT PATH FOR DSpace JSP User Interface  -->
<Context path="/jspui" docBase="[dspace]webappsjspui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>
<!-- DEFINE A CONTEXT PATH FOR DSpace OAI User Interface  -->
<Context path="/oai" docBase="[dspace]webappsoai" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>

  1. Start the Tomcat service
  2. 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
For more about DSpace please vist Dspace web page

» You may follow DSpace cluster with:

o   LinkedIn

3 comments:

Visual ACE said...

how does one change http://localhost:8080 to a url of choice e.g http://mydspace using nginx?

Paul Mulinge said...

how does one change http://localhost:8080 to a url of choice e.g http://mydspace using nginx?

Visual ACE said...

how does one create an ssl self signed certiforicate for HTTPS support on Dspace by either using puttygen or other procedures on Dspace 1.7.0 running on Windows 7 32bit

Installing SubjectPlus 4.2 on Ubuntu 16.04 LTS

SubjetcPlus is a free and open source tool to help you manage several interrelated parts of your library data CREATING USERS AND DATAB...