Reference documentation: http://www.dspace.org/index.php?option=com_content&task=view&id=152#checker
The Installation on Ubuntu 6.06 is very similar to this procedure. Only some version numbers changed and the <Connector> for port 8180 in server.xml looks different.
<ol>
<li>Add all repositories (free, non-free, universe) (*System -> Administration -> Synaptic Package Manager -> Settings -> Repositories -> Add -> * *) and reload.</li>
<li>Install <tt>tomcat5.5</tt> package and all associated dependencies</li>
<li>Install <tt>sun-java5-jdk</tt> package and all associated dependencies</li>
<li>Install <tt>postgresql-8.2</tt> package and all associated dependencies</li>
<li>Install <tt>libpg-java</tt> package for the Postgres JDBC driver</li>
<li>Install <tt>ant-optional</tt> package for regular expression support in build.xml</li>
<li>Make Ubuntu use the Sun JDK:
sudo update-alternatives --set java /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
</li>
<li>Create the Unix 'dspace' user, update the passwd, create the directory in which you will install dspace, and ensure that the Unix 'dspace' user has write privileges on that directory:
sudo useradd -m dspace sudo passwd dspace sudo mkdir /dspace sudo chown dspace /dspace
</li>
<li>Create the PostgreSQL 'dspace' user and the 'dspace' database. The key here is to issue each command using <tt>sudo</tt> as the Unix 'postgres' user:
sudo -u postgres createuser -U postgres -d -A -P dspace sudo -u dspace createdb -U dspace -E UNICODE dspace
</li>
<li>Now perform the following tasks as the <tt>dspace</tt> user:
sudo su - dspace bash
</li>
<li>
<ol>
<li>Download DSpace source (stable) from http://sourceforge.net/projects/dspace in any directory (e.g. <tt>/home/dspace</tt>) and unpack it. The new DSpace directory is referred to as dspace-src.</li>
<li>Copy the JDBC driver into the <tt>dspace-src/lib</tt> directory as <tt>postgresql.jar</tt>:
cp /usr/share/java/postgresql-jdbc3-8.2.jar [dspace-src]/lib/postgresql.jar
</li>
<li>Configure <tt>dspace-src/config/dspace.cfg</tt> – check to see if email configuration is required for Ubuntu, currently set to local-only</li>
<li>cd into the dspace-src directory</li>
<li>Build the DSpace binaries:
ant fresh_install
Remark: If the build fails two things are neccessary to do before a new attempt: 1. remove the remainings of the faild build (execute <tt>ant clean</tt>), 2. remove the dspace tables from the database (execute <tt>dropdb -U dspace dspace</tt>; but we need the tablespace, so recreate it by <tt>createdb -U dspace -E UNICODE dspace</tt>). Of course the reason for the failing must be cured too.</li>
</ol></li>
<li>As root, copy the newly built WAR files into the tomcat webapps directory; then ensure they are owned by the dspace user:
sudo cp [dspace-src]/build/dspace*.war /var/lib/tomcat5.5/webapps/.
</li>
<li>Create the initial DSpace administrator:
sudo -u dspace /dspace/bin/create-administrator
</li>
<li>Append the following lines to <tt>/etc/default/tomcat5.5</tt> to set the preferences necessary for dspace:
TOMCAT5_USER=dspace JDK_DIRS="/usr/lib/jvm/java-1.5.0-sun" TOMCAT5_SECURITY=no
</li>
<li>Change ownership of the directories to the dspace user:
sudo chown -R dspace /var/cache/tomcat5.5 sudo chown -R dspace /var/lib/tomcat5.5 sudo chown -R dspace /var/log/tomcat5.5
</li>
<li>Modify the Tomcat properties in <tt>/etc/tomcat5.5/server.xml</tt> to use UTF-8 encoding. You can also change the port from the non-standard <tt>8180</tt> to <tt>8080</tt> to match the examples in DSpace documentation:
<Connector port="8180" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8" />
</li>
<li>Start Tomcat:
sudo /etc/init.d/tomcat5.5 start
</li>
<li>Open the new URL in your Web browser: http://hostname:8180/dspace (adjust for your hostname and port number, accordingly)
</li>
</ol>
</html>
