1. Installing DSpace Bill Jordan bjordan@u.washington.edu EDUCAUSE 11/4/2003 bjordan@u.washington.edu

2. Steps Install prerequisite software – Unix-y o/s –JDK and extra jars –ant –Tomcat or other servlet engine –Apache or other web server (optional) –Postgresql Build and install DSpace DSpace configuration/customization

3. JDK and jars Tested with J2SE 1.3 and 1.4 Extra jar files – put in dspace/lib in the source tree –activation.jar (from JavaBeans Activation Framework) –servlet.jar (from Java Servlet 2.3) –mail.jar (from JavaMail API) Ant 1.5 –Java “make”, for building

4. Tomcat For standalone: 4.1.18 For Apache: 4.0.6 Avoid 4.1.12 (can’t follow symlinks) Run as non-privileged user (needs write access to the dspace tree) JAVA_OPTS=“-Xmx512M –Xms64M \ –Dfile.encoding=UTF-8” Tweak server.xml to allow symlinks

5. Apache Useful primarily for SSL and authentication options (X509, mod_ssl, mod_pubcookie) Apache 1.3 or 2.0 mod_webapp provides bridge between Apache and Tomcat mod_webapp is a pain to build Can omit Apache and run Tomcat standalone if Apache features not needed

6. Postgresql RDBMS 7.3 or later RedHat binaries available in rpms --enable-unicode --enable-multibyte --with-java (for jdbc) Copy jdbc driver to dspace/lib postgresql.conf: tcpip_socket=true

7. Build and install createuser -U postgres -d -A -P dspace ; createdb -U dspace -E UNICODE dspace Edit config files in dspace/config ant ant fresh_install ln -s /dspace/jsp dspace ln -s /dspace/oai dspace-oai /dspace/bin/install-configs (from install dir)

8. dspace/config dspace.cfg: set dir paths, hostname, site name, handle prefix, asset store path, SiteAuthenticator templates/ : for other apps, like Apache Changes are made here, then pushed out with bin/install-configs apache13.conf : macros for dspace- specific values inherited from dspace.cfg (e.g. @@dspace-hostname@@)

9. Customization Easy to override default jsp’s dspace/jsp/local read before dspace/jsp Headers/footers: dspace/jsp/layout/header-*.jsp Style sheet: dspace/jsp/styles.css.jsp Local jsp’s won’t be overwritten on upgrade, but need to be reconciled with new versions Custom SiteAuthenticator