dspace presentation tutorial v142 (1)
TRANSCRIPT
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
1/43
DSpace Basic Tutorial
Stuart Lewis & Chris [email protected]
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
3/43
Information
Tutorial created by:
Repositories Support Project
http://www.rsp.ac.uk/
Funded by:
JISC as part of the RepositoryNet
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
8/43
DSpace Technical Architecture
Database:
Same machine, or database server
Postgres*
Oracle
Web application server
Tomcat* Jetty
Other
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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/
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
14/43
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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/
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
18/43
*Create DSpace users
Create an administrator
Log in
Log out
Create a normal user
Modify a group
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
20/43
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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)
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
24/43
DSpace Items
input-forms.xml
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
25/43
input-forms.xml
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
27/43
input-forms.xml
Englishen
Welsh
cy
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
28/43
input-forms.xml
dc
contributor
authortrue
Authors
name
Enter the names of the authors of this
item below.
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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.
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
30/43
*Deposit an item
Choose collection
Enter metadata
Upload file
Confirm details
Agree to the licence
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
36/43
Search system initalisation
Search Aberystwyth
No results
Run: bin/filter-media
Extract full texts
(create thumbnails)
Build indexes
Search Aberystwyth
See results!
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
37/43
*Scheduled background jobs
filter-media
Extract texts and build indexes
sub-daily Email subscription emails
checker
checks bitstream checksums stat-*
statistics
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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]
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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)
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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] -
7/23/2019 DSpace Presentation Tutorial v142 (1)
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
-
7/23/2019 DSpace Presentation Tutorial v142 (1)
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