Transcript Installing DSpace

Installing DSpace
Bill Jordan
[email protected]
EDUCAUSE 11/4/2003
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
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
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
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
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
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)
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 dspacespecific values inherited from dspace.cfg
(e.g. @@dspace-hostname@@)
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