This is a revision of Installation on Ubuntu 8.04.
1. Ensure that you installed Ubuntu 8.10 Server with Tomcat and PotgreSQL (this can be selected during the installation process.
2. Install maven2 package for the maven build utility
sudo apt-get install maven2
3. Install ant package for installing DSpace
sudo apt-get install ant
4. 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 adduser dspace admin
sudo adduser dspace tomcat6
sudo mkdir /dspace
sudo chown dspace /dspace
5. Create the PostgreSQL 'dspace' user and the 'dspace' database. Using sudo as the Unix 'postgres' user, authorize the 'dspace' user. You will need to select a password, and specify 'n' to the create new roles prompt. Then, as the 'dspace' user, create the database.
sudo -u postgres createuser -U postgres -d -A -P dspace
sudo -u dspace createdb -U dspace -E UNICODE dspace
6. Stopping Tomcat 6
sudo service tomcat6 stop
7. Change ownership of the tomcat directories to the dspace user:
sudo chown -R dspace /var/cache/tomcat6
sudo chown -R dspace /var/lib/tomcat6
sudo chown -R dspace /var/log/tomcat6
sudo chown -R dspace /etc/tomcat6
sudo chown -R dspace /var/cache/tomcat6
8. Now perform the following tasks as the dspace user:
sudo su - dspace
bash
9. Using the release package:
1. Download DSpace src-release in any directory (In this tutorial it is /home/dspace) and unpack it. The new DSpace directory is referred to as [dspace-src]. (example: /home/dspace/dspace-1.5.0-release)
wget -c http://nchc.dl.sourceforge.net/sourceforge/dspace/dspace-1.5.2-src-release.zip
unzip dspace-1.5.2-src-release.zip
2. Configure [dspace-src]/dspace/config/dspace.cfg -- check to see if email configuration is required for Ubuntu, currently set to local-only
3. cd into the [dspace-src]/dspace directory.
4. Package the install:
mvn package
Your first run of Maven downloads a lot of dependencies. Be prepared for several minutes of download activity, followed by several minutes of build activity. Note that if you accidentally run Maven using gcj instead of Sun Java, and it fails, you should remove the ~/.m2 directory (rm -rf /home/dspace/.m2 before proceeding with the correct java).
5. cd into [dspace-src]/dspace/target/dspace-[version]-build.dir/
6. Initialize the database and install the software:
ant fresh_install
Remark: If the build fails two things are neccessary to do before a new attempt: 1. Remove the remains of the faild build (execute ant clean), 2. Remove the dspace tables from the database by dropping and recreating it (execute dropdb -U dspace dspace; createdb -U dspace -E UNICODE dspace). Of course the reason for the failing must be cured too.
10. Create the initial DSpace administrator:
/dspace/bin/create-administrator
11. Append the following lines to /etc/default/tomcat6 to set the preferences necessary for dspace:
TOMCAT6_USER=dspace
TOMCAT6_SECURITY=no
12. Modify the Tomcat properties in /etc/tomcat6/server.xml to use UTF-8 encoding. You can also change the port from the non-standard 8180 to 8080 to match the examples in DSpace documentation, and the dspace.cfg file:
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8" />
Also in server.xml modify the webapps directory to point to /dspace/webapps:
xmlValidation="false" xmlNamespaceAware="false">
13. Start Tomcat:
sudo service tomcat6 start
14. Open the new URL in your Web browser: http://hostname:8180/jspui or http://hostname:8180/xmlui (adjust for your hostname and port number, accordingly)
Retrieved from "http://wiki.dspace.org/index.php/Installing_DSpace_1.5_on_Ubuntu_8.10_Server"
Category: Installation
