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)
