Difference between revisions of "SUNScholar/Install DSpace/S08/Ubuntu-12.04"

From Libopedia
Jump to navigation Jump to search
m (Text replacement - "/home/dspace" to "$HOME")
m
 
(10 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
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/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/webapps''' folder by typing as follows:
  
  sudo cd /var/lib/tomcat6/webapps
+
  cd /var/lib/tomcat6/webapps
  
  sudo ln -s $HOME/webapps/oai
+
  sudo ln -s /home/dspace/webapps/oai
  
  sudo ln -s $HOME/webapps/sword
+
  sudo ln -s /home/dspace/webapps/sword
  
  sudo ln -s $HOME/webapps/solr
+
  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===
 
===Step 8.1 Configure the default ROOT webapp===
Line 27: Line 24:
 
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>'''
 +
----
 
====Option A: [[SUNScholar/Theme|XMLUI]]====
 
====Option A: [[SUNScholar/Theme|XMLUI]]====
 +
----
 
''Complex setup but very customisable using modern web UI technologies and has a low server load.''
 
''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.
 
Type the following to make the XMLUI the default interface.
  
  sudo cd /var/lib/tomcat6/webapps
+
  cd /var/lib/tomcat6/webapps
 
 
sudo ln -s $HOME/webapps/xmlui ROOT
 
  
 +
sudo ln -s /home/dspace/webapps/xmlui ROOT
 +
----
 
====Option B: [[SUNScholar/Theme|JSPUI]]====
 
====Option B: [[SUNScholar/Theme|JSPUI]]====
 +
----
 
''Easy to setup but hard to customise and has a high server load.''
 
''Easy to setup but hard to customise and has a high server load.''
  
 
Type the following to make the JSPUI the default interface.
 
Type the following to make the JSPUI the default interface.
  
  sudo cd /var/lib/tomcat6/webapps
+
  cd /var/lib/tomcat6/webapps
  
  sudo ln -s $HOME/webapps/jspui ROOT
+
  sudo ln -s /home/dspace/webapps/jspui ROOT
  
 
====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/tomcat6/webapps
+
  cd /var/lib/tomcat6/webapps
  
 
  sudo ls -l
 
  sudo ls -l
Line 55: Line 55:
 
dspace@ir1:/var/lib/tomcat6/webapps$ ls -l
 
dspace@ir1:/var/lib/tomcat6/webapps$ ls -l
 
total 0
 
total 0
lrwxrwxrwx 1 root    root        24 2012-09-05 11:28 oai -> $HOME/webapps/oai
+
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/webapps/xmlui
+
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/webapps/solr
+
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/webapps/sword
+
lrwxrwxrwx 1 root    root        26 2012-09-05 11:29 sword -> /home/dspace/webapps/sword
 
</pre>
 
</pre>
  
Line 64: Line 64:
 
Type the following.
 
Type the following.
 
  sudo /etc/init.d/tomcat6 restart
 
  sudo /etc/init.d/tomcat6 restart
 +
 +
[[Category:Installation]]

Latest revision as of 10:58, 28 May 2016

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/tomcat6/webapps
sudo ln -s /home/dspace/webapps/oai
sudo ln -s /home/dspace/webapps/sword
sudo ln -s /home/dspace/webapps/solr

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.

  • 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/tomcat6/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/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:

cd /var/lib/tomcat6/webapps
sudo ls -l

See example listing below.

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

Step 8.2 Restart Tomcat Server

Type the following.

sudo /etc/init.d/tomcat6 restart