|
|
| Line 6: |
Line 6: |
| | <font color="red">'''Please make sure that Tomcat is listening on port 80 and 443 first, before setting this up. See link below.</font>''' | | <font color="red">'''Please make sure that Tomcat is listening on port 80 and 443 first, before setting this up. See link below.</font>''' |
| | http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S05 | | 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 ([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/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 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/tomcat6/webapps/ROOT
| |
| − | 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>'''
| |
| − | ====Option A: [[SUNScholar/Theme|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/tomcat6/webapps
| |
| − |
| |
| − | sudo ln -s /home/dspace/webapps/xmlui ROOT
| |
| − |
| |
| − | ====Option B: [[SUNScholar/Theme|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/tomcat6/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/tomcat6/webapps
| |
| − |
| |
| − | sudo ls -l
| |
| − |
| |
| − | See example listing below.
| |
| − | <pre>
| |
| − | 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
| |
| − | </pre>
| |
| − |
| |
| − | ===Step 8.2 Restart Tomcat Server===
| |
| − | Type the following.
| |
| − | sudo /etc/init.d/tomcat6 restart
| |
| − |
| |
| | ==References== | | ==References== |
| | * http://rspproject.wordpress.com/2011/03/22/running-dspace-on-a-root-url/ | | * http://rspproject.wordpress.com/2011/03/22/running-dspace-on-a-root-url/ |
