Archived / Obsolete Documentation

Documentation in this space is no longer accurate.
Looking for official DSpace documentation? See all documentation

Updated Guide Available

An updated guide to Installing DSpace on OSX has been created. See: Install DSpace on OSX (2014)

Reference documentation: http://dspace.org/technology/system-docs/install.html

See Installing DSpace on Mac OS X for an newer, less terse version.

Notes

  • OSX 10.4 November 2006, Java 1.5, X_Code tools 2.3?
  • These instructions seem to work fine, and are the same for OS X and OS X Server.
  • I don't use the older version of tomcat installed with OS X Server, nor do I attempt to update it.
  • I run tomcat on port 80 and I have not tried to use Apache with tomcat.

Start Here;

  • create a user postgres - use this for your postgres install
  • create a user dspace - use this for both dspace and tomcat
  • Update java With system update (J2RE version 1.5)
  • Install xcode tools. You need it for Ant. Probably other stuff too.
  • Install tomcat5.5 http://www.bartbusschots.ie/blog/?p=201 is a good guide - just remember to use the user dspace instead of tomcat. I have only done steps one to three.
  • Create the PostgreSQL 'dspace' user and the 'dspace' database. The key here is to issue each command using sudo as the Unix 'postgres' user:

    sudo -u postgres createuser -U postgres -d -A -P dspace
    sudo -u dspace createdb -U dspace -E UNICODE dspace
    

If you use the sites above, postgres and tomcat will be in the /usr/local part of your filesystem.

modify /etc/profile as follows;

# System-wide .profile for sh(1)

PATH="/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin"
export PATH

if [ "${BASH-no}" != "no" ]; then
        [ -r /etc/bashrc ] && . /etc/bashrc
fi

#For Tomcat
export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
export CATALINA_HOME=/usr/local/tomcat

export JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"

Open a NEW terminal(so the updates to profile are available) and follow the dspace install instructions.

NOTE: The Manakin DSpace XMLUI works fine (so far), but you will have to update the context.xml to include the location of DSpace config file (dspace.cfg)