Difference between revisions of "SUNScholar/Rebuild DSpace"

From Libopedia
Jump to navigation Jump to search
m
 
(182 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
<center>
 +
'''[[SUNScholar/Install DSpace/S11|Back to After Installation Tasks]]'''
 +
</center>
 +
 +
==Introduction==
 +
To apply customisations, DSpace usually needs to be rebuilt, to update the Java WAR's for re-deployment by the Tomcat webapp server.
 +
 +
This wiki page helps you to create a customised rebuild script that you can use later any time you need it.
 +
 +
Also see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Customisation
 +
 
==Requirements==
 
==Requirements==
−
*<font color="red">'''This procedure assumes that you have used the [[SUNScholar/Dspace|three step process]] to install DSpace.'''</font>
+
<font color="red">'''[[SUNScholar/Install_DSpace/S03#Step_3.2|Click here]] to setup the "source" folder first.'''</font>
−
*<font color="red">'''It is assumed your server is open on the campus firewall. This is needed to be able to download updated MAVEN packages.'''</font>
+
==Instructions==
−
==Procedure==
+
===[[SUNScholar/Rebuild_DSpace/5X|For DSpace Versions =>5.X]]===
−
Log into your server via a terminal as follows:
+
===[[SUNScholar/Rebuild_DSpace/4X|For DSpace Versions <=4.X]]===
−
ssh dspace@%hostname%
 
−
Replace
 
−
Type the following:
 
−
mkdir /home/dspace/scripts
 
−
 
 
−
nano /home/dspace/scripts/build-webapps
 
  
−
''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
+
==Tips==
 +
The output of the build and compile process can be sent to a log file on Linux systems. Simply append '''"<tt>> compile.log</tt>"''' or '''"<tt>> update.log</tt>'''" to the command line instruction.
  
−
Copy and paste the following into the open nano editor.
+
==References==
−
<pre>
+
==="ant" target references===
−
#!/bin/bash
+
*https://wiki.duraspace.org/display/DSDOC4x/Ant+targets+and+options
−
sudo /etc/init.d/tomcat6 stop
+
*https://wiki.duraspace.org/display/DSDOC3x/Appendix+B
−
echo "Cleaning out old xmlui cache files"
 
−
sudo rm /var/lib/tomcat6/work/Catalina/localhost/_/cache-dir/cocoon-ehcache.data
 
−
sudo rm /var/lib/tomcat6/work/Catalina/localhost/_/cache-dir/cocoon-ehcache.index
 
−
echo "Clean out old webapps"
 
−
sudo rm -rf /home/dspace/webapps/*
 
−
echo "Start MAVEN packaging"
 
−
cd /home/dspace/dspace-1.7.2-src-release
 
−
mvn package -U clean package
 
−
echo "Start ANT build"
 
−
cd /home/dspace/dspace-1.7.2-src-release/dspace/target/dspace-1.7.2-build.dir
 
−
ant -Doverwrite=true update clean_backups
 
−
echo "Remove old catalina log file"
 
−
sudo rm /var/log/tomcat6/catalina.out
 
−
echo "Fix file permissions"
 
−
sudo chmod 0777 -R /home/dspace/webapps
 
−
sudo chmod 0777 -R /home/dspace/solr
 
−
sudo /etc/init.d/tomcat6 start
 
−
clear
 
−
echo "To be sure, the machine needs to be re-booted to ensure that the handle server is also ok"
 
−
</pre>
 
−
Save the file.
 
  
−
Type the following:
+
===General references===
−
chmod 0755 /home/dspace/scripts/build-webapps
+
*https://github.com/DSpace/demo.dspace.org/blob/master/scripts/linux/reset-dspace-content
 +
*https://wiki.duraspace.org/display/DSDOC3x/Rebuild+DSpace
 +
*https://wiki.duraspace.org/display/DSPACE/Rebuild+DSpace
  
−
Now you can rebuild DSpace by typing the following at anytime.
+
{{Tomcat7}}
−
/home/dspace/scripts/build-webapps
 
  
−
'''[[SUNScholar/IR|Back to IR Help]]'''
+
[[Category:System Administration]]
 +
[[Category:Customisation]]
 +
[[Category:Installation]]
 +
__NOTOC__

Latest revision as of 23:57, 9 June 2016

Back to After Installation Tasks

Introduction

To apply customisations, DSpace usually needs to be rebuilt, to update the Java WAR's for re-deployment by the Tomcat webapp server.

This wiki page helps you to create a customised rebuild script that you can use later any time you need it.

Also see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Customisation

Requirements

Click here to setup the "source" folder first.

Instructions

For DSpace Versions =>5.X

For DSpace Versions <=4.X

Tips

The output of the build and compile process can be sent to a log file on Linux systems. Simply append "> compile.log" or "> update.log" to the command line instruction.

References

"ant" target references

General references

When using the Ubuntu 16.04 LTS server change all instances of tomcat to tomcat8.

When using the Ubuntu 14.04 LTS server change all instances of tomcat to tomcat7.

When using the Ubuntu 12.04 LTS server change all instances of tomcat to tomcat6.
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Rebuild_DSpace&oldid=43124"