Archived / Obsolete Documentation

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

Reference documentation:

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.

<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>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>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>Now perform the following tasks as the <tt>dspace</tt> user:

sudo su - dspace


<li>Download DSpace source (stable) from 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>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>

<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>Create the initial DSpace administrator:

sudo -u dspace /dspace/bin/create-administrator

<li>Append the following lines to <tt>/etc/default/tomcat5.5</tt> to set the preferences necessary for dspace:


<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>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>Start Tomcat:

sudo /etc/init.d/tomcat5.5 start

<li>Open the new URL in your Web browser: http://hostname:8180/dspace (adjust for your hostname and port number, accordingly)