Difference between revisions of "SUNScholar/Install DSpace/S08"

From Libopedia
Jump to navigation Jump to search
 
(122 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
<center>
 +
'''[[SUNScholar/Install DSpace/S09|NEXT - STEP 9]]'''
 +
</center>
 +
===<font color="red">PLEASE NOTE:</font>===
 +
# *** ''This procedure is completely different from the official DSpace documentation, in that it applies best system admin practice for Unix based systems'' ***
 +
#This procedure does <u>NOT</u> require "mod_jk" or Apache2 port re-direction with firewall rules <u>or the Apache2 server</u>.
 +
 
==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 webapp has been compiled in the '''/home/dspace/webapps''' folder but Tomcat only serves up webapps in the '''/var/lib/tomcat6/webapps''' folder.
+
The DSpace webapps have been compiled in the '''$HOME/webapps''' folder but Tomcat only serves up webapps in the '''/var/lib/tomcatX/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.
 
−
 
 
−
To achieve this become the root user by typing as follows:
 
−
sudo -i
 
−
 
 
−
Now we create the shortcuts to the DSpace webapps in the default Tomcat webapps folder by typing as follows:
 
−
 
 
−
cd /var/lib/tomcat6/webapps
 
−
 
 
−
ln -s /home/dspace/webapps/oai
 
−
 
 
−
ln -s /home/dspace/webapps/sword
 
−
 
 
−
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.
 
−
*'''<font size="3" color="red">Please note: You can only choose one option.</font>'''
 
−
====Option A: Type the following to make the XMLUI the default interface.====
 
−
 
 
−
sudo -i
 
  
−
cd /var/lib/tomcat6/webapps
+
So, how do we get all the files into the Tomcat webapps folder?
  
−
ln -s /home/dspace/webapps/xmlui ROOT
+
There are several methods. I selected what I call the "automatic linkage" method: if you change anything in the DSpace '''$HOME/webapps''' folder and then re-compile, the changes automatically occur in the Tomcat '''/var/lib/tomcatX/webapps''' folder.
  
−
====Option B: Type the following to make the JSPUI the default interface.====
+
''This method saves you from constantly having to copying webapps after a compile, which is always a risky business.''
−
sudo -i
 
  
−
cd /var/lib/tomcat6/webapps
+
''It also saves you from having to change the Tomcat server configuration files, which is '''very definitely not recommended''' by the Debian/Ubuntu software package maintainers.''
  
−
  ln -s /home/dspace/webapps/jspui ROOT
+
==Requirements==
 +
  <font color="red">'''Please make sure that Tomcat is listening on port 80 first, before setting this up. See link below.</font>'''
 +
http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S05
 +
==[[SUNScholar/Install_DSpace/S08/Ubuntu-16.04|For Ubuntu 16.04 LTS]]==
 +
==[[SUNScholar/Install_DSpace/S08/Ubuntu-14.04|For Ubuntu 14.04 LTS]]==
 +
==[[SUNScholar/Install_DSpace/S08/Ubuntu-12.04|For Ubuntu 12.04 LTS]]==
 +
==References==
 +
* http://rspproject.wordpress.com/2011/03/22/running-dspace-on-a-root-url
  
−
===Step 8.2 Restart Tomcat Server===
+
<center>
−
Type the following.
+
  '''[[SUNScholar/Install DSpace/S07|PREVIOUS - STEP 7]]'''
−
  sudo /etc/init.d/tomcat6 restart
+
</center>
  
−
'''[[SUNScholar/Install Dspace/S09|Proceed to the next step]]'''
+
[[Category:Installation]]
 +
__NOTOC__

Latest revision as of 14:35, 30 October 2019

NEXT - STEP 9

PLEASE NOTE:

  1. *** This procedure is completely different from the official DSpace documentation, in that it applies best system admin practice for Unix based systems ***
  2. This procedure does NOT require "mod_jk" or Apache2 port re-direction with firewall rules or the Apache2 server.

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

The DSpace webapps have been compiled in the $HOME/webapps folder but Tomcat only serves up webapps in the /var/lib/tomcatX/webapps folder.

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

There are several methods. I selected what I call the "automatic linkage" method: if you change anything in the DSpace $HOME/webapps folder and then re-compile, the changes automatically occur in the Tomcat /var/lib/tomcatX/webapps folder.

This method saves you from constantly having to copying webapps after a compile, which is always a risky business.

It also saves you from having to change the Tomcat server configuration files, which is very definitely not recommended by the Debian/Ubuntu software package maintainers.

Requirements

Please make sure that Tomcat is listening on port 80 first, before setting this up. See link below.
http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S05

For Ubuntu 16.04 LTS

For Ubuntu 14.04 LTS

For Ubuntu 12.04 LTS

References

PREVIOUS - STEP 7
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Install_DSpace/S08&oldid=45677"