...
- Add all repositories (free, non-free, universe) (*System -> Administration -> Synaptic Package Manager -> Settings -> Repositories -> Add -> * *) and reload.
- Install
tomcat5
package and all associated dependencies - Install
sun-java5-jdk
package and all associated dependencies - Install
postgresql-8.1
package and all associated dependencies - Install
libpg-java
package for the Postgres JDBC driver - Install
ant-optional
package for regular expression support in build.xml - Make Ubuntu use the Sun JDK:
Code Block sudo update-alternatives --set java /usr/lib/jvm/java-1.5.0-sun/jre/bin/java
- 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:
Code Block sudo useradd -m dspace sudo passwd dspace sudo mkdir /dspace sudo chown dspace /dspace
- Create the PostgreSQL 'dspace' user and the 'dspace' database. The key here is to issue each command using
sudo
as the Unix 'postgres' user:Code Block sudo -u postgres createuser -U postgres -d -A -P dspace sudo -u dspace createdb -U dspace -E UNICODE dspace
- Now perform the following tasks as the
dspace
user:Code Block sudo su - dspace bash
Wiki Markup Download DSpace source (stable) from http://sourceforge.net/projects/dspace
in any directory and unpack it. The new DSpace directory is referred to as \[dspace-source\].
Wiki Markup Copy the JDBC driver into the {{\[dspace-src\]/lib}} directory as {{postgresql.jar}}:
Code Block cp /usr/share/java/postgresql-jdbc2-8.1.jar \[dspace-src\]/lib/postgresql.jar
– check to see if email configuration is required for Ubuntu, currently set to local-onlyWiki Markup Configure {{\[dspace-source\]/config/dspace.cfg
}} -- *check to see if email configuration is required for Ubuntu, currently set to local-only*
cd into the dspace-sourceWiki Markup cd into the \[dspace-source\]
directory
- Build the DSpace binaries:
Remark: If the build fails two things are neccessary to do before a new attempt: 1. remove the remainings of the faild build (executeCode Block ant fresh_install
ant clean
), 2. remove the dspace tables from the database (executedropdb -U dspace dspace
). Of course the reason for the failing must be cured too. - As root, copy the newly built WAR files into the tomcat webapps directory; then ensure they are owned by the dspace user:
Code Block sudo cp [dspace-source]/build/dspace*.war /var/lib/tomcat5/webapps/.
- Create the initial DSpace administrator:
Code Block sudo -u dspace /dspace/bin/create-administrator
- Append the following lines to
/etc/default/tomcat5
to set the preferences necessary for dspace:Code Block TOMCAT5_USER=dspace JDK_DIRS="/usr/lib/jvm/java-1.5.0-sun" TOMCAT5_SECURITY=no
- Change ownership of the directories to the dspace user:
Code Block sudo chown -R dspace /var/cache/tomcat5 sudo chown -R dspace /var/lib/tomcat5 sudo chown -R dspace /var/log/tomcat5
- Modify the Tomcat properties in
/etc/tomcat5/server.xml
to use UTF-8 encoding. You can also change the port from the non-standard8180
to8080
to match the examples in DSpace documentation:Code Block <Connector className="org.apache.coyote.tomcat5.CoyoteConnector" port="8180" minProcessors="5" maxProcessors="75" enableLookups="true" acceptCount="10" debug="0" connectionTimeout="20000" useURIValidationHack="false" URIEncoding="UTF-8"/>
- Start Tomcat:
Code Block sudo /etc/init.d/tomcat5 start
- Open the new URL in your Web browser: http://hostname:8180/dspace (adjust for your hostname and port number, accordingly)