SUNScholar/Install DSpace/S08

Install DSpace - Index

Step 8. Enable the DSpace Java webapps on the Java Tomcat webapp server

The DSpace webapps have been compiled in the /home/dspace/webapps folder but Tomcat only serves up webapps in the /var/lib/tomcat6/webapps folder.

So, how do we get all the files into the Tomcat webapps folder ?

There are several methods, but we are going to set it up so that if you change anything in the DSpace /home/dspace/webapps folder and re-compile then the changes automatically occur in the Tomcat /var/lib/tomcat6/webapps folder.

We create the shortcuts to the DSpace webapps in the default Tomcat webapps folder by typing as follows:

sudo cd /var/lib/tomcat6/webapps

sudo ln -s /home/dspace/webapps/oai

sudo ln -s /home/dspace/webapps/sword

sudo ln -s /usr/share/tomcat6-admin/manager

Step 8.1 Configure the default ROOT webapp

DSpace has two web interfaces, the XMLUI and the JSPUI. This procedure allows you to select which inteface will be used as the ROOT webapp. In other words, the one that does not need a /XMLUI or a /JSPUI URL addition.

Start by removing the default Tomcat ROOT webapp with the following command:

sudo rm -rf /var/lib/tomcat6/webapps/ROOT

Then apply one of the following.

• Please note: You can only choose one option.

Option A: Type the following to make the XMLUI the default interface.

sudo cd /var/lib/tomcat6/webapps

sudo ln -s /home/dspace/webapps/xmlui ROOT

Option B: Type the following to make the JSPUI the default interface.

sudo cd /var/lib/tomcat6/webapps

sudo ln -s /home/dspace/webapps/jspui ROOT

Previously we ran both the XMLUI and JSPUI and now only run the XMLUI as the ROOT interface. The JSPUI seemed to consume a lot of memory.

Step 8.2 Restart Tomcat Server

Type the following.

sudo /etc/init.d/tomcat6 restart

Example listing of DSpace Java webapps in the Tomcat webapp folder

root@ir1:/var/lib/tomcat6/webapps# ls -l
total 7732
lrwxrwxrwx 1 tomcat6 tomcat6      33 2011-07-04 20:54 manager -> /usr/share/tomcat6-admin/manager/
lrwxrwxrwx 1 tomcat6 tomcat6      25 2011-07-04 20:54 oai -> /home/dspace/webapps/oai/
drwxr-xr-x 7 tomcat6 tomcat6    4096 2012-02-27 14:00 probe
-rw-r--r-- 1 tomcat6 tomcat6 7909476 2012-02-27 14:00 probe.war
lrwxrwxrwx 1 tomcat6 tomcat6      27 2011-07-04 20:54 ROOT -> /home/dspace/webapps/xmlui/
lrwxrwxrwx 1 tomcat6 tomcat6      25 2011-12-12 13:48 solr -> /home/dspace/webapps/solr
lrwxrwxrwx 1 tomcat6 tomcat6      27 2011-07-04 20:54 sword -> /home/dspace/webapps/sword/

PREVIOUS

NEXT