Installing DSpace 1.4 on Ubuntu 6.06 LTS
Reference documentation: http://www.dspace.org/index.php?option=com_content&task=view&id=152#checker
The Installation on Ubuntu 7.04 is very similar to this procedure.
- 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:
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:
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: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:sudo su - dspace bash
- 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.
- Copy the JDBC driver into the
dspace-src/lib
directory aspostgresql.jar
:cp /usr/share/java/postgresql-jdbc2-8.1.jar [dspace-src]/lib/postgresql.jar
- 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-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 (execute
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:
sudo cp [dspace-source]/build/dspace*.war /var/lib/tomcat5/webapps/.
- Create the initial DSpace administrator:
sudo -u dspace /dspace/bin/create-administrator
- Append the following lines to
/etc/default/tomcat5
to set the preferences necessary for dspace: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:
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:<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:
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)