Difference between revisions of "SUNScholar/Install DSpace/S08"
| Line 11: | Line 11: | ||
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 then re-compile, the changes automatically occur in the Tomcat '''/var/lib/tomcat6/webapps''' folder. This also saves you from constantly copying webapps after a compile, which is a tricky business. | 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 then re-compile, the changes automatically occur in the Tomcat '''/var/lib/tomcat6/webapps''' folder. This also saves you from constantly copying webapps after a compile, which is a tricky business. | ||
| − | We create shortcuts ([http://en.wikipedia.org/wiki/Symlink symlinks in the Unix world]) to the DSpace webapps | + | We create shortcuts ([http://en.wikipedia.org/wiki/Symlink symlinks in the Unix world]) in the default Tomcat webapps folder to the DSpace webapps in the '''/home/dspace/webapps''' by typing as follows: |
cd /var/lib/tomcat6/webapps | cd /var/lib/tomcat6/webapps | ||
Revision as of 19:45, 26 June 2013
Contents
Requirements
Please make sure that Tomcat is listening on port 80 and 443 first, before setting this up. See link below.
http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S05
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 then re-compile, the changes automatically occur in the Tomcat /var/lib/tomcat6/webapps folder. This also saves you from constantly copying webapps after a compile, which is a tricky business.
We create shortcuts (symlinks in the Unix world) in the default Tomcat webapps folder to the DSpace webapps in the /home/dspace/webapps by typing as follows:
cd /var/lib/tomcat6/webapps
sudo ln -s /home/dspace/webapps/oai
sudo ln -s /home/dspace/webapps/sword
sudo ln -s /home/dspace/webapps/solr
The following is optional, but nice to have.
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: XMLUI
Type the following to make the XMLUI the default interface.
Complex setup but very customisable and has a low server load. See screenshots below.
cd /var/lib/tomcat6/webapps
sudo ln -s /home/dspace/webapps/xmlui ROOT
Option B: JSPUI
Type the following to make the JSPUI the default interface.
Easy to setup but hard to customise and has a high server load. See screenshots below.
cd /var/lib/tomcat6/webapps
sudo ln -s /home/dspace/webapps/jspui ROOT
Example listing of DSpace Java webapps in the Tomcat webapp folder
dspace@ir1:/var/lib/tomcat6/webapps$ ls -l total 0 lrwxrwxrwx 1 root root 24 2012-09-05 11:28 oai -> /home/dspace/webapps/oai lrwxrwxrwx 1 root root 26 2012-09-05 11:29 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:29 sword -> /home/dspace/webapps/sword
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 more memory.
Step 8.2 Restart Tomcat Server
Type the following.
sudo /etc/init.d/tomcat6 restart
References
PREVIOUS
NEXT
