SUNScholar/Install DSpace/S06

Step 6. Compile the DSpace Java webapp

Change directory to the build directory by typing as follows:

Note: Select the DSpace version you are going to use

cd /home/dspace/dspace-3.2-src-release/dspace/target/dspace-1.8.2-build

cd /home/dspace/dspace-1.8.2-src-release/dspace/target/dspace-1.8.2-build

Type the following in the above named directory:

ant fresh_install

A lot of information now appears on the screen. Below are shown the last lines confirming success:

     [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

Please note: If you change anything later then rebuild your DSpace. Do not run "ant fresh_install" again, this is only done once during installation.

Step 6.1: Setup file permissions

After a successful initial build, we give user "tomcat6" full read and write permissions to the dspace user home folders.

cd

sudo adduser tomcat6 dspace

sudo adduser dspace tomcat6

sudo chown dspace.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 Editor Help

CTL+O	= Save the file and then press Enter
CTL+X	= Exit "nano"
CTL+K	= Delete line
CTL+U	= Undelete line
CTL+W	= Search for %%string%%
CTL+\	= Search for %%string%% and replace with $$string$$
CTL+C	= Show line numbers

More info = http://en.wikipedia.org/wiki/Nano_(text_editor)

---

Step 6.3: Setup Tomcat server permissions

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!

sudo nano /etc/default/tomcat6

Replace tomcat6 user with root user. See example below.

# 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

---

NANO Editor Help

CTL+O	= Save the file and then press Enter
CTL+X	= Exit "nano"
CTL+K	= Delete line
CTL+U	= Undelete line
CTL+W	= Search for %%string%%
CTL+\	= Search for %%string%% and replace with $$string$$
CTL+C	= Show line numbers

More info = http://en.wikipedia.org/wiki/Nano_(text_editor)

---

PREVIOUS

NEXT