DSpace - Digital Library

Software
Kaushal Giri
Dy. Manager Knowledge
Centre
Export-Import Bank of India

kaushal.giri@eximbank
india.in

Nilesh Shewale
Librarian
Don Bosco Institute of
Technology

shewale.nilesh2008@g
mail.com

Pre-Requisite software
Java SDK
Apache Maven
Apache Ant
Apache Tomcat
PostgreSQL
Dspace

Before Installation of DSpace

Kindly Check your computer is running on 32 or 64 bit

windows
To find out following are the steps:

Windows vista or windows 7

Open System by clicking the Start button clicking

Control Panel clicking System and

Maintenanceclicking System.
2. Under System, you can view the system type.

Windows XP
Click Start, and then click Run.
Type sysdm.cpl, and then click OK.
Click the General tab. The operating system is displayed as

follows:

For a 64-bit version operating system: Windows XP Professional

x64 Edition Version < Year> appears under System.

For a 32-bit version operating system: Windows XP Professional

Version <Year> appears under System.

Installation Steps
Before attempting installation please check that

you have downloaded and saved all the

mentioned prerequisites as shown below.
Java SDK (jdk-6u38-windows-i586)
Apache ant (apache-ant-1.8.4-bin)
Apache Maven (apache-maven-3.0.4-bin)
PostgreSQL (postgresql-9.2.2-1-windows)
Apache Tomcat (apache-tomcat-7.0.34)
DSpace (dspace-3.0-src-release)

Step- 1
JAVA SDK (jdk-6u38-windows-i586)
http://www.oracle.com/technetwork/java/javase/downl
oads/jdk6u38-downloads-1877406.html
Installing Java, to do this , double click on the file

jdk-6u38-windows-i586 and follow the on screen

instructions and accept the license agreement.

Step -2
APACHE ANT (apache-ant-1.8.4-bin)
http://ant.apache.org/bindownload.cgi
To install Apache Ant , create a new folder named ANT in C:

drive , Unzip (Expand) contents of apache-ant-1.8.4-bin in to

C:\ANT

APACHE MAVEN (apache-maven-3.0.4-bin)

http://maven.apache.org/download.cgi
To install Apache Maven create a new folder named MAVEN in

C:\MAVEN unzip apache-maven-3.0.4-bin.zip in to that folder.

Contd.

Step-3 (Environment Variable)

For Windows Vista or Windows 7
Right click My Computer Click Properties Click on

Advanced System Settings from Tasks Choose

Advance tab Click on Environment Variable Button

For Windows XP
Right

click My Computer Click Properties

Advance tab Click on Environment Variable Button

Now click on PATH variable under System Variables

and click on Edit.Button

Variable Name: JAVA_HOME

Variable Value: C:\Program Files\Java\jdk1.6.0_38

Variable Name: ANT_HOME

Variable Value: C:\ANT

Add followings to your PATH variable

; C:\Program
Files\Java\jdk1.6.0_38\bin;C:\ANT\bin;C:\MAVEN\bin

Step-4
Now it is time to verify the platform, to do this
execute following commands in to the
command prompt.
> java version
> ant version
>mvn version
One should get following output.

Step-5

This step covers installation of PostgreSQL

with database creation, to install PostgreSQL

double click on postgresql-9.2.2-1-windows.
Follow the onscreen instruction given by
installer.

Step-6
In this step we will create an empty database

for DSpace. To do this , perform following

operation
Start >> Programs >> PostgreSQL 9.2 >>

pgAdmin III
In this window right click on your server and

click on connect as shown below.

New Login Role

To Create database

Creating New Database

Step-7
Apache Tomcat (apache-tomcat-7.0.34)
http://tomcat.apache.org/download-70.cgi
This step installation of Apache Tomcat will be

attempted, to do this, double

apache-tomcat-7.0.34.exe

click

on

Apache Tomcat SetUp

Screen Shots

Step-8
This step we will perform actual installation of

dspace.
Before doing this create an empty directory in

C: drive, where actual configuration, program

files and datafiles of dspace will reside.
In our case we will be using C:\DSpace

 Extract all the contents of dspace-3.0-src-release.zip to one

folder (i.e DSpace) and copy entire folder to your C:\ drive as
C:\ dspace-1.7.0-src-release.zip
Once the files are unzipped, go to

C:\Dspace\dspace-3.0-src-release\dspace\config,
Find out dspace.cfg and open in notepad or any other

editor and atleast change the following parameters. Use

forward slashes `/` for path separators

Changes to be made in Dspace.cfg

dspace.dir = C:/Dspace.
dspace.name = "Dspace Repository".
mail.server = mail.yourinstitute.ac.in
mail.from.address = admin@drtc.ac.in
feedback.recipient = admin@drtc.ac.in
mail.admin = admin@drtc.ac.in

Once you have edited dspace configuration file open the command
prompt and go to C:\ dspace-3.0-src-release \dspace folder
cd C:\Dspace\dspace-3.0-src-release\dspace
Now type mvn package and press enter
C:\Dspace\dspace-3.0-src-release\dspace> mvn package
Note:Please note that internet connection is required to perform
this operation,Maven will download dspace source dependencies
online.

Now go to C:\ dspace-1.7.0-src-release\dspace\target\dspace1.7.0-build.dir on command prompt

