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

From Libopedia
Jump to navigation Jump to search
 
(38 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{SUNScholar}}
+
<center>
 +
'''[[SUNScholar/Install DSpace/S07|NEXT - STEP 7]]'''
 +
</center>
  
==Step 6. Compile the DSpace Java webapp==
+
==Step 6. Install the DSpace Java webapps==
Change directory to the build directory by typing as follows:
+
After the java webapp WAR files have been complied they need to be "installed" by the java "ant" installer in preparation for them to be hosted by the Tomcat java webapp server.
  
cd /home/dspace/dspace-1.8.2-src-release/dspace/target/dspace-1.8.2-build
+
===[[SUNScholar/Install DSpace/S06/6.X|For DSpace 6.X]]===
 +
===[[SUNScholar/Install DSpace/S06/5.X|For DSpace 5.X]]===
 +
===[[SUNScholar/Install DSpace/S06/4.X|For DSpace 4.X]]===
  
Type the following in the above named directory:
 
  
  ant fresh_install
+
<center>
 +
  '''[[SUNScholar/Install DSpace/S05|PREVIOUS - STEP 5]]'''
 +
</center>
  
A lot of information now appears on the screen. Below are shown the last lines confirming success:
+
[[Category:Installation]]
<pre>
+
__NOTOC__
    [java] Started: 1349777373408
 
    [java] Ended: 1349777373778
 
    [java] Elapsed time: 0 secs (370 msecs)
 
    [echo]
 
    [echo] ====================================================================
 
    [echo]  The DSpace code has been installed, and the database initialized.
 
    [echo]
 
    [echo]  To complete installation, you should do the following:
 
    [echo]
 
    [echo]  * Setup your Web servlet container (e.g. Tomcat) to look for your
 
    [echo]    DSpace web applications in: /home/dspace/webapps/
 
    [echo]
 
    [echo]    OR, copy any web applications from /home/dspace/webapps/ to
 
    [echo]    the appropriate place for your servlet container.
 
    [echo]    (e.g. '$CATALINA_HOME/webapps' for Tomcat)
 
    [echo]
 
    [echo]  * Make an initial administrator account (an e-person) in DSpace:
 
    [echo]
 
    [echo]    /home/dspace/bin/dspace create-administrator
 
    [echo]
 
    [echo]  * Start up your servlet container (Tomcat etc.)
 
    [echo]
 
    [echo]  You should then be able to access your DSpace's 'home page':
 
    [echo]
 
    [echo]    http://bibj-lt-hgibson.sun.ac.za
 
    [echo]
 
    [echo]  You should also be able to access the administrator UI:
 
    [echo]  
 
    [echo]    http://bibj-lt-hgibson.sun.ac.za/dspace-admin
 
    [echo] ====================================================================
 
    [echo]       
 
 
 
BUILD SUCCESSFUL
 
</pre>
 
 
 
'''Please note:''' If you change anything later then [[SUNScholar/Rebuild_DSpace|rebuild your Dspace]]. Do not run "ant fresh_install" again, this is only done once during installation.
 
 
 
==Step 6.1: Setup file permissions==
 
<font color="red">'''After a successful initial build, we give user "tomcat6" full read and write permissions to the dspace user home folders.'''</font>
 
 
 
cd
 
 
 
sudo adduser tomcat6 dspace
 
 
 
sudo adduser dspace tomcat6
 
 
 
sudo chown tomcat6.dspace -R /home/dspace
 
 
 
sudo chmod 0777 -R /home/dspace
 
 
 
==Step 6.2: Setup file creation permissions==
 
nano $HOME/.bashrc
 
Add the following to the bottom of the file
 
umask 002
 
{{NANO}}
 
==Step 6.3: Setup Tomcat server permissions==
 
<font color="red">'''Please note: This procedure violates best security practice on an Ubuntu server. See: http://dspace.2283337.n4.nabble.com/DSpace-Security-td4664584.html for a discussion on the DSpace tech mailing list. You apply this procedure at your own risk!'''</font>
 
sudo nano /etc/default/tomcat6
 
 
 
Replace '''tomcat6''' user with '''root''' user. See example below.
 
<pre>
 
# Run Tomcat as this user ID. Not setting this or leaving it blank will use the
 
# default of tomcat6.
 
TOMCAT6_USER=root
 
 
 
# Run Tomcat as this group ID. Not setting this or leaving it blank will use
 
# the default of tomcat6.
 
TOMCAT6_GROUP=root
 
</pre>
 
 
 
{{NANO}}
 
 
 
'''[[SUNScholar/Install Dspace/S05|PREVIOUS]]'''
 
 
 
'''[[SUNScholar/Install Dspace/S07|NEXT]]'''
 

Latest revision as of 14:33, 30 October 2019

NEXT - STEP 7

Step 6. Install the DSpace Java webapps

After the java webapp WAR files have been complied they need to be "installed" by the java "ant" installer in preparation for them to be hosted by the Tomcat java webapp server.

For DSpace 6.X

For DSpace 5.X

For DSpace 4.X

PREVIOUS - STEP 5