DSpace Presentation Tutorial v142 (1)

7/23/2019 DSpace Presentation Tutorial v142 (1)

1/43

DSpace Basic Tutorial

Stuart Lewis & Chris [email protected]


2/43

Information

Details:

Requires tutorial CD

DSpace 1.4.2

CD includes DSpace 1.5 alpha

CD and workbook created by:

Chris Yates [email protected]

Stuart Lewis

[email protected]


3/43

Information

Tutorial created by:

Repositories Support Project

http://www.rsp.ac.uk/

[email protected]

Funded by:

JISC as part of the RepositoryNet


4/43

Contents

1. Introduction to DSpace

2. The tutorial CD

3. DSpace technical architecture

4. Users and groups

5. Item structure

6. Metadata and item input, workflows7. Search and browse

8. Import / export / harvest


5/43

Introduction to DSpace

DSpace captures your data in any format intext, video, audio, and data. It distributes itover the web. It indexes your work, so userscan search and retrieve your items. Itpreserves your digital work over the longterm. DSpace provides a way to manage yourresearch materials and publications in a

professionally maintained repository to givethem greater visibility and accessibility overtime. www.dspace.org


6/43

*Introduction to the tutorial CD

Intended to be used with tutorial

DSpace version 1.4.2 (includes 1.5 alpha)

Shouldnt affect your PC

Installs no software

Can be reused

DOES NOT SAVE DATA! Disclaimer


7/43

DSpace Technical Architecture

Written in Java

Can be run on any platform that supports

Java Most installation on Unix (Linux* / Solaris)

Runs on Windows / Mac OS X

Sun JDK (not GNU) 1.4 for = version 1.5


8/43

DSpace Technical Architecture

Database:

Same machine, or database server

Postgres*

Oracle

Web application server

Tomcat* Jetty

Other


9/43

DSpace file layout

Download [dspace-src]

Edit config/dspace.cfg

Build

Installed [dspace] (often /dspace/)

[dspace]/assetstore/

[dspace]/upload/ [dspace]/logs/

[dspace]/bin/

[dspace]/search/


10/43

*Create the database

Create a database user

Who will own the database

Called dspace

Create the database

Called dspace

UNICODE encoding

Owned by the dspace database user


11/43

Create the database

Create a database user

Double click on the Terminal icon

su - postgres password is postgres createuser-U postgres -d -P dspace

password is postgres

Create the database

createdb -U dspace -E UNICODE dspace


12/43

*Build DSpace

DSpace needs to be compiled

Uses ant build system

Inserts default data into the database Table structures

Dublin Core metadata schema

Bitstream formats Builds package for the web server

Configuration can be changed


13/43

Build DSpace

cd /dspace142-src/

gedit config/dspace.cfg

Change dspace.name to your name Save and quit

ant fresh_install

chmod 777 /dspace142/upload chmod 777 /dspace142/assetstore


14/43


15/43

Deploy to the web server

