DSpace Technical Documentation Fredrick Odongo Okite [[email protected]], David Bukenya [[email protected]] Uganda Christian University Library. Credit to Hilton Gibson, Stellenbosch University. 1 Table of Contents UCUDIR DSpace System details .................................................................................................................... 4 Preparation Stage ......................................................................................................................................... 5 Terms to note ................................................................................................................................................ 5 Essential requirements for DSpace 6.2 to run ............................................................................................... 5 Installing Postgresql in Ubuntu: ................................................................................................................ 5 Git (code version control) ......................................................................................................................... 9 Installing tomcat ....................................................................................................................................... 9 Setup Tomcat to listen on insecure port 80 ........................................................................................ 10 For secure Port 443: ............................................................................................................................ 10 Step2: Apply for a signed certificate .................................................................................................. 14 Step 3. Get the intermediate CA certs ................................................................................................ 15 Intermediate CA certs links ......................................................................................................... 15 Step 4. Configure Tomcat to use the SSL certs ................................................................................... 16 Setup Tomcat "server.xml" to use the converted certificate ............................................. 16 Step 5. Enable secure XMLUI logins .................................................................................................... 18 Step 6. Enable HTTPS by default (Optional) ........................................................................................ 18 Java environment settings for Tomcat webapp server ....................................................................... 18 Setup user permissions ....................................................................................................................... 19 Installing DSpace ......................................................................................................................................... 19 1. Getting DSpace software ................................................................................................................ 19 2. Unpacking DSpace ........................................................................................................................... 19 3. Editing DSpace Configuration ......................................................................................................... 19 4. Building DSpace ............................................................................................................................... 23 5. Installing DSpace ............................................................................................................................. 24 6. Creating DSpace Super-admin user ................................................................................................ 24 7. Telling Tomcat where to find Dspace ............................................................................................. 24 8. Testing DSpace ................................................................................................................................ 25 Essential Directory trees ............................................................................................................................. 26 Servlet Engine [Tomcat7] Directories for UCUDIR .................................................................................. 26 CATALINA_HOME ......................................................................................................................... 27 Important directories for backup and restore ............................................................................................ 28 How to configure the Handle server ........................................................................................................... 29 2 Prepare an initial handle request ........................................................................................................... 29 Send handle request email ..................................................................................................................... 29 Update DSpace config file ........................................................................................................................... 31 Rebuild DSpace ....................................................................................................................................... 31 Checking for correct operation ............................................................................................................... 32 Listening Ports ..................................................................................................................................... 32 Handle service ..................................................................................................................................... 32 Handle config ...................................................................................................................................... 32 Handle log ........................................................................................................................................... 32 Rebuild config ..................................................................................................................................... 32 Start service manually ......................................................................................................................... 32 DSpace security policy ............................................................................................................................ 33 Create new thumbnails ........................................................................................................................... 38 Setting up usage config file ..................................................................................................................... 39 Re-indexing statistics .............................................................................................................................. 40 Step 2 - Enable the DSpace authority control event listener .................................................................. 41 Step 3 - Configure the ORCID authority control plugin ........................................................................... 41 Step 3.1 ............................................................................................................................................... 41 Step 3.2 ............................................................................................................................................... 42 Step 4 - Rebuild DSpace .......................................................................................................................... 43 Step 5 - Create an ORCID authority index cache .................................................................................... 43 Tomcat Security .................................................................................................................................. 43 Folder and file permissions/ownership .............................................................................................. 43 WARNING: ........................................................................................................................................... 43 Step 6 - Maintain ORCID authority index cache...................................................................................... 43 Step 6.1 - Ad-hoc update .................................................................................................................... 43 Step 6.2 - Regular update.................................................................................................................... 43 Step 6.3 - Export authority records ..................................................................................................... 43 Upgrading DSpace. ...................................................................................................................................... 44 Upgrading an existing Dspace ................................................................................................................. 44 Migrating to a new installation. .............................................................................................................. 46 3 UCUDIR DSpace System details Server IP: e.g 196.43.140.182 Server OS: Ubuntu 16.04.3 LTS (GNU/Linux 4.4.0-87-generic x86_64) UCUDIR Version: Dspace 6.2 Servlet Container: Apache-Tomcat7 JDK: java-7-openjdk-amd64 $JAVA_HOME: