DSpace System Docu- mentation Mark Diggory Version: 5 Date: 12/31/09 Creator: Mark Diggory Created by a Scroll Wiki Exporter Community License - http://www.k15t.com/scroll Table of Contents 1. Introduction ...................................................................................................................... 4 2. Functional Overview .......................................................................................................... 4 2.1. Data Model ............................................................................................................ 5 2.2. Plugin Manager ...................................................................................................... 7 2.3. Metadata ............................................................................................................... 7 2.4. Packager Plugins .................................................................................................... 8 2.5. Crosswalk Plugins ................................................................................................... 8 2.6. E-People and Groups ............................................................................................... 8 2.7. Authentication ........................................................................................................ 9 2.8. Authorization ......................................................................................................... 9 2.9. Ingest Process and Workflow .................................................................................. 10 2.10. Supervision and Collaboration ............................................................................... 12 2.11. Handles ............................................................................................................. 12 2.12. Bitstream 'Persistent' Identifiers .............................................................................. 13 2.13. Storage Resource Broker (SRB) Support .................................................................. 14 2.14. Search and Browse .............................................................................................. 14 2.15. HTML Support ................................................................................................... 14 2.16. OAI Support ....................................................................................................... 15 2.17. OpenURL Support ............................................................................................... 15 2.18. Creative Commons Support ................................................................................... 15 2.19. Subscriptions ...................................................................................................... 16 2.20. Import and Export ............................................................................................... 16 2.21. Registration ........................................................................................................ 16 2.22. Statistics ............................................................................................................ 16 2.23. Checksum Checker .............................................................................................. 17 2.24. Usage Instrumentation .......................................................................................... 17 3. Installation ..................................................................................................................... 17 3.1. For the Impatient .................................................................................................. 17 3.2. Prerequisite Software ............................................................................................. 17 3.3. Installation Options ............................................................................................... 19 3.4. Advanced Installation ............................................................................................. 23 3.5. Windows Installation ............................................................................................. 29 3.6. Checking Your Installation ..................................................................................... 30 3.7. Known Bugs ........................................................................................................ 30 3.8. Common Problems ................................................................................................ 30 4. Upgrading a DSpace Installation ........................................................................................ 32 4.1. Upgrading from 1.5.x to 1.6 .................................................................................... 32 4.2. Upgrading From 1.5 or 1.5.1 to 1.5.2 ........................................................................ 40 4.3. Upgrading From 1.4.2 to 1.5 ................................................................................... 46 4.4. Upgrading From 1.4.1 to 1.4.2 ................................................................................. 50 4.5. Upgrading From 1.4 to 1.4.x ................................................................................... 50 4.6. Upgrading From 1.3.2 to 1.4.x ................................................................................. 53 4.7. Upgrading From 1.3.1 to 1.3.2 ................................................................................. 55 4.8. Upgrading From 1.2.x to 1.3.x ................................................................................. 56 4.9. Upgrading From 1.2.1 to 1.2.2 ................................................................................. 57 4.10. Upgrading From 1.2 to 1.2.1 ................................................................................. 58 4.11. Upgrading From 1.1 (or 1.1.1) to 1.2 ...................................................................... 59 4.12. Upgrading From 1.1 to 1.1.1 ................................................................................. 62 4.13. Upgrading From 1.0.1 to 1.1 ................................................................................. 62 5. Configuration and Customization ........................................................................................ 64 5.1. Input Conventions ................................................................................................. 64 5.2. Update Reminder .................................................................................................. 65 5.3. The dspace.cfg Configuration Properties File .............................................................. 65 5.4. Optional or Advanced Configuration Settings ........................................................... 123 5.5. DSpace Services Framework ................................................................................. 135 2 5.6. DSpace Statistics ................................................................................................. 139 5.7. JSPUI Configuration and Customization .................................................................. 141 5.8. XMLUI Configuration and Customization ................................................................ 142 6. System Administration .................................................................................................... 148 6.1. Community and Collection Structure Importer .......................................................... 148 6.2. Package Importer and Exporter .............................................................................. 149 6.3. Item Importer and Exporter ................................................................................... 150 6.4. Transferring Items Between DSpace Instances .......................................................... 154 6.5. Item Update ....................................................................................................... 154 6.6. Registering (Not Importing) Bitstreams ................................................................... 156 6.7. METS Tools ....................................................................................................... 158 6.8. MediaFilters: Transforming DSpace Content ............................................................. 160 6.9. Sub-Community Management ................................................................................ 161 6.10. Batch Metadata Editing ....................................................................................... 162 6.11. Checksum Checker ............................................................................................. 165 7. Storage ......................................................................................................................... 170 7.1. RDBMS ............................................................................................................. 170 7.2. Bitstream Store ................................................................................................... 172 8. Directories .................................................................................................................... 175 8.1. Overview ........................................................................................................... 175 8.2. Source Directory Layout ....................................................................................... 176 8.3. Installed Directory Layout ....................................................................................