This is a step-by-step how-to guide to install DSpace 4.2 on Redhat Enterprise v6.5.
Install Prerequisites
Install Java
#To check if java is installed: java -version #If you're running 1.6 or higher, this guide should be fine. If You don't have java: yum install java-1.6.0-openjdk*
Install Tomcat 7
cd /tmp wget http://www.us.apache.org/dist/tomcat/tomcat-7/v7.0.56/bin/apache-tomcat-7.0.56.tar.gz tar xzf apache-tomcat-7.0.56.tar.gz mv apache-tomcat-7.0.56 /usr/local/tomcat7
Install PostgreSQL
yum install postgresql-server.x86_64
Install the Compile / Build tools
sudo apt-get install ant maven2
Configure the Prerequisite Software
Create the database user (dspace)
sudo su postgres createuser -U postgres -d -A -P dspace exit
- At this point, you will be asked to enter a password. Make it secure and remember it.
- You will also be prompted as to whether or not this user should be able to create other users. This should be no.
Allow the database user (dspace) to connect to the database
sudo vi /etc/postgresql/9.3/main/pg_hba.conf # Add this line to the configuration: local all dspace md5 sudo service postgresql restart
Create the DSpace Database
createdb -U dspace -E UNICODE dspace
Configure Tomcat to know about the DSpace webapps.
sudo vi /etc/tomcat7/server.xml # Insert the following chunk of text just above the closing </Host> <!-- Define a new context path for all DSpace web apps --> <Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/> <Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/> <Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/> <Context path="/jspui" docBase="/dspace/webapps/jspui" allowLinking="true"/> <Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/> <Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>
Download and Install DSpace
Create the [dspace] directory.
The [dspace] directory is where the running dspace code will reside.
sudo mkdir /dspace
Download the Latest Release
The source release allows you to customize every aspect of DSpace. This step downloads the compressed archive from SourceForge, and unpacks it in your current directory. The dspace-1.x.x-src-release directory is typically referred to as [dspace-src].
sudo git clone https://github.com/DSpace/DSpace.git (apt-get install git if you don't already have it)
Compile and Build DSpace
The source release that has been obtained is human readable source code, and must be compiled to machine code for the server to run it. "mvn package" compiles the source code, and "ant" will do all the work necessary to initialize the database with the DSpace schema, and copy all of the compiled machine code to a location where the web server can serve it. This will overwrite any existing installation of DSpace that you may have.
make sure all your dependencies are in order, and you're running maven 3.x. (Check this version with mvn -v)
sudo apt-get install openjdk-7-jdk
sudo apt-get install maven
sudo apt-get remove maven2
cd DSpace mvn package (this step takes a long time) cd dspace/target/dspace-4.3-SNAPSHOT-build.dir sudo ant fresh_install
Fix Tomcat permissions, and restart the Tomcat server
This guide follows the convention where the tomcat user will own all of the files in [dspace], so we have to change the owner of the files to tomcat7. Restarting tomcat will deploy the dspace webapps that are now ready to be viewed.
cd /home/dspace (or wherever your bottom most directory for dspace is) sudo chown tomcat7:tomcat7 /dspace -R sudo service tomcat7 restart
Test it out in your browser
That is all that is required to install DSpace on Ubuntu. There are two main webapps that provide a similar turn-key repository interface