DSpace 1.8 Documentation DSpace 1.8 Documentation Author: The DSpace Developer Team Date: 03 November 2011 URL: https://wiki.duraspace.org/display/DSDOC18 Page 1 of 621 DSpace 1.8 Documentation Table of Contents 1 Preface _____________________________________________________________________________ 13 1.1 Release Notes ____________________________________________________________________ 13 2 Introduction __________________________________________________________________________ 15 3 Functional Overview ___________________________________________________________________ 17 3.1 Data Model ______________________________________________________________________ 17 3.2 Plugin Manager ___________________________________________________________________ 19 3.3 Metadata ________________________________________________________________________ 19 3.4 Packager Plugins _________________________________________________________________ 20 3.5 Crosswalk Plugins _________________________________________________________________ 21 3.6 E-People and Groups ______________________________________________________________ 21 3.6.1 E-Person __________________________________________________________________ 21 3.6.2 Groups ____________________________________________________________________ 22 3.7 Authentication ____________________________________________________________________ 22 3.8 Authorization _____________________________________________________________________ 22 3.9 Ingest Process and Workflow ________________________________________________________ 24 3.9.1 Workflow Steps _____________________________________________________________ 25 3.10 Supervision and Collaboration _______________________________________________________ 26 3.11 Handles _________________________________________________________________________ 26 3.12 Bitstream 'Persistent' Identifiers ______________________________________________________ 27 3.13 Storage Resource Broker (SRB) Support _______________________________________________ 28 3.14 Search and Browse ________________________________________________________________ 28 3.15 HTML Support ____________________________________________________________________ 29 3.16 OAI Support ______________________________________________________________________ 30 3.17 SWORD Support __________________________________________________________________ 30 3.18 OpenURL Support _________________________________________________________________ 30 3.19 Creative Commons Support _________________________________________________________ 31 3.20 Subscriptions _____________________________________________________________________ 31 3.21 Import and Export _________________________________________________________________ 31 3.22 Registration ______________________________________________________________________ 31 3.23 Statistics ________________________________________________________________________ 32 3.23.1 System Statistics ____________________________________________________________ 32 3.23.2 Item, Collection and Community Usage Statistics ___________________________________ 32 3.24 Checksum Checker ________________________________________________________________ 33 3.25 Usage Instrumentation _____________________________________________________________ 33 3.26 Choice Management and Authority Control _____________________________________________ 33 3.26.1 Introduction and Motivation ____________________________________________________ 34 4 Installation ___________________________________________________________________________ 36 4.1 For the Impatient __________________________________________________________________ 36 4.2 Prerequisite Software ______________________________________________________________ 55 Page 2 of 621 DSpace 1.8 Documentation 4.2.1 UNIX-like OS or Microsoft Windows _____________________________________________ 36 4.2.2 Oracle Java JDK 6 (standard SDK is fine, you don't need J2EE) _______________________ 37 4.2.3 Apache Maven 2.2.x or higher (Java build tool) _____________________________________ 37 4.2.4 Apache Ant 1.8 or later (Java build tool) __________________________________________ 38 4.2.5 Relational Database: (PostgreSQL or Oracle). _____________________________________ 38 4.2.6 Servlet Engine: (Apache Tomcat 5.5 or 6, Jetty, Caucho Resin or equivalent). ____________ 39 4.2.7 Perl (only required for [dspace]/bin/dspace-info.pl) __________________________________ 40 4.3 Installation Instructions _____________________________________________________________ 40 4.3.1 Overview of Install Options ____________________________________________________ 40 4.3.2 Overview of DSpace Directories ________________________________________________ 41 4.3.3 Installation _________________________________________________________________ 42 4.4 Advanced Installation ______________________________________________________________ 46 4.4.1 'cron' Jobs _________________________________________________________________ 46 4.4.2 Multilingual Installation ________________________________________________________ 47 4.4.3 DSpace over HTTPS _________________________________________________________ 47 4.4.4 The Handle Server ___________________________________________________________ 51 4.4.5 Google and HTML sitemaps ___________________________________________________ 53 4.4.6 DSpace Statistics ____________________________________________________________ 54 4.4.7 Manually Installing/Updating GeoLite Database File _________________________________ 55 4.5 Windows Installation _______________________________________________________________ 55 4.5.1 Installation Steps ____________________________________________________________ 56 4.6 Checking Your Installation ___________________________________________________________ 57 4.7 Known Bugs _____________________________________________________________________ 58 4.8 Common Problems ________________________________________________________________ 58 4.8.1 Common Installation Issues ____________________________________________________ 58 4.8.2 General DSpace Issues _______________________________________________________ 60 5 Upgrading a DSpace Installation __________________________________________________________ 62 5.1 Upgrading From 1.7.x to 1.8.x ________________________________________________________ 62 5.1.1 Backup your DSpace _________________________________________________________ 63 5.1.2 Upgrade Steps ______________________________________________________________ 64 5.2 Upgrading From 1.7 to 1.7.x _________________________________________________________ 68 5.2.1 Upgrade Steps ______________________________________________________________ 68 5.3 Upgrading From 1.6.x to 1.7.x ________________________________________________________ 69 5.3.1 Upgrade Steps ______________________________________________________________ 69 5.4 Upgrading From 1.6 to 1.6.x _________________________________________________________ 79 5.4.1 Upgrade Steps ______________________________________________________________ 80 5.5 Upgrading From 1.5.x to 1.6.x ________________________________________________________ 81 5.5.1 Upgrade Steps ______________________________________________________________ 82 5.6 Upgrading From 1.5 or 1.5.1 to 1.5.2 __________________________________________________ 94 5.6.1 Upgrade Steps ______________________________________________________________ 95 5.7 Upgrading From 1.4.2 to 1.5 ________________________________________________________ 104 5.7.1 Upgrade Steps _____________________________________________________________ 104 5.8 Upgrading From 1.4.1 to 1.4.2 ______________________________________________________ 109 Page 3 of 621 DSpace 1.8 Documentation 5.8.1 Upgrade Steps _____________________________________________________________ 109 5.9 Upgrading From 1.4 to 1.4.x ________________________________________________________ 109 5.9.1 Upgrade Steps _____________________________________________________________ 109 5.10 Upgrading From 1.3.2 to 1.4.x _______________________________________________________ 111 5.10.1 Upgrade Steps _____________________________________________________________ 111 5.11 Upgrading From 1.3.1 to 1.3.2 ______________________________________________________ 114 5.11.1 Upgrade Steps _____________________________________________________________ 114 5.12 Upgrading From 1.2.x to 1.3.x _______________________________________________________ 115 5.12.1 Upgrade Steps _____________________________________________________________ 115 5.13 Upgrading From 1.2.1 to 1.2.2 ______________________________________________________ 116 5.13.1 Upgrade Steps _____________________________________________________________ 117 5.14 Upgrading From 1.2 to 1.2.1 ________________________________________________________ 118 5.14.1 Upgrade Steps _____________________________________________________________ 118 5.15 Upgrading From 1.1.x to 1.2 ________________________________________________________ 120 5.15.1 Upgrade Steps _____________________________________________________________ 120 5.16 Upgrading From 1.1 to 1.1.1 ________________________________________________________ 123 5.16.1 Upgrade Steps _____________________________________________________________ 124 5.17 Upgrading From 1.0.1 to 1.1 ________________________________________________________ 124 5.17.1 Upgrade Steps _____________________________________________________________ 124 6 Configuration ________________________________________________________________________ 128 6.1 General Configuration _____________________________________________________________