Dspace How-To Guide Tips and Tricks for Managing Common Dspace Chores

Home , AC (complexity), ALL (complexity), DSPACE, R (complexity)

View metadata, citation and similar papers at core.ac.uk brought to you by CORE

provided by Illinois Digital Environment for Access to Learning and Scholarship Repository

DSpace How-To Guide Tips and tricks for managing common DSpace chores

(Now serving DSpace 1.4.2 and Manakin 1.1)

Authors / Contributors (alphabetically by last name)

Tim Donohue Scott Phillips Dorothea Salo

© 2006-2007 by all Authors / Contributors (listed above) This work is licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/ DSpace How-To Guide

. a ns ystems s ong each ot using mpiled n am .0 License unpacks the against the against one document. as require al

Because italics to mark etc). ow-to” documents ous customization- nd- n varies written If you are “h ystems deposits co on customizatio Share Alike 3

including: s a sta server. version 1.1. administrator unpacks on-obvi ed locatio orm. live, and operating n listed mmand rojects/xmlui/ ider perating ny comm s installed. nest co

i o resources, onfiguration file, dspace.cfg,

ome of these interface, precise DSpace administrator Noncommercial- c (e.g. Jetty, Resin, ma s cons ant f DSpace we have employed

n the DSpace mcat ose o cross-platf o es

ot be To Java DSpace wh n f choice es the commo Attribution-

o areas ntroduces Authors/Contributors

i o which the code. ould o customize parts live, administration. It has been It has administration. into which the DSpace all Manakin user Apache some parts int by valuable it sh engine Commons ource

http://di.tamu.edu/p ork identically ntroduce o which the

other ki.dspace.org/ ther http://wiki.dspace.org/TechnicalFaq w o Guide” where int where to i and the reative d http://www.dspace.org instructions for different instructions for es

code. directory © 2006-2007 ocation is set in DSpace’s – live in different Listing (including System Documentation and Mailing Lists) - Listing (including System Documentation and Mailing Lists) ou may wish t The directory he – attention: Manakin s y owever, f many o T under C his l http://wi Space ntende

o – f DSpace directory directory ce] T about where Space D he is i mepage he mcat, to include ons, h loaded sour T urce] newcomers to DSpace newcomers licensed T special match your servlet – of D e of file paths. Some directori of file paths. Some aware

To Ho Wiki – Technical FAQ - Resources code. klet .dir – r ideas or oaded tried be ent work is down ve

available within DSpace,

you start parts DSpace resources administrator decid administrator tasks f ould http://wiki.dspace.org/DspaceResourc Manakin documentation – DSpace DSpace DSpace DSpace DSpace dspace [tomcat] Apache to bette downl [manakin- the [dspace] [dspace-so ha g pieces This version 1.4.2 o d

ently ● ● ● ● ● ● ● ● ● We s short boo Other Although this “DSpace How-T curr You sh DSpace have differ missin systems requir most customizati Before Different Thi relate stable Introduction DSpace How-To Guide

done

. ong ome ngs CSS, can be number our and am y resources can be developers. .0 License ences all thi and XSLT. If and XSLT. web but saved. ) – introductory interface ) – to backup XSLT, SQL, design sites. web useful Share Alike 3 n time proper, i om/ withdrawing all the sure CSS, XML ons which rely on s ons which web rns Space a few oats, lists and selectors. and CSS Refer listed ools.c D fl TML, are CSS, XML, TML e.com/links.html lways be l modify or remove a large Noncommercial- a ) - CSS tutorials for web rich retu H TML, ) – time in DSpace hould Javascript, and me ogies, here SQL. For example, Attribution-

so many customizati which wil for XH including XH including g.com/ Authors/Contributors

using CSS-based TML, you s all ies, http://www.w3sch technol ( by out basics will reap o manage through the Commons

owledge queries t ood H with a little owever, introduces f kn reative H http://www.dezwozher o technolog y SQL /Guides and examples ( y of these © 2006-2007 nks to g uide” es, her li under C database o G learning SQL on an collection takes quite 2007): http://www.htmldo cumbersome http://css.maxdesign.com.au/ of ot er n the or all levels SQL query. licensed referenc running an i f ols Tutorials thers. f June How-T y CSS Zeldman! owledge work is seful skills seful resources seful as o

a refresh before u u kn MaxDesign ( Covers customizing page lay tutorials Hol with intermixed W3Scho tutorials, many o HTML Dog ( n a particular This i • • • • s “DSpace of items! Time spent Many tasks that are easily managed items in just one quick database Other Other Other Thi general you need (available DSpace How-To Guide 4 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 46 47 48 49 50 51 52 53 54 55 45 ...... 1 1

...... 0 License ...... ERSION ...... display metadata hecker hecker hecker footer

...... c c c ...... , V r ...... ror ror o (i18n) interface

Share Alike 3 item er er item's display ...... AKIN Vocabularies Vocabularies value MH ...... feeds feeds an an theme AN page m Statistics Statistics Statistics Statistics ot ot to an header M listed

RSS RSS checksum checksum checksum to a new a for displayed OAI-P

Manakin item metadata Manakin a a theme an Aspect d d

logos text Noncommercial- Controlled Controlled DSpace DSpace Dspace DSpace the Rebuil Install Create Customize Modify Add Add Install Troublesho Change Use Use Change Use Use Use Use Use Configure Configure Configure Configure Configure Troublesho Rebuil USTOMIZING C Attribution-

2 4 5 8 9 7 21 22 23 24 25 26 27 28 29 10 11 12 13 14 15 16 17 18 19 20 Authors/Contributors

all by ...... Commons

...... ERSION for for for ...... options ...... under C V ...... field ......

...... , layout indexing ...... a JSP filters filters ...... field input input input

layout ......

fields layout licensed

PACE Index page search to

text ey.name??? text ...... metadata DS media media full verall rowse

text DSpace Contents rowse work is b o single page

ustom metadata

search fields search fields default b DSpace DSpace Subject c new a metadata d d of submission submission submission This

a a new index ???some.k Alter Configure Modify Change Alter Alter Modify Modify Modify Re- Configure Configure Change Change Add Add Move Rebuil Rebuil Change Add Fix Introduction Table Quick USTOMIZING C Table of Contents of Table DSpace How-To Guide 5 . ] ] 41 [ 38

[ ] ce .0 License ] ] cker ] 26 [ 25 34 [ 39

che [

[ s s ields H interfa layout eed Share Alike 3 e f cksum tatistic se che RSS f ps

ce S Tips listed e OAI-PM ps e DSpa e th Ti Noncommercial- Change brow Change Modify brows Configure Us Configure Us x mination se w ● ● ● ● ● ● Bro Management Ti Disse Attribution-

] ] Authors/Contributors ] ]

or ] 52 51 ] ] [ 33 55 all

[ ] ] [ [ 15

] Inde 44 [ ] 50 ] ] ity f ] by [ 14 ] 20

[ 27 [

31 31 [ Commons 53 e) [ ]

[ ] [ [ 24 er ]

[ [ ) ional 16 13 ] ] 11 [ display [

]

chema [ s display 49 e??? ] 22 ] ] ] face reative [ 17 metadata [ e

[ funct options (DSpac (Manakin)

10 30 e layout JSP

]

[ ] [ [ ]

item' nter 48 layout eme erfac xt indexing 46 ] [ 21 ilters to a field arch [ [ te page (i18n 8

Space ) under C metadata etadata s [ Int elds ser I

Vocabularies Vocabularies se .key.nam ext spect

header or foot w th to an ext eme ips an error an error

ser ic D em to a ingle pag sion input forms l t ps if metadata a ne full t media f a th an A fault splayed item

ew t licensed form value DSpace ext earch fi XML U DSpace Manakin ??some

spec metadata

tiona JSP U Tips custom m new

in submis

See Modify it Add logos Add t Install addi Install Create Customize Change overall Change s Change page Add n Fix ? ( work is er

e Controlled e Controlled Tips

Tips Re-index Modify de Modify s Configure Configure Alt Change a Us Add a Add a Move a Change di Us ○ ○ ○ ○ Manak ○ ○ ○ ○ ○ ○ ○ ○ ○ Troubleshoot Troubleshoot DSpace Rebuild Rebuild This

rch ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● er Interface Ti Sea Submission Metadata Tips Us General General Quick Subject Subject Quick DSpace How-To Guide 6 . .0 License Share Alike 3 listed blank.] Noncommercial- nally left Attribution-

Authors/Contributors

This DSpace How-To Guide 7 .

.0 License Share Alike 3 2 listed Noncommercial- DSpace, Attribution-

Authors/Contributors

all by Commons

This DSpace How-To Guide

8 ]

ant r”)

mcat mcat urce] run Server”) op To for both ploy .0 License. stead JAR files) ogin as the [dspace-so platforms. ) to st to start To

