Difference between revisions of "SUNScholar/Install DSpace/S08/Ubuntu-14.04"
(Created page with "<center> '''BACK TO STEP 8''' </center> ==Step 8. Enable the DSpace Java webapps on the Java Tomcat webapp server== The DSpace webapps have...") |
m |
||
| Line 4: | Line 4: | ||
==Step 8. Enable the DSpace Java webapps on the Java Tomcat webapp server== | ==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/ | + | The DSpace webapps have been compiled in the '''/home/dspace/webapps''' folder but Tomcat only serves up webapps in the '''/var/lib/tomcat7/webapps''' folder. |
So, how do we get all the files into the Tomcat 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/ | + | 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/tomcat7/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]) in the default Tomcat webapps folder, to the DSpace webapps in the '''/home/dspace/webapps''' folder by typing as follows: | 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''' folder by typing as follows: | ||
| − | sudo cd /var/lib/ | + | sudo cd /var/lib/tomcat7/webapps |
sudo ln -s /home/dspace/webapps/oai | sudo ln -s /home/dspace/webapps/oai | ||
| Line 21: | Line 21: | ||
The following is optional, but nice to have. | The following is optional, but nice to have. | ||
| − | sudo ln -s /usr/share/ | + | sudo ln -s /usr/share/tomcat7-admin/manager |
===Step 8.1 Configure the default ROOT webapp=== | ===Step 8.1 Configure the default ROOT webapp=== | ||
| Line 31: | Line 31: | ||
Start by removing the default Tomcat ROOT webapp with the following command: | Start by removing the default Tomcat ROOT webapp with the following command: | ||
| − | sudo rm -rf /var/lib/ | + | sudo rm -rf /var/lib/tomcat7/webapps/ROOT |
Then apply one of the following. | Then apply one of the following. | ||
*'''<font color="red"><u>Please Note: You can only choose one UI as the default ROOT Tomcat webapp!. The other can be referenced as "/" something if needed.</u></font>''' | *'''<font color="red"><u>Please Note: You can only choose one UI as the default ROOT Tomcat webapp!. The other can be referenced as "/" something if needed.</u></font>''' | ||
| Line 39: | Line 39: | ||
Type the following to make the XMLUI the default interface. | Type the following to make the XMLUI the default interface. | ||
| − | sudo cd /var/lib/ | + | sudo cd /var/lib/tomcat7/webapps |
sudo ln -s /home/dspace/webapps/xmlui ROOT | sudo ln -s /home/dspace/webapps/xmlui ROOT | ||
| Line 48: | Line 48: | ||
Type the following to make the JSPUI the default interface. | Type the following to make the JSPUI the default interface. | ||
| − | sudo cd /var/lib/ | + | sudo cd /var/lib/tomcat7/webapps |
sudo ln -s /home/dspace/webapps/jspui ROOT | sudo ln -s /home/dspace/webapps/jspui ROOT | ||
| Line 54: | Line 54: | ||
====Example listing of DSpace Java webapps in the Tomcat webapp folder==== | ====Example listing of DSpace Java webapps in the Tomcat webapp folder==== | ||
To get a listing of active Tomcat webapps type the following: | To get a listing of active Tomcat webapps type the following: | ||
| − | sudo cd /var/lib/ | + | sudo cd /var/lib/tomcat7/webapps |
sudo ls -l | sudo ls -l | ||
| Line 60: | Line 60: | ||
See example listing below. | See example listing below. | ||
<pre> | <pre> | ||
| − | dspace@ir1:/var/lib/ | + | dspace@ir1:/var/lib/tomcat7/webapps$ ls -l |
total 0 | total 0 | ||
lrwxrwxrwx 1 root root 24 2012-09-05 11:28 oai -> /home/dspace/webapps/oai | lrwxrwxrwx 1 root root 24 2012-09-05 11:28 oai -> /home/dspace/webapps/oai | ||
| Line 70: | Line 70: | ||
===Step 8.2 Restart Tomcat Server=== | ===Step 8.2 Restart Tomcat Server=== | ||
Type the following. | Type the following. | ||
| − | sudo /etc/init.d/ | + | sudo /etc/init.d/tomcat7 restart |
Revision as of 13:32, 15 January 2015
BACK TO STEP 8
Contents
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/tomcat7/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/tomcat7/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 folder by typing as follows:
sudo cd /var/lib/tomcat7/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/tomcat7-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 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.
sudo 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.
sudo 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:
sudo 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 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
Step 8.2 Restart Tomcat Server
Type the following.
sudo /etc/init.d/tomcat7 restart
