DSpace - Digital Library Software

judgedrunkshipServers

Nov 17, 2013 (3 years and 1 month ago)

180 views




DSpace
-

Digital Library Software







Kaushal Giri

Dy. Manager


Knowledge
Centre

Export
-
Import Bank of India

kaushal.giri@eximbankindia.in





Nilesh Shewale

Librarian

Don Bosco Institute of
Technology

shewale.nilesh2008@gmail.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


捬楣歩湧⁃潮瑲潬oPa湥氠


捬楣歩湧⁓y獴敭 a湤 Ma楮i敮慮ee

捬楣歩湧cSy獴敭⸠



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
-
6
u
38
-
windows
-
i
586
)



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
-
6
u
38
-
windows
-
i
586
)


http
:
//www
.
oracle
.
com/technetwork/java/javase/downloads/jd
k
6
u
38
-
downloads
-
1877406
.
html



Installing

Java,

to

do

this

,

double

click

on

the

file

‘jdk
-
6
u
38
-
windows
-
i
586


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

click

on

“apache
-
tomcat
-
7
.
0
.
34
.
exe”


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
\
dspace
-
1.7.0
-
build.dir” on command prompt


“cd C:
\

dspace
-
1.7.0
-
src
-
release
\
dspace
\
target
\
dspace
-
1.7.0
-
build.dir”


Now type “
ant fresh_install
” and press enter


C:
\

dspace
-
1.7.0
-
src
-
release
\
dspace
\
target
\
dspace
-
1.7.0
-
build.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

create
-
administrator”



Using

your

explorer

browse

through

your

C
:
\
dspace
\
webapps

folder






Copy “jspui” and “xmlui” folder to your tomcat
installation’s 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

Community

Collection

Item

Metadata

Bitstream

License

DSpace Data Model

Community

Collection

Item

Metatadata

Bitsteam

License

Collection

Item

Bitstream

Metadata

Licences

Community

Collection

Item

Metadata

Bitstream

License

Collection

Item

Bitstream

Metadata

Licenses

DSpace Data Model

Community

Community

Collection

Community

Collection

Collection

DSpace Data Model

Collections

Community

Community

College of
Arts and
Sciences

Graduate
School

ETDs

Conference
papers

Faculty

Conference
Papers

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

Community

Collection

Item

Metatadata

Bitsteam

License

Collection

Item

Bitstream

Metadata

Licences

Community

Collection

Item

Metadata

Bitstream

License

Collection

Item

Bitstream

Metadata

Licences

DSpace Data Model

Item

Metadata

Bitstream

License

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 person’s 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)