in to l cd 2/de owever, ther party s*) H sure and s/3. Share Alike 3 es) ou could h sh change ebuild!) jbos site) as with o mcat (“Application listed omcat (“Application Serve eb omizing DSpace, Version 1.4.2 Version DSpace, omizing ). Make up.s own. otification Area) otification Area) files, y T sh used s ased, chang OS X server. Cust uires a r b [ Noncommercial- tart hutd code) nfiguration eq o start o stop To r wn the w SP- /library/ and reinstalls third- t t J library/jboss/3.2/deploy

have one already), /

Space ar /bin/s /bin/s / n’t with Mac code D Attribution-

Monitor (in N Monitor (in N s always Authors/Contributors

Admin Admin omcat may be rver after co to reinstall JAR all Space b se by Space! s running on (e.g. [Tomcat] [Tomcat]

nstalled i Commons i ropertie

Service Service D /webapps build/*.w Server Server OSX Server: this will bring do e we all D recompiles cp o not need mcat mcat reative

Me X / X / under C /build/ n DSpace st re if y desktop editions T desktop editions (WARNING: s to (recompiles i (which just

.war OS OS itially installed (Ju

rs / / JBOSS comes pre- and urce] urce] licensed (Quick build after smaller, usually

DSpace OS X Server) OS X Serve OS X Serve /webapps/ nges mcat mcat so ha a command prompt (if you do start To who in Note: sever on to the server update (Mac (Linux (Mac (Windows) Use To (Linux (Mac (Windows) Use To work is

build/* ○ ● Alternatively, build_wa Test c ant cp Log user Open ● ● ● ● ● ● Start Stop To [dspace- [dspace-so [Tomcat] This 4. 6. 3. 5. 1. 2. 2. 1. ● ● ● .. Quick Build: Quick Re (*Exception – Change Directories: o.

ow t ow Rebuild H DSpace How-To Guide

9 ]

y or r”) mcat mcat f

urce] an loy oai Server”) op To - ploy .0 License. JAR files) /dep ogin as the [dspace-so to st to start To

o remove to l cd dspace 2/de /3.2 party or ectory! sure and s/3. Share Alike 3 boss so wish t h sh jbos site) dspace ry/j mcat (“Application listed omcat (“Application Serve eb omizing DSpace, Version 1.4.2 Version DSpace, omizing ). Make up.s own. otification Area) otification Area) e wrong dir T

e) sh n s i Cust [ Noncommercial- tart hutd /libra ( o start o stop To st wn the w DSpac /library/ and reinstalls third- t t

ps of remove any have one already), created ar /bin/s /bin/s alho ode) / n’t code Attribution-

c Monitor (in N Monitor (in N esh all Authors/Contributors

Admin Admin /webap everything, you may al /loc all Space t] by Space! s running on (e.g. s running on (e.g. [Tomcat] [Tomcat]

i Commons

Service Service lina directories D /webapps build/*.w ) Completely Server Server this will bring do all D oai cp mcat mcat reative Cata - Use Use [Tomca r) r) © 2006-2007 Solaris) Solaris) DSpace (Completely refr in

[Tomcat]

d X / X / under C ecommended /work/ dspace (WARNING: (recompiles omcat to recompile

.war OS OS itially installed (removes old compiled t]

ut r T or create / / CAREFUL…you don’t want to remove th CAREFUL…you don’t want to b licensed DSpace OS X Server) es Rebuild: OS X Serve OS X Serve mcat mcat BE force a command prompt (if you do a command prompt - o To who in on to the server clean update dspace [Tomca (Mac T (Mac (Windows) Use To (Linux (Mac (Windows) Use To (Linux work is

build/* Optional, ● ● efresh/ ● ● Test your changes in DSpace Start ● ( directori Mac) ● ● cp ant ant Stop To ● Log user Open This R 9. 8. 7. 6. 3. 4. 5. 1. 2. .. Full (continued) o.

ow t ow Rebuild H DSpace How-To Guide ]

g 10

o text editor

For headin that you ge> .0 License. lues”. related” nge. long essa n of the JSP rties. open the my text careful

“va nd es: e) by very a )

rties be lly is “search- sp The “key” and its a really lines.

h1 keys” ties, line within /> ou wish to cha e.j to the locatio listed omizing DSpace, Version 1.4.2 Version DSpace, omizing is tica te ” y me earc hom sa Cust rch1 text [ Noncommercial- refers appropriate This text editor! me.s = automa separa n the f the 1 d .sea /jsp/ our o ] /Messages.prope o in Messages.properti e text you want to chang e text you want . text in more than one place, Attribution- in y ontains pairs of “ ontains pairs of

ding jsp.ho home th three to the key) in Messages.prope c

Authors/Contributors

xt packs in Messages.proper all wrappe search for the source s that Space on rties attribute by D (e.g. = Search rned off

Commons

and ce- up g text key te home.hea gets h1

a valid entry key=”jsp. language- must always be

under C mmun me.s essa “ /j /c actually his i or m and find the T text or example: that urce] urce] page licensed F the steps JSP jsp.co which so jsp.ho

Messages.properti corresponding Messages.prope When adding have automatic Change the Perform If relevant element. [dspace-so [dspace-so Open This 1. 3. 4. 2. ● ● 1. .. Notes: Instructions: Files: o.

ow t ow Change H DSpace How-To Guide ]

nt n

wa ou very is unique. y e be .0 License.

For example: displayed JSP on which ou will find it where rties, y text f the attribut new key. lues”. e) d” but Share Alike 3 key our rties “va ist of key values for the element /> l relate nd >

ocation o a l listed omizing DSpace, Version 1.4.2 Version DSpace, omizing key y” text editor! sage on if it is all kept in to the JSP, search- keys” our Cust o the new ewke [ Noncommercial- n Messages.prope t value of the i JSP is “ in y .myn of my directly /Messages.prope installati

corresponding to y

a rch1 e text you want to chang e text you want . that the Attribution-

neatness) find the home ne rned off th Authors/Contributors

li packs or .sea all (f the text a new odifying text Space by D = Text = Search ) ontains pairs of “ ing sure

Commons

c a new and key h1 rd-wrap tu key=”jsp. “key” usually refers language- mak rties

rties reative wo jsp.home Add

xt to xt Rebuild imply add

ge ynew earc (JSP containing © 2006-2007 s n g, the JSP and add i ged. onfig/ rties. sp/home.jsp sp/ (e.g. under C essa me.m me.s /j /j /c ou have te ourse, to appear, chan when adding or m speakin urce] urce] urce] relevant licensed er, the steps resides

Rememb careful You can, of c easier Messages.prope Generally this text [dspace-so Perform JSP Note: Messages.prope the For example: Open [dspace-so [dspace-so Open This new ● ● 4. 3. 2. ● ● 1. .. Notes: Instructions: Files: o.

ow t ow Add H DSpace How-To Guide

] 12

t file. es attribute appear key .0 License. rties of a Share Alike 3 ? rties the value Messages.properti ?? listed omizing DSpace, Version 1.4.2 Version DSpace, omizing be n the Cust ould appear [ Noncommercial- and Messages.prope exactly. string, add it: marks i /Messages.prope should . JSP; it sh s match cing ???some.key.name??? text) cing ???some.key.name??? Attribution-

Authors/Contributors

ontain the packs the all Space that If both the JSP string by D side Commons

the question the (JSP produ Text language- key.name does not c reative nside sure Rebuild element. es ame= © 2006-2007 string in > n i me onfig/ sp/local/ under C ey.n sage /c /j sa string i urce] urce] licensed the steps some.k for the for the some.

Messages.properti Perform Search to a contain the string, be If [dspace-so [dspace-so Search ?? This ? 4. 2. 3. ● ● 1. .. Instructions: File: o.

ow t ow Fix Fix H DSpace How-To Guide

] 13

.0 License. in the page default.jsp ooter- Administration user earlier (Default Navigati , f Share Alike 3 n the i n bar) fixes. listed omizing DSpace, Version 1.4.2 Version DSpace, omizing Header) navbar.jsp vigatio Cust [ Noncommercial- ossible na

p Default gation Bar). n Bar), or ( ) f . e-person selector Attribution-

Authors/Contributors

layout orm (in the (Locatio the

all f Space default.jsp by D Technical FAQ Commons yout/*.jsp yles.css.jsp

search reative yles.css.jsp. Rebuild © 2006-2007 his can break g the n in header- ocation-bar.jsp i admin.jsp (Admin Navi l the DSpace sp/local/st sp/local/la under C ovin /j /j TML H CSS in st oter), ki.dspace.org/TechnicalFaq of m urce] urce] overall licensed Check Fo the steps and navbar- work is

careful http://wi Perform Change the (Default Bar), Change the [dspace-so [dspace-so interface. ( Be (e.g. to page-top). T This 3. 1. 2. ● ● ● .. Notes: Files: Instructions: o.

ow t ow Change H DSpace How-To Guide

] 14

are .jsp

ion oter- .0 License. default.jsp this JSP communities yout of this JSP: n bar. nly a few values myNavigat .jsp and fo or la o ooter- f are Share Alike 3 n this JSP. nd is used. myStyle n locatio navbar- all parent a o to display f There vide listed for this JSP omizing DSpace, Version 1.4.2 Version DSpace, omizing ommunities/collections are links i c default.jsp ide o use. to customize the igation bar on a page. layout Cust JSP: means the o use default.jsp t n bar. to pro [ Noncommercial- ocation bar ” t l es”, nav f the l parent avbar- tion n al ff the means the header- on bar for this JSP. header- attempt . ff the o Attribution-

– o le” viga do not prov ocation bar Authors/Contributors

– used the top o all ” nk” ng “attribut Space turns ks in the locatio ySty myNa by D > turns – page page Commons sp/local/

f” Link mmLi f” for this JSP /j … type of l ocation bar. the navigati ag near ollowi l the “style” of header/footer as lin is unspecified, is unspecified, f T reative is unspecified, .jsp will be =”of =”no =”co =”of Rebuild urce] used yout © 2006-2007 style=”m navbar=” n

f the i specifies specifies navbar locbar style under C e:la

specifies mportance: – – displayed If locbar locbar locbar within the If (e.g.) myStyle If used. (e.g.) will be navbar i – owing JSP [dspace-so o o o o o o o o o oll n single licensed f the steps i

Perform Pass this tag any o Pass this tag any Any JSP Find the This 3. 2. ● 1. .. Instructions: Files: o.

ow t ow Change H DSpace How-To Guide ] 15

)

new

dual and dd a ou will A schemas Y ) schema .0 License. schemas. dc it serves resolvable. ( . be since ) metadata schema Share Alike 3 es Administrator Login metadata ent Administration user admin fields from one schema to equir Dublin Core schema “namespace” listed l curr namespace omizing DSpace, Version 1.4.2 Version DSpace, omizing R ( characters, al the underlying database. a metadata field Cust [ owing the instructions in Noncommercial- y see admin /dspace- metadata that the o the to see Move t ly a few e- ve ent non-hierarchical) n by foll ( i on etadata Attribution-

rem lat” Authors/Contributors o be

and visit the DSpace hould onl ields /dspac t in a new metadata f “f all ow added m requi by space Commons you s ess-to-my-dspace

d nstructions i is no o possible to mo Registry” in order this schema). Click “Save” reative or eb-addr ly supports page, enter © 2006-2007 f ng the w schema is n Administrator There ss-to-my- on new metadata ( f the under C By default, . It is als ollowi o add b-addre http:// field licensed we ( metadata by f as a prefix ta s a DSpace / currently ou may wish the “name” want t custom custom work is

the bottom o The new then metada another, At give it a “name”. Also, y purpose Login a interface Click on the “Metadata within DSpace. http:/ DSpace This a 4. 3. 1. 2. ● ● .. Notes: Instructions: Files: o.

ow t ow Add H DSpace How-To Guide

] 16

)

y o that t

schemas where n forms(see .0 License. a field as a member the new field. orm, new metadata f item display (see o add t eld ) metadata Share Alike 3 Fi es Administrator Login or the ent database f Administration user admin ield equir ote” to the submissio New” to add listed f l curr omizing DSpace, Version 1.4.2 Version DSpace, omizing R n (

al of the schema Cust [ Noncommercial- ou can now make this field Add Metadata admin /dspace- to see e- to the underlying Click “Add and “scope ), add this field Attribution-

ou wish, y red. Authors/Contributors ).

and visit the DSpace /dspac y all by n the namespace w added ), and/or display this field in the s space Commons o ess-to-my-dspace

s requi d tadata etadata i “qualifier”, Registry” in order search fields reative schema. If eb-addr page, you will find the m © 2006-2007 put form w field is no Administrator ss-to-my- hen, click item me in f the Modify under C T

sion b-addre an “element”, metadata (see http:// schema. licensed we ( metadata bmis s a DSpace / displayed Only the “element” new new nge work is current

the bottom o the searchable Alter su Cha particular At can specify field. The new Login a interface Click on the “Metadata within DSpace. http:/ This a 3. 4. 1. 2. ● .. Files: Instructions: o.

ow t ow Add H DSpace How-To Guide

]

)

you ove a the put nce nd updated a in DSpace. in schema. schemas Si the schema .0 License. search displayed g this form sion nge will be ou wish to m bmis Modify Usin y

schema. Cha ) metadata

the field(s) being used d field Share Alike 3 es Administrator Login ent orm. (see see e Administration user f Alter su admin

equir ost). listed l curr omizing DSpace, Version 1.4.2 Version DSpace, omizing R selected l ( al schema), and select be display ( of the schema Cust [ Noncommercial- to the selecte how they are Move Field eld this metadata /dspace- admin orms (see ould to see ou have ved it from its existing metadata e- y current sh fi fields searchabl Attribution-

emove in the item n the to update r ow mo Authors/Contributors

and visit the DSpace /dspac (i n all so by n the namespace are space Commons o ess-to-my-dspace

d fields will al fields to. Once ore ow make these Registry” in order fields reative n ou may need existing metadata ose eb-addr page, you will find the © 2006-2007 y field tadata . w Administrator ss-to-my- th hen, click fields to the submission f f the ve under C T ). from display these fields ou can

one or m y ta or fields, metadata these b-addre d o mo http:// any items which previously used field licensed o move them to, click “Move”. we ( me s a DSpace t / ), and/ ), add ng a metadata work is

the bottom o owever, The selecte moved these For example, fields forms item metada At you can select you wish t schema Login a interface Click on the “Metadata within DSpace. metadata http:/ Movi H automatically (i.e. no This 4. 3. 1. 2. ● ● .. Notes: Files: Instructions: o.

ow t ow Move a Move H DSpace How-To Guide

]

18 a ent dc

it, n> to the s field. i or t

to f odify ? etc) Whereas, trac .0 License.

label the models or") n> act .abs

fields. use schema, replace r auth ge ptio bstr o have to m keyword, etc.) friendly tion Share Alike 3 hould correspond rties ls(" essa >

r element Cust o add dc.des o add auth trib ator e.* bjec escr [ Noncommercial- t n> %>>

<%= " ed.t existing “named indices”, contri indices for Authors/Contributors o the

packs ) page t nes Space ields all f the dc Space li hor" ed\" vanc example, f your new search f D nge ( ine by D author:dc author:dc title:dc. keyword:d abstract: nly searches o l

Commons

o ove Cha left of the col = = = = = "aut lect h.ad JSP (advanced.jsp)

ndex i schema's name. to Index ab language-

several reative see ou wish to specify a different f your search Re- Rebuild ( \"se earc ex.1 ex.2 ex.3 ex.4 ex.5 y © 2006-2007 attribute n n an entirely search i i If onfig/ value= “abstract” ) field to one o rties . In the sp/local/search/advanced.jsp under C n ted= sp.s .ind .ind .ind .ind .ind metadata f one o /j /c Fields dc all Dublin Core on search.index.# ( o ou will see earch s below: ther y onfig/dspace.cfg urce] urce] licensed ore a s o the steps the steps it s a guide. ins for ier> name Space

forms o “map” your collection’s ou will have to map it to ou will have to D “traditi t s lon y efau them sequentially a listed is , add a new omizing DSpace, Version 1.4.2 Version DSpace, omizing t> > ndividual section at the i qualif element for the type> alue - the XML Cust Rebuild /hin c- able - map> [ Noncommercial- v element ed. citation alue element, in edit collection ose v handle="d n nput numbering as desired, map>

estart input item.< schema> fier bula Attribution-

- atio x

standard Authors/Contributors

DSpace,

enti voca and edit Within them, add you just creat this /> cit alse on

Quick by the

attribute

Commons

of t>id y>f tati nal" a new your new default d collection-related name type>o

reative map

specific issued v s not used vocabulary i ollowi f since field. ocab SURVEY Share Alike 3 ontrolled c When enabled, re">

g controlled this v with structur AND true Y (in ) metadata listed omizing DSpace, Version 1.4.2 Version DSpace, omizing = y is disabled llowin "/> CTOR 8"> Cust ject able [ Noncommercial- Literatu it, uncomment the ia an XML (srsc.xml) – By default, ERAL RODU CCS9 the fo v a hierarchical is defined ral te y.en "GEN "INT "ACM dc.sub functionalit ( Gene o enable Attribution-

ular Authors/Contributors

. T generate Categories (nsi.xml) – Vocabularies t all label= label= label= ocab Subject " " " by ocabularies/) ocabularies/* vocabularies ould to redistribu Commons v v

label=" re: Index w dBy> By> led ledv Subjec cs98 re dBy> By> reative Guidelines pose osed with the trol © 2006-2007 id="A.0 id="A.1 pose osed control ontrolled- ontrolled- id="A." WAI ng structu structu under C Research ve .con > ... ip ents

ently

the the

NERA

ve n XML curr tag text

a repres is is never ::GE to use for a abo relationsh y>

General marked) .0 License.

and Th , but otes. L an item. ture the are

ular or f s in ). dBy> ocabulary f all terms ields GENERA on input forms (see v o Share Alike 3 o a term. by generating Litera t

n the o place your custom controlled for this term is is the Cust sion using the in the ote Rebuild t [ o ::Ge Noncommercial- ents n the wn documentation/n i GENERAL ed, the controlled

in Th a n o SURVEY bmis ored milar with the optional st ontrolled our term ( ormation, see si [dspace- c estart AND identifier )- repres y re example nd Attribution- achieved

) – gle ACMCCS98 R inf as being compo at selected

or a Authors/Contributors

Alter su which is an ag f RY specifies Vocabularies Once creat SURVEY all ore ture n the e.g. ) – a sin or this term. ocabulary Quick by optional m ocabularies/ f Structu L UCTO optional ( v Commons v a unique ou must specify

or AND ( ents his can be So, i y

preexisting ) – to” relationship betwe is useful a subject in DSpace o above. T optional is specified wn custom controlled vocabulary dBy> RY To> Litera t reative ontrolledvocabulary.xsd. a label the ( ierarchy, l is XML o if a submitter GENERA INTROD but – © 2006-2007 h e, terms. ide igned omcat (See - repres pose ture UCTO ated te> ontrolled- optional field. our en ( imilar T in th y under C 98 tag in the section ass label displayed id Genera ongs /docs/c “is related in the is a schema provided it s y> be al use a controlled ce] or displayed ● ● onfig/c licensed f term ACMCCS metadata ular /c re ould ■ ■ ■ There sour available ■ d w ● work is

actually image on previous page), specific within input-forms.xml. F

ow t ow Use Controlled Use H DSpace How-To Guide

] , 33

tive key

erna , elements .0 License. .alt ate) elements: ties: ed(d Share Alike 3 rties issu for its Dublin Core dc.title (French) or add new listed omizing DSpace, Version 1.4.2 Version DSpace, omizing le, Cust [ Noncommercial- em metadata em dc.date. = Title ordering of Dublin Core field, search ) in Messages.proper it ct, ive . = dc.tit /Messages.prope

(in dspace.cfg), . Attribution-

ult rnat Authors/Contributors

packs ult all Space defa alte metadata by D dc.subje defa Commons

lay. .*, tle. display, change the with language- lay. reative Rebuild disp utor er c.ti © 2006-2007 n disp i onfig/ under C item trib lish ta.d /c metadata display name of a metadata item onfig/dspace.cfg urce] displayed licensed hich will begin the steps metada webui. dc.con dc.pub /c (w webui.

work is

change the change the To name Perform To after [dspace] [dspace-so This 2. 3. 1. ● ● .. Files: Instructions: o.

ow t ow Change H DSpace How-To Guide ]

)

or In

o and Space Space lic t very ote: D D ld (N .pub whether ). It's o .0 License. ir sists of a set of our Rebuild if you change gins, errors statistics page) ) and general in report lo con ( o specify d, It Share Alike 3 Space estart report.d owever, ( R / /bin/ directory. ”) H of D downloads parse all of y ow you t listed omizing DSpace, Version 1.4.2 Version DSpace, omizing ored accessible performe nstalled!) Quick orts

i st space] (URL Cust [d s

[ Noncommercial- be of these. /rep our which all publicly e same as file g with “stat- stic ould dir} mcat (See ll analyze and sh statistics package which you can use statistics package which you Attribution- (e.g. searches

To not th wi ( Authors/Contributors

/stati HTML statistical reports. hould be all e beginnin s iews by dstat.map space iles Commons v = false ${dspace.

d basic web to restart and in DSpace Statistics ons in dspace.cfg = lic all f reports o generat reative n page scripts you must have Perl orget with © 2006-2007 ot want to change either f (i.e. .pub .dir ss-to-my- * log) t n't / under C these his statistics package l statistics /stat- b-addre report report the final statistical reports onfig/dspace.cfg onfig/dstat.cfg ormation o two basic opti licensed performed we fina [dspace] ption, do comes with a very / /bin /c /c inf o are to utilize our scripts all beginning with “stat-” in y work is

gs (in and where possible you may n either lo Perl order There not y DSpace gather activities warnings). T [dspace] [dspace] http:/ [dspace] This 2. 1. ● ● ● ● .. Instructions: Files: o.

ow t ow Use DSpace DSpace Use H DSpace How-To Guide

]

ogin needed. og) into in the stall,

/l orm values (dstat.map), ## dstat.cfg. in wn DSpace ou want f .0 License. y metadata URL) o unless space] by #### o do so. ist Author/Title ). [d our files: inimum accesses t or an f statistics ormation in l out of statistics sted with an asterisk which y in statistics #### on y li le Share Alike 3 fields s file of m ot display email) stat-* which appears field, out o e thi f your DSpace are o filter #### rch nfiguration file, terms f the t o do n og files (in o change these in statistics of items to l email inf l o listed omizing DSpace, Version 1.4.2 Version DSpace, omizing (marked sea t

number og directory #### items (i.e. ge the text htly based to filter dc.typ URL /l n the Cust f search [ Noncommercial- i nd s listed s own co DSpace log fi #### i Modify a chan number

false you can edit space] on't need viewed out o [d o update d to

#### o review: must for your . term specify the in the with it her imum scripts slig ou – Attribution- to display user

our index terms guage, special characters Authors/Contributors #### sted

ng section in each type The name

max omes all lan loor – c indicies, see * by ) defined #### s” which appear or search the search Commons at the top of the statistics page.

f you wish t e whether ollowi Lucene section. Y f – named Statistics alue ou may wish t actions li #### Statistics package comes with a mapping file v y used – reative n item full path of y types to find statistics for. Corresponds to the types to find statistics for. Corresponds So, i y ter search.f “action Lucen stopwords to filter a © 2006-2007 host.url specifies #### – – specifies – displayed or change the k for the to the search Item text. – and *– the p mmar rd pe arac under C a form e and – before on for in statistics (all ot Details Statistics package nge s some settings which you s some settings # ###### mail ame loor ooku .log l.su e.wo e.ty e.ch ype licensed on. Loo ha with an element Cha and a few that

user.e statistics. For privacy, this defaults host.n which will be item.f necessary item.l informati exclud item.t (see field list in the “Overview” exclud exclud (corresponds dspace genera s file work is

addition, the DSpace which maps DSpace human readabl statistics reports, First, you must modify each of these installati ● ● In ● ● ● ● ● ● The DSpace Thi below), ● ● This 5. 4. 3. .. (continued) o.

ow t ow Use DSpace DSpace Use H DSpace How-To Guide

]

e 36

, ) ory e

s a to l

i g the it if otal: the onc

t stat- scripts)

reports. n in rect tory. * , l variables o generat t run initia and output /dspace/ th runnin .0 License. f them optio t- th ) o be $in_di Its ir y HTML t about all of the genera _mon with six o _mon initial output direc /reports/). data which specifies Share Alike 3 initial /bin/sta (for stat-report- $start ough you can rerun - report- nly needs report.d $start

space] There's ather ll all start , th o report- n script [d that both the and i listed omizing DSpace, Version 1.4.2 Version DSpace, omizing istoric monthl . These should correspond r ariables: to g [dspace] its past results). stat- l once report l of this past data by

v in the , directory is h stat- Cust scripts! t- al [ Noncommercial- _yea paths wi run or sted perl initial o specify by

f these statistical reports nput li initia i odify any variable on script stat-* /bin/dsrun or monthly overwrite to be f the $start used year specified f the Attribution- o f the /bin/sta to run

to m Its output out f o space] Authors/Contributors monthly o initial report- ould

stat- [d report-

ou wish to start tracking statistics from. ou wish to start tracking statistics directory all ne , ocation (these ly needs o it w by l tat- tat- nth and the same location (e.g. [dspace] ou may wish t onthly reports Commons ay need an eye f the

* script. Again, this script y stat- the initializati o very be to the m report- e

o modify the above)! which can be the full path or file of m initial ou keep reative it as needed. perl the full path /bin/s /bin/s and – les tory imple, – © 2006-2007 s script (see un to run stat- e] e] onth which y fi , ou will likely need stat- ory tory m o wish t in which case under C irec , orrespond stat-report- a series ). Thi c the full path r initial to ( things s [dspac [dspac – rect irec you updated f a directory licensed ou can rer initial o In particular $out_d or Windows, or Windows, y _yea - s must year and F F general keep stat-

sure generate f historic data and You may als in the $out_d Thi your dspace.cfg To $dsrun $in_di work is

o that section, y Note: Note: ( ( Next, corresponding though y $start you needed set historic HTML reports. Make stat- report You will first need past months (back to the mo ● ● ● In full path default). ● ● This 9. 7. 8. 6. .. (continued) o.

ow t ow Use Dspace Statistics Dspace Use H DSpace How-To Guide

]

37 r

you

on the se ou may ) and a Space: stat- cron our will be stat- tho D ou may y e report path of ics based stat- .0 License. the at 1:30am and monthly o schedule e full hedul t corresponding to keep th er o installed a report to addition, y by adding a e /statist Share Alike 3 their y basis, though y y basis, though wh report- orresponding would run asks to sc c space] after o run monthly general ) T t [d onthl user listed omizing DSpace, Version 1.4.2 Version DSpace, omizing l generat for 12:30am and 12:35am stat- examples above, their d story of the repository ( story of the repository above). In site's statistical reports scripts . Just rememb y basis in order to run wil Cust hi [ Noncommercial- scripts and scripts to run nightly. report- report- monthly general monthly ess-to-my-dspace before the n the ed to change i tat- tat- tat- tat- schedule scripts these ). As in the stat- n a nightl l

at least on a m monthly Attribution- eb-addr crontab for the

scheduled to run o time of day hese w Authors/Contributors

OSX example run all /bin/s /bin/s /bin/s /bin/s perl ys be stat- o run by e] e] e] e] would be genera t g to the Commons )

use Windows Scheduled general scripts, your DSpace http:// corresponding report alwa Statistics them at ould would schedule reative llowin Note: You would ne [dspac [dspac [dspac [dspac Linux/Mac month (

general report- ould stat- at all times. T © 2006-2007 * * * * directory. OSX, you can schedule sh l statistics o the explicitly (e.g. under C and t scripts should be scripts should aggregating all activities aggregating all tively. * * * * * * * * stat- stat- to the fo s, you sh While their to-date ilar our 0 0 1 1 lar scripts f licensed immediately this current and and * 30 35 30 35 script. y l - report ommands at an appropriate (sim tively. monthly * simi running al c to call Perl want to schedule work is

need After available DSpace installation For Window same stat- scripts (The above cron entry monthl respec 1:35am respec genera report stat- For Linux or Mac entry The other even statistics up- activities general This 13. 12. 11. 10. .. (continued) o.

ow t ow Use DSpace DSpace Use H DSpace How-To Guide

] 38

o copy site: t ): into the

lowing our uilt PMH i_dc ) need .0 License.

sh to ngle line

y reb (It likely will OAI- x=oa si n a repository e URL PMH i or ou just in the fol f Tutorial from the tory. y r.html on a bas refi completely). ve) face Share Alike 3 e- e- e- e- opendoar.org/ OAI- abo ts ataP st and link back to y ), the listed omizing DSpace, Version 1.4.2 Version DSpace, omizing li /dspac /dspac /dspac /dspac interface, oaforum.org/tutorial/ is automaticall orma etad OAI-PMH rasprovide f all or a selection of items a repository ( pace

o Files Cust

on directions [ Noncommercial- is a Beginner's PMH ataF ds&m DS inter http://www. ommands) you may wi oai

dspace ormats supported dspace dspace dspace ollections) available /webapps/ direc http://roar.eprints.org/ c

f (see e- C uild ) interface there my- my- my- my- etad ecor ets ify

(i.e. arvesting your metadata Reb Attribution- http://www.

to- to- to- to- the OAI- ki.dspace.org/index.php/OaiInstallations Authors/Contributors [Tomcat] istM istR istS dent

/dspac ormation about s- s- s- s- the installati DSpace all before, (see MH MH Base URL arvest oai.war our inf by “verbs” i.e. Repositories: Registry: rb=L rb=L rb=L rb=I sts metadata example DSpace URLs should be e space Repositories: ( Commons

our d li o enable P all PMH y llowed t – addres addres addres addres http://wi PMH may h t?ve t?ve t?ve t?ve DSpace reative d rder Access OAI- web- web- web- web- © 2006-2007 with ( o thers / ques / ques / ques / ques to retriev ss-to-my- f you fo permits metadata i Listing: under C – Forum available at: used /build/dspace- Data Provider f Open h to register used of Open Access lists the “sets” ourself http://www.oaister.org/ basic OAI- dataFormats ou rebuil

oai.war file into y oai.war file into o – b-addre – http:/ oai/re http:/ oai/re http:/ oai/re http:/ oai/re OAI y r: there y urce] licensed never we PMH oai.war. In be / ns, so that o a few Archives Registry OAIste DSpace OAI- http://www.openarchives.org/data/registe Directory ListRecords ListSets ListMeta Identify ou've work is

y http://www.openarchives.org/pmh/ ● ● ● ● ● You may wis locatio ● ● ● Open Here's familiarize ● ( dspace- this dspace- already If [dspace-so http:/ Whenever This 4. 3. 2. ● ● 1. .. Instructions: Files: o.

ow t ow Use the OAI- the Use H DSpace How-To Guide

]

.* , a

) as ndle

Title But, ou

By size f a ( true dc.title will display owing two ) .0 License. URL. below). RSS feed: in. It's ough, you can our e URL to cache nstallation, y false i RSS feed a feed fields (so bas Alth Share Alike 3 as

to items via their our r f feeds using the foll ocal DSpace the section with the the section with y by setting it to .0 ued o l o offer field. DSpace , etc.) t listed omizing DSpace, Version 1.4.2 Version DSpace, omizing Date our o refe ss_2 le .iss URL our OAI-PMH t ): ike ( fields under l

tive all qualified Cust and ###### [ Noncommercial- age in RSS generally consists o ( oai metadata false or via y : the number erna feed(s) Title e- = gle of items to display in y e items in y ose n item eds = 48 rss_1.0,r = dc.tit = dc.date = 100 ou would true ocal DSpace .alt a

Attribution- to include

l o a sin Settings in dspace.cfg Authors/Contributors = ge solv tle te ize t

/dspac = false = 4 our all

fe y RSS 1.0 or RSS 2.0 (or both): by lable Feed he.a mats alre m.ti m.da ble ms he.s to cache a feed space

can map the Commons

d you can ch ariable dc.title ence , on ou avai ours .cac .for .loc .ite .ite .ena .ite .cac new/updated exactly which metadata either ou want your RSS nly accepts RSS formats y ontains an item's handle (specified reative . Y or se ) as a qualifier, c ormation about f * © 2006-2007 if y of h feed feed feed feed feed feed feed feed ( ss-to-my- ons o lowing v ons are RSS under C dc.title

to cho feeds Syndicati scription opti d

opti sterisk o customize o chose the b-addre De webui. webui. webui. webui. webui. webui. webui. webui. /hdl.handle.net/123456789/1) the fol onfig/dspace.cfg RSS to decide licensed we the RSS feed #### with performance, feed / /c an a f these ns: to set o and a as the number http:/ owing heading: work is

help enable specify would include Date optio Each you can change it to refer You can als for all items. The inf recommende You need (e.g. default, well You can als You can modify the maximum number You can modify the maximum To foll To need [dspace] http:/ All RSS This 7. 6. 5. 3. 4. 2. ● ● 1. .. Instructions: Files: o.

ow t ow Configure H DSpace How-To Guide ]

s a

n your (See o

n across ontinued f which will .0 License. ent \ ommunity or mcat c mepage. appear or, To f rec

(all o o is optio f each \ o , edit n th or at a C Share Alike 3 ields end tor. ptio listed omizing DSpace, Version 1.4.2 Version DSpace, omizing ow you can provide multiple ow you can provide with a feed ribu omepage) n ) at the dc.title ou similar to below) \ h Cust ( y [ Noncommercial- = if you expand n , but dc.descri ons, you must restart

specify a list of f specify a list of ER: dc.cont ptio t, opti eds buttons above ommunity and Collection ho the changes to take effect. Attribution- on DSpace

C ( Authors/Contributors or scri hor, trac

a backslash ( feed Date ) f all REMEMB fe our by level m.de .aut .abs RSS feed Commons and

description of an item). The format is the same description of Space ou can actually D buttons will provide mas. ( ll of y .ite utor tion Title , y a reative f the r more the site o © 2006-2007 o as well as each feed trib crip f these ne RSS Rebuild by com under C o either scription the RSS in example below) as part De or see

s at dc.des webui. dc.con f mepage, n one o licensed lines, you must include lines, you must estart ho ould R separated you've specified work is

displayed Collection level. Quick You sh DSpace Clicking o submission line, as in the Once For the RSS be mentioned fields multiple This 10. 9. 8. .. (continued) o.

ow t ow Configure H DSpace How-To Guide

]

)

it o it, y

optio earlier t

ingle database -p

matches checksum (either hich appear timeframe .0 License. (defaults timeframe w More that database ong a s ), years ( /checker) the to recover w the /bin changed able being that the file submitted to keep or unsuccessful database Share Alike 3 ons. Valid timeframes ecker database. item within DSpace. all successful the default ored! ), weeks ( idea d [dspace] n specifies w from your DSpace if you specify the opti ( he ign listed omizing DSpace, Version 1.4.2 Version DSpace, omizing ch those regarding T (in order ons specify how l from the #### CH=8 DSpace optio 8 weeks, kely you'd be Checksum Checker script f these ), days ( ly used Cust CH [ li Noncommercial- our h o are all successful o irus). 10y _MAT removed ( they are on e, ption specifies _MAT checksum of every or v ll be removed o or not a file has been or not a file has ours ion ult= KSUM Checker Settings ns for the checksum of every wi the Attribution- ), h or either the more

ult KSUM 10 years, m f Authors/Contributors defa CHEC

( ksum ksum all settings are change). defa CHEC whether retent by e from your database y ion. ion. checks are arge). nutes Commons d f corruption Checker his means that after “match”

o f dspace.cfg: ion. ion. from the database. s changed, T ows: to verify the and records tent tent ), mi below). Otherwis ort d iguration optio reative s ha g too l s ny timeframe tent tent histor © 2006-2007 a ot a wanted r.re r.re (see checksum me shown below). These two opti hould most pay attention t

Checksum conf ( chec

his means that after under C all removed r.re r.re these retention calculates ory schedule T check to 8 weeks). /checker are ote, seconds ( # checke checke #### w comes with a Checksum w comes with a checker verification action is kept within y verification action is kept within is able to determin onfig/dspace.cfg n owing section o several on on each foll licensed hist ons you s from growin which a successful which checke checke no /bin /c oll automatically delete are f DSpace Please for the 10 years). matches You can specify include: (defaults are table The after The after work is

● ● ● ● The opti retention checksum informati (assuming it was n There in the which can be Since this script manually or by so you can identify a file [dspace] [dspace] DSpace This 3. 2. ● ● 1. .. Instructions: Files: o.

ow t ow Configure H DSpace How-To Guide

]

ons. n)

nly not

large ( n how every y

o ose opti who are next 10 optio s n a week to o by that omcat (See th command o onl 1h T ld results t .0 License. o check repository y the o t withi -d entry similar to ecommended for R checker within dspace.cfg. o onl s several t (e.g. cron e database table may to restart the dspace.cfg ng you keep Share Alike 3 DSpace: ecker our the checker ) specifies or o a factor. For very l to run for 2 hours. The f repository p - also ha ortion of their running it weekly. ow lo - automatically, based his tells the an h stalled listed it left off). ( omizing DSpace, Version 1.4.2 Version DSpace, omizing s tells h L ( ch a p nly want to check a portion o or op through the repository f ). T to actually remove a few hours maximum) An by adding a b ou will need checker o run Cust -d2h - [ Noncommercial- settings specified t ). Thi y it who in o run -a n just o may o s are ignored and th his limits the check ( cker i ystems) it t repository is als /bin/checker) Recommended for smaller repositorie wh Mode ( ). T instance (and c the changes to take affect. the changes to Attribution-

). A lowercase our retention his tells the - the user ntinuously lo Mode L as mentioned above Authors/Contributors or y want to check

space] dspace.cfg, or ksum ksum ) f ). T all [d f d /bin/che n the ( to co by or - - andle y onl o ). Tells the checker epositories tention setting Commons to schedule

Mode ( repository s can likely get by with just will always start where will always start Bitstreams H vailable f: Space -p -l st n in the with internal IDs of 111 and 112. with internal IDs of 111 and 112. Checksum Checker D a evening) ( o script it makes it through your entire your DSpace ount reative based the OSX, you can schedule are who ma [dspace] C within the Item/Collection/Community specified within the Item/Collection/Community © 2006-2007 ) specifies ay need repository once. (

checker y optio for mo aware -L m ) d chec Rebuild = Specific = Specific ( under C pruning ( an Checker repositories ng to the crontab ou n the bitstreams * 0 (the L in i er large! y ou backup database oping Mode schedule oop through all their content this option, the re 112

s to be y epositories = Duration Mode ( = Limited case licensed bitstreams 4 * timeframes around for). The size of y repository each evening ollowi maller 0 estart to l = Lo ould f = Enable R ently ok at the a 1234/12 l p d 2h b 111 c 10 evening to ensure Recommended for larger r the For Linux or Mac from the Without grow rath able upper recommende - - check handle. - bitstream same ( their - lo bitstreams larger r each - - ou changed work is

y backups repositories, each or so. S ● You sh frequ ● ● ● ● ● If Quick The Checksum line option ● This 6. 4. 5. .. (continued) o.

ow t ow Configure H DSpace How-To Guide

]

every

ou based [dspace] y results). o run e Instead, t .0 License. it's still a m each owing l the it: 8a p reports database script. - the checker scripts lity, but the foll the hell Share Alike 3 listing the Checksum sent at eed to chang ecker after s

n -d2h o run -a -a t DSpace: entry similar to the ot contain al ould ) ) listed o run omizing DSpace, Version 1.4.2 Version DSpace, omizing ler ler cker ks to schedule ch ) below) ) for combined cron

o schedule checker it t

to “prune” Tas -c Cust Emai Emai mChe [ Noncommercial- You w d o this email script: checksums changed the o installed t

se -m asks t the email to be the checker for this functiona nother port port cksu un directory. T Note: email may n general command. However, wh a automated emails time(s):

bitstreams o use e who t The above command should appear on a single o specifies

the Attribution-

to schedule

lyRe lyRe .Che user bitstreams Authors/Contributors

als d ksum ksum all ing bitstreams ptions (e.g. /bin/dsr .Dai .bat .Dai .bat cker the same unable appear on a single line. appear on a single line. by o shell script o results. ndows Schedule Commons

(everything specified appropriate s you can specify n dspace.cfg. would schedule would schedule ours. It cker srun cker srun .che is n ose to receiv n delete n miss n bitstreams n un-checked Wi hould hould o o o o s s reative 2 h OSX, you can add use ption r DSpace installation [dspace] .che .che .app © 2006-2007 or crontab for the Just make sure

o o combine /bin/d /bin/d There you ge. chec settings i ould s, you can use s, you will be under C pace e] pace e] pace use Windows Scheduled use Windows o the * 0 ou may cho nly report nly report nly report nly report a few s processing (otherwise reporting all the at 4am f it ould path of results. = o = o = o = o = send all results licensed are 8 * d m c u a ously sh org.ds [dspac org.ds 0 [dspac org.ds ) - - - - You can als - owing t retention easy chan The above command The above command ( Sunday, line. For Window obvi foll (The above cron entry ○ ○ ○ For Linux or Mac There ○ ○ ○ you sh at the command to run ( (The above cron entry (The above cron Sunday the the full For Window work is

● ● ● Optionally, y Checkers' rather completed ● This 7. .. (continued) o.

ow t ow Configure H DSpace How-To Guide

]

44 g to

tech our ce/ terms. the

ace- .0 License.

dspa stack listin q rvlet search stack listing. message should to the DSpace =dsp . cts/ could be alFa g list for error DSpace og ssh message. error useful orum Share Alike 3 roje ot, hnic code he s the mailin a T / hp?f et/p /Tec g with the listed omizing DSpace, Version 1.4.2 Version DSpace, omizing ource leaving a blank browser tech the error logs s ) often are dspace.l um.p / or and open dspace.log in y ge.n .org alon Cust (OR)

[ Noncommercial- listing. If n ome

ually -100 /for tory,

efor us . pace appears, to ten lines of the error or s in dspace.cfg to: error [Tomcat]

with a servlet. ve error the dspace- net hive lar tail ourc in the error fi i.ds or Attribution-

g direc nd a JSP the bottom f … … of the error Authors/Contributors a or the

lo rge. larc ogs (usually) simi f ords and /src/org/dspace/app/webui/se

all /wik is set up /l ne w ce] by an imply never Error, Commons cefo /mai

Space http://s ok near WARN ERROR ost certainly

g list: og/dspace.log ( og/dspace.log Key D /dspace.log /l http:/ Lo sour .net [Tomcat] reative

FAQ: email address [d sp/local/ nformation s editor.

under C tech i check your email /j mm-dd mm-dd our rcef ed to the log directory culprit [dspace] text

y DSpace g file: ows) Go cd an Internal on on the error. stack starts urce] licensed

If tech@li og directory: yyyy- yyyy- lo technical Sourceforge l - /sou directory: the problem orite the dspace- (Wind fav ou get work is

mcat in either all else fails, email a description y the expect ● If dspace Search informati machine, Usually, the The error screen, be If problem. administrator, Search http:/ If DSpace DSpace DSpace To [dspace-so Servlet This sites: 5. 4. 3. 2. ● 1. ● ● ● ● ● ● .. Instructions: Web Directories/files: o.

ow t ow Troubleshoot Troubleshoot H DSpace How-To Guide 45 .

.0 License Share Alike 3 listed Noncommercial- Manakin, Attribution-

Authors/Contributors

all by Commons

This DSpace How-To Guide ] 46

mcat mcat o t n code op To for both sure ploy .0 License. ) platforms. to st to start To kin, Version 1.1 Version kin, 2/de owever, ther s) all Manaki H and s/3. Share Alike 3 (“Application Server”) (“Application Server”) h sh change jbos site) as with o n (e.g. ssh). Make mcat mcat listed omizing Mana omizing eb up.s own. otification Area) otification Area) Manakin! (recompiles / used

OS X server. Cust op To [ Noncommercial- tart hutd nfiguration ars wn the w /library/ library/jboss/3.2/deploy

/ have one already),

DSpace / ar /bin/s /bin/s n’t with Mac Attribution-

Monitor (in N Monitor (in N Authors/Contributors n

Admin to st Admin to start To omcat may be rver after co build_w

all b se Manakin is running o by [Tomcat] [Tomcat] y installed

nstalled urce] /webapps / Commons i

Service Service build/*.w Server Server OS X Server: so this will bring do e we / Manaki cp mcat mcat reative

starts th

.war file) wh [manakin- X / X / under C urce] st re desktop editions T desktop editions ce] (WARNING:

so .war OS OS user (Ju a new

/ / JBOSS comes pre- sour and urce] licensed (Quick build after smaller changes)

Manakin OS X Server) OS X Serve OS X Serve /webapps/ mcat mcat Ddspace= a command prompt (if you do start To Mac Mac Note: sever on to the server - (Mac (Linux ( (Windows) Use To ( (Windows) Use To (Linux work is [manakin-

build/* gin as the ○ ● Test changes in DSpace ant and builds cp Log lo Open cd ● ● ● ● ● Start Stop To ● [dspace-so [manakin- [Tomcat] This 5. 3. 4. 1. 2. 2. 1. ● ● ● .. Quick Build: Quick Re Directories: o.

ow t ow Rebuild H DSpace How-To Guide

] 47

or y

r”) mcat mcat f o t an loy ectory!

Server”) op To sure ploy /dep .0 License. to st to start To kin, Version 1.1 Version kin, o remove dspace 2/de

/3.2 ). Make e wrong dir or ssh and s/3. Share Alike 3 boss all Manakin and builds so wish t h sh jbos ry/j site) manakin n (e.g. mcat (“Application listed omizing Mana omizing omcat (“Application Serve eb up.s own. otification Area) otification Area) Manakin! T / Cust /libra [ Noncommercial-

(recompiles tart hutd s ( o start o stop To in st wn the w Manakin) /library/ t t d

ps of remove any have one already), DSpace ar /bin/s /bin/s alho ode) / n’t Attribution-

c Monitor (in N Monitor (in N create esh all Authors/Contributors

Admin Admin /webap everything, you may al es build_war /loc all

t] Manakin is running o Manakin is running by / Manakin [Tomcat] [Tomcat] y installed

ce] / Commons

Service Service lina /webapps build/*.w ) Completely Server Server this will bring do directori cp CAREFUL…you don’t want to remove th CAREFUL…you don’t want to mcat mcat reative Cata Use Use [Tomca DSpace ) r) o initiall r) © 2006-2007 BE Solaris) Solaris) DSpace

(Completely refr in

space-sour [Tomcat] -

d file) wh [d r) dspace X / X / under C ecommended /work/ urce] (WARNING: omcat to recompile

so .war or OS OS (removes old compiled t] user

ut r T create / / b licensed Manakin OS X Server es Rebuild: OS X Serve OS X Serve mcat mcat force Ddspace= fresh .war a command prompt (if you do a command prompt o To Mac OS X Serve on to the server clean - T manakin [Tomca ( (Linux (Mac (Windows) Use To (Linux (Mac (Windows) Use To work is [manakin-

build/*

gin as the Optional, ● ● efresh/ Test your changes in Start ● ● ● Mac cp ( directori Stop To ● ● ● cd ant ant a new Log lo Open This R 9. 8. 6. 7. 5. 3. 4. 1. 2. .. Full (continued) o.

ow t ow Rebuild H DSpace How-To Guide

] 48

”/>

will dir] - hus, if dir] - T ll to the [theme- .0 License. ile. themes on for the [theme kin, Version 1.1 Version kin, her y your new as below: ”/> [theme s/ with Manakin then with Manakin path=” is) o ot ed ” n dir] Share Alike 3 ode next step. /theme element new locati c

path=” 23/1 ): ) then then modif n the listed omizing Mana omizing .*” g/xmlui.xconf, scro [theme- ource community or collection then ot distribut s in the xmlui.xconf f source] kip to the Cust [ theme Noncommercial- s Manaki

/confi handle=”1 s will be in- eme defined

path=” regex=” th uild that is n appear default space] herwise Reb (Thi Attribution- [d e last

[manak

any other themes they new theme's

Authors/Contributors nto a particular

inside the in theme” theme element. o as the all theme” theme” the by eme-dir] before new new Commons e

new new [th tag as:

source] y y element

reative in the order

ure this tag is th Quick Restart

/themes/

under C name=”M name=”M nstall this theme nstall this theme rce] make ce] ollowi ”/> f evaluated [new- tag theme

onfig/ installin sour tag ( licensed omcat (See

the source) dir] /c T a them Manakin's co a new

ou wish to i ou wish to i ou are work is default w-theme-sou

used. y y y Themes are the be

ow t ow Install H DSpace How-To Guide

] 49 in

] or

f the sheets and eme-dir yle edit [th IE) .0 License. nd a new copy

or a as kin, Version 1.1 Version kin, f two st name> version just ed directory e- are the . ] Share Alike 3 ylesheet there The theme's referenc listed omizing Mana omizing /sitemap.xmap, eme] (CSS st [theme-dir e-

from scratch, make will be Cust [ Noncommercial- by default /style.css /style-ie.css ame eme-dir] ons> ns> then a supplemental your th new theme

completely or s Authors/Contributors

eme-dir] e name of f [th [th nakin s> es> all [th [th heme me /themes/ in a new eme-dir eme-dir] eme-dir] by Ma

configu a t Commons

configur ce] - na the /theme [th [th [th directory; [theme-dir] all browsers path> name> ce] new theme tall variabl /themes/ /themes/ sour tory or reative variable ent- - nent emplate Ins Rebuild ce] ce] our sour © 2006-2007 theme's CSS stylesheets, theme's sitemap n n i i hown below: mpon ompo /themes/ /themes/ /themes/ sour sour /themes/ s

obal Perform Perform Next used Interne Next name. gl Instead of the First dete [manakin- these [manakin- configuration) [manakin- [manakin- This 7. 8. 6. 5. 2. 1. ● ● ● .. Instructions: Files: o.

ow t ow Create Create H DSpace How-To Guide ] 50

the and and ylesheet) .0 License. st side kin, Version 1.1 Version kin, inside the in r” Share Alike 3 theme's

he ooter ocal template.xsl ocal template.xsl f l l heme listed omizing Mana omizing (T t “buildHeade “buildFooter” "> "> Cust [ Noncommercial- theme's theme's ural.xsl a new ader oter named or or named our our reate ldHe ldFo /template.xsl Attribution- C

Authors/Contributors into y into y

to template all by the eme-dir] the template Commons

[th name="bui name="bui

ocate you need l reative ate> te ate> te locate © 2006-2007 empl mpla empl mpla oter, /themes/ /themes/dri2xhtml/struct opy this template opy this template under C C C ...... ce] ce] sour sour licensed ral.xsl. ral.xsl.

modify the fo modify the header, y modify the XSLT as needed. To structu To structu modify the XSLT as needed. [manakin- [manakin- If This 3. 2. ● ● 1. .. Instructions: Files: o.

ow t ow Customize header Customize H DSpace How-To Guide

]

i the

owing n the i oll that

o that the f the (or ” s DIM"> ylesheet) the .0 License. is called st kin, Version 1.1 Version kin, er) element such as dc.type, " > and 1.0- td> ' remove (DIM metadata handler) field. 1.0-DIM” inside lifi behavior. de() n>

he his is the template ::no t- METS- display ore a qualifier, T [ dc _DS- default nother heme listed omizing Mana omizing : =" d[@e to o /template.xsl Attribution- C record).

[dc qu , co tadata Authors/Contributors

row"> Metadata) to bold fiel =' e all to add to remove adding does not h by [dc qualifier] above into y eme-dir] class=" Commons

dim: fier =' [th with a qualifier. table- of select name="ite

row, ow full item you need is an example: reative class=" ds- py- te ate> template template fier

identified Intermediat table field you are mpla empl the /themes/ /themes/dri2xhtml/DS- $data/ @quali under C . . . . s will allow the theme clicks sh @quali on. Here

ce] ce] em me em core “ class=" ot match fields

modify the copied modify the copied the dublin y then rule To comment out) the If stylesheet. To table desire Copy the template Locate base used when [manakin- [manakin- If This 5. ● 4. 3. 2. ● ● 1. .. Notes: Instructions: Files: o.

ow t ow Modify Modify H DSpace How-To Guide ]

s i will the

"> by page that

y DIM"> ylesheet) .0 License. handler) st kin, Version 1.1 Version kin, is used. browse 1.0- > > xt> behavior. n the 1.0-DIM” inside dc.type Share Alike 3 o. The image used theme's xt> metadata METS- og he path"/ path"/ l his is the template displa e- _DS- e- default METS- T (DIM heme listed omizing Mana omizing them List > them for the Cust theme's local template.xsl [ Noncommercial- wn.jpg handler. a new src" mary src" our example METS-1.0-DIM.xsl METS-1.0-DIM.xsl n a larger verrid element /image.jpg /unkno

reate mSum to o /template.xsl n the Attribution- select="$ select="$ C

i with i item's Authors/Contributors

$data/dim:field[@element='type']='image' name=" name=" s ... to Metadata) of of e te> > e ute> all e /images /images item logo”> field, by above into y eme-dir] Commons

ise> ibut lue- xt> ribu wise ibut lue- xt> trib m- [th test=" name="ite

oth

identified Intermediat mpla empl /themes/ /themes/dri2xhtml/DS-

ce] ce] ... add class= template results.

based y Copy the template stylesheet. Modify the be If Locate base used and search [manakin- [manakin- logos This

3. 4. 1. 2. ● ● .. Instructions: Files: o.

ow t ow Add H DSpace How-To Guide ]

a be ould

w the gues or ou f > y .0 License. (i.e. neatness find ogues) kin, Version 1.1 Version kin, ogue) you will find it n catalogue. or text f new key. Add where i18 nd .xml our Share Alike 3 the > templates key is unique, listed ou use omizing Mana omizing f the messages.xml catalo wkey 18n) o into the XSL, but text n-English i18n catal n-English i18n Cust [ Noncommercial- n the .mynew on prefix (i myne i me [language & locale] such as: directly eme.

(no Authors/Contributors urth rules, sure

ther nakin .you new key: and modify the relevant and modify the all the text odifying text messages.xml (English i18n catal messages.xml messages confi by Ma with the comm our key! Commons & "e; ' < > adding an Make

mlui page page gue, into o on g/i18n/ g/i18n/ xmlui.yo

template reative Rebuild my new imply add © 2006-2007 catalo s n XML escaping xt> key="x i the text e ge> to appear. templates) /confi /confi ges of under C to a to becomes becomes becomes becomes becomes ce] ce] ourse, to use when adding or m ooter Text t sour sour messa theme's XSL licensed er, corresponding to y

new text or f ne to translate the the careful li work is key values for that begin

Rememb very i18n = internationalizati You can, of c easier Perform Open the new Open header like the example: [manakin- [manakin- This tex ● ● ● 3. 2. 1. ● ● .. Notes: Instructions: Files: o.

ow t ow Add H DSpace How-To Guide ] 54

ource) s ll to the [aspec .0 License. / is) kin, Version 1.1 Version kin, s below: with Manakin a ode /"/> Aspect's next step. c ed ir] Share Alike 3 /aspects o the ect-d ource ) element s

) > n [asp on for the listed omizing Mana omizing skip t g/xmlui.xconf, scro ot distribut source] - Cust [ Noncommercial- Aspect's Manaki path=" /confi

that is n uild new locati e on a single line space] b

[manakin Reb the Attribution- the new [d

Aspect" ] Authors/Contributors element.

in Aspect > hould all inside the s ect-dir] by new s where s will be new

Commons

source [asp g operations, otherwise My (Thi (Thi

Quick Restart

onfig/ installin sour licensed omcat (See cp dir]

preform ou are work is w-aspect-so

y Add Restart Open bottom and locate the If then [ne [manakin- [dspace] This 3. 4. 2. 1. ● ● ● .. Instructions: Files: o.

ow t ow Install H DSpace How-To Guide

] 55

o o g to the ed

manakin message ogin t l turned ging, edit ace- .0 License. Re- stack listin o be kin, Version 1.1 Version kin, t s log hown below: =dsp error need server. oon' as s i/ orum Share Alike 3 UG"> ogs/( xmlu n Coc iguration. The error hp?f "DEB o g with the listed omizing Mana omizing leaving a blank browser it means that you've restart o DEBUG on with the cts/ ) um.p t Cust alon . [ Noncommercial- level= ) error ually roje sessi et /for us /WEB-INF/l appears, omcat's conf our ually og-level du/p l n ID” log- y error ge.n hive us "

Attribution-

of the error webapp] Authors/Contributors mu.e

[ efor larc ogs ( emap all /l itemap's by an imply never o resume ormation you can turn i.ta s Commons ourc /mai t iling list:

/ og/dspace.log ( og/dspace.log is likely with T /l ng inf logs ts.s .net [Tomcat] reative

oggi http://d space]

@lis orge l ry [d nformation s

under C manakin ma i an “Invalid Continuatio [tomcat] [Tomcat] server e rcef ed more g file: in licensed ogs: manakin og directory: mcat / Manakin lo l - /sou then the problem be

mcat ould gkit.xconf file. Change the all else fails, email a description y the expect y If dspace your To DSpace If lo If screen, sh If Manakin website: Search http:/ DSpace To Coco This sites: 4. 3. 1. 2. ● ● ● ● ● .. Instructions: Web Directories/files: o.

ow t ow Troubleshoot Troubleshoot H

Thi template (DSpace sour sour n licensed it positi