cd C:\ dspace-1.7.0-src-release\dspace\target\dspace1.7.0-build.dir
Now type ant fresh_install and press enter
C:\ dspace-1.7.0-src-release\dspace\target\dspace-1.7.0build.dir>ant fresh_install

Step-9 Create Administrator

Now

it is time to create default system

administrator. To create administrator execute
following command
C:\dspace\bin\dspace
administrator

create-

Using your explorer browse through your

C:\dspace\webapps folder

Copy jspui and xmlui folder to your

tomcat installations webapps folder

Step-10
Start tomcat service if it is already not running

by going in to :
Control Panel Administrative Tools
Services Apache Tomcat 7 and clicking on
Start

Point your browser to

http://localhost:8080/jspui
or http://localhost:8080/xmlui

Yahooo we are done with

Installation
Queries are welcome

Communities & Collections

Communities

Can contain sub-communities OR collections

Collections

Can contain items

Items

Contains metadata and bitstreams (files)

DSpace Data Model

DSpace Data Model

DSpace Data Model

DSpace Data Model

Communities & Collections

Steps to creating communities:
1.Log in
2.Click Communities & Collections (under
Browse)
3.Click on Create Community (under Context)
4.Give the community a name and add a short
description and introductory text (optional)
5.Upload a logo file (optional)
6.Click Create to finish

Communities & Collections

To create a sub-community, navigate to the

community in which the sub-community will
exist and then follow the same steps for
creating a community.

DSpace Data Model

DSpace Data Model

Create and Submit an Item

Steps to submitting an item:
1.Log in
2.Choose the community/collection you wish to
submit to
3.Select Submit a new item
4.Describe the item (metadata)
5.Browse for and upload the file (bistream(s))
6.Make corrections if necessary
7.Grant the license

Users and Groups

Users

Individuals that have a role in the system

Groups

Groups of users that share roles

Create Users and Groups

Steps to create users:
1.Select People (under Administrative
Access Control)
2.Click Create a new e-person
3.Add the new persons name and contact
information
4.Click Create E-person

Create Users and Groups

Steps to create groups
1.Choose Groups (under Administration
Access Controls)
2.Select Create a new Group
3.Give the group a name
4.Use Search members to add e-people the
new group
5.Click Add next to the e-people you want to
add to the group
6.Click Save

Workflow Steps
No Workflow Steps
Item is made available upon submission
Workflow Step 1 (Accept/Reject)

Can accept or reject a submission

Workflow Step 2 (Accept/Reject/Edit Metadata)

Can accept or reject a submission and edit metadata
Workflow Step 3 (Edit Metadata)

Can edit metadata before making item available

Workflow Steps

Workflow for Collections

Steps to create a workflow:
1.Select the community and collection you wish
to edit
2.In the Context box, select Edit Collection
3.Edit the collection metadata (Edit Metadata
tab)
4.Choose the Assign Roles tab
5.Assign e-people and/or groups to the roles that
are relevant to the collection and the workflow
you have selected

Metadata
Descriptive Metadata
Qualified Dublin Core
Limited expansion to other formats

Metadata
Submission Forms
Customizable in configuration files
Editing Metadata

Can be done after submitting

Adding Metadata
Can be done after submitting
Metadata Registry

Creates new metadata field names

Item Template
Default values

Removing Items: Withdraw vs. Delete

Withdraw

Removes item from view

Does not show up in search results
Recoverable

Permanently Delete (Expunge)

Unrecoverable
Handle is not reused
Can only be done by a repository administrator

Removing and Deleting Items

Steps for removing and deleting items:
1.Navigate to the item you wish to
remove/delete
2.In the Context box, choose Edit this item
3.Choose Withdraw to withdraw the item from
the repository OR choose Permanently Delete
to expunge the item from the repository
permanently

Authorizations
Bitstream

READ can open the file

WRITE can alter the file
Item
READ can view the item
WRITE can modify the item
ADD/REMOVE can add or remove bitstreams
Collection
ADD/REMOVE can add or remove items from the collection
DEFAULT_ITEM_READ new items receive this READ attribute
DEFAULT_BITSTREAM-READ new bitstreams receive this READ authorization
COLLECTION_ADMIN can edit or withdraw items, or map items into the collection
Community
ADD/REMOVE can add or remove collections from the community

Authorizations
Steps for adding authorizations/policies to a
community:
1.Click on Authorizations (under Administrative
Access Control)
2.Click on the Community whose policy you wish to
create/modify
3.Choose either Add a new policy or Edit to modify
an existing group policy
4.Choose the action (permission) you want to give the
group
5.Choose the group to whom the action is being given
6.Choose Save

Authorizations
Steps for adding authorizations/policies to a
collection:
1.Choose the collection
2.Choose Edit Collection (under Context)
3.Choose the Assign Roles tab
4.Choose the e-people or group to whom the
role is assigned
5.Choose Save

Dspace Backup
At an absolute minimum, you should back up:
[dspace-source] if you've made any customizations
[dspace]/assetstore
[dspace]/config
Program File/Apache software foundation/tomcat/webapps

[dspace]/history and [dspace]/log if you want to

preserve activity records

PostgreSQL, especially /usr/local/pgsql/data (or
wherever the data dir is)