cp build/*.war /var/lib/tomcat5.5/

sudo /etc/init.d/tomcat5.5 start

Load Firefox Go to http://localhost:8080/dspace/


16/43

DSpace users and groups

Administrator

bin/create-administrator

Create more users: Web user interface

Administrator

Other authentication methods: LDAP (LDAP or Active Directory)

Plugable and stackable authentication


17/43

DSpace users and groups

Groups

Members can be users of other groups

E.g. Dept group made up of researchgroup groups

User defined or

Automatically generated for collections


18/43

*Create DSpace users

Create an administrator

Log in

Log out

Create a normal user

Modify a group


19/43

Create DSpace users

Create first administrator bin/create-administrator

Answer questions

Create another user Administrator pages, E-People

Add EPerson

Promote new user to administrator Administrator pages, Groups

Edit Administrator group


20/43


21/43

Communities & collections

Communities / Collections link

Create Top-Level Community

Enter name, short description

Press Create button

Create collection

Enter name, short description

Add the Administrator group to submitters


22/43

DSpace items

Metadata

One or more metadata schemas

User-entered System-generated (e.g. accessioned date)

Files

In bundles Special bundles (e.g. extracted text,licences)


23/43

DSpace Items

Items can be mapped across collections

E.g. appear in central and departmental e-

theses collections Same as a file system symbolic link

Submissions controlled by input forms

config/input-forms.xml Input forms

Controlled vocabularies


24/43

DSpace Items

input-forms.xml


25/43

input-forms.xml


26/43

input-forms.xml

schema

element

qualifiertrue/false

Text label

name/onebox/date/twobox/textarea/dropdown/

qualdrop_valueExpanded hint

Warning to show if notentered


27/43

input-forms.xml

Englishen

Welsh

cy


28/43

input-forms.xml

dc

contributor

authortrue

Authors

name

Enter the names of the authors of this

item below.


29/43

input-forms.xml

dc

title

false

Title

name

Enter the main title of the item.

You must enter a main title for thisitem.


30/43

*Deposit an item

Choose collection

Enter metadata

Upload file

Confirm details

Agree to the licence


31/43

Deposit an item

Enter the collection you created

Tick The item has been published or

publicly distributed before - asks extraquestions about the publishing (i.e. date /publisher)

Enter metadata

Upload file (/dspace-docs/RSP.pdf)Agree to licence

Submit item


32/43

*Create a workflow

Three workflows

Accept/reject step

E.g. Head of research Should item be included in the repository?

Accept/reject/edit metadata step

E.g. Repository manager

Edit metadata step

E.g. Librarian


33/43

Create a workflow

Create new collection

Tick This submission will include and

accept/reject/edit metadata step

Enter name and short description

Add Administrator group to workflow

Submit to the new collection

Go to My DSpace to enter the workflow Edit Metadata

Approve


34/43

Search and browse

Browse By:

Author / title / date

Database driven

Always up to date

Search Lucene search engine

Define fields to index in dspace.cfg

Full texts

Not always up to date


35/43

*Search system initalisation

Build indexes

Index metadata

Extract from database

Index full-texts

Extract from PDF/Doc files

Extra MediaFilters can be written


36/43

Search system initalisation

Search Aberystwyth

No results

Run: bin/filter-media

Extract full texts

(create thumbnails)

Build indexes

Search Aberystwyth

See results!


37/43

*Scheduled background jobs

filter-media

Extract texts and build indexes

sub-daily Email subscription emails

checker

checks bitstream checksums stat-*

statistics


38/43

*RSS feeds and thumbnails

Configured in dspace.cfg

RSS feeds:

webui.feed.enable = [false|true]

webui.feed.localresolve = [false|true]

Thumbnails:

webui.item.thumbnail.show = [true|false]

webui.browse.thumbnail.show = [false|true]


39/43

RSS feeds and thumbnails

gedit /dspace142/config/dspace.cfg

Set webui.feed.enable to true

Set webui.feed.localresolve to true sudo /etc/init.d/tomcat5.5 restart

Upload new item with PNG file

Upload png from /home/dspace/examples/ /dspace142/bin/filter-media

See thumbnail


40/43

Import / export

See docs

Bulk import command line tool

Imports one item per directory

Multiple files / metadata file / contents file

Bulk exporter

Writes same file format

Adds file containing handle (for re-import)


41/43

Import / export

archive_directory/

item_000/

dublin_core.xml -- qualified DC metadata

contents -- one line per filenamefile_1.doc -- files to be addedfile_2.pdf

[dspace]/bin/dsrunorg.dspace.app.itemimport.ItemImport --add

--eperson= [email protected]

--collection=collectionID

--source=items_dir

--mapfile=mapfile
mailto:[email protected]:[email protected]


42/43

Harvesting / OAI-PMH

OAI-PMH interface Separate web application

/dspace-oai/

/dspace-oai/request?verb=

/dspace-oai/request?verb=Identify

/dspace-oai/request?verb=ListSets

/dspace-oai/request?verb=GetRecord

/dspace-oai/request?verb=ListIdentifiers

/dspace-oai/request?verb=ListMetadataFormats

/dspace-oai/request?verb=ListRecords


43/43

The end

Incomplete

Lots lots more!

Email [email protected] Email dspace-tech email list

Advanced tutorial this afternoon

Or surgery / open discussion / demos

Documents

DSpace Presentation Tutorial v142 (1)