SUNScholar/Install DSpace/S08/Ubuntu-14.04

BACK TO STEP 8

Step 8.0 Create web application shortcuts
We create shortcuts (symlinks in the Unix world) in the default Tomcat webapps folder, to the DSpace webapps in the $HOME/webapps folder by typing as follows:

cd /var/lib/tomcat7/webapps

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

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

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

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

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 interface 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/tomcat7/webapps/ROOT Then apply one of the following.
 *  Please Note: You can only choose one UI as the default ROOT Tomcat webapp!. The other can be referenced as "/" something if needed. 

Option A: XMLUI
Complex setup but very customisable using modern web UI technologies and has a low server load.

Type the following to make the XMLUI the default interface.

cd /var/lib/tomcat7/webapps

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

Option B: JSPUI
Easy to setup but hard to customise and has a high server load.

Type the following to make the JSPUI the default interface.

cd /var/lib/tomcat7/webapps

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

Example listing of DSpace Java webapps in the Tomcat webapp folder
To get a listing of active Tomcat webapps type the following: cd /var/lib/tomcat7/webapps

sudo ls -l

See example listing below. dspace@ir1:/var/lib/tomcat7/webapps$ ls -l total 0 lrwxrwxrwx 1 root   root         24 2012-09-05 11:28 oai -> /home/dspace/webapps/oai lrwxrwxrwx 1 root   root         25 2012-09-05 11:28 rest -> /home/dspace/webapps/rest lrwxrwxrwx 1 root   root         26 2012-09-05 11:28 ROOT -> /home/dspace/webapps/xmlui lrwxrwxrwx 1 root   root         25 2012-09-05 11:28 solr -> /home/dspace/webapps/solr lrwxrwxrwx 1 root   root         26 2012-09-05 11:28 sword -> /home/dspace/webapps/sword

Step 8.2 Restart Tomcat Server
Type the following. sudo service tomcat7 restart You can view the restart log if you want by typing the following; tail -f /var/log/tomcat7/catalina.out