Difference between revisions of "SUNScholar/Rebuild DSpace"

From Libopedia
Jump to navigation Jump to search
m
 
(193 intermediate revisions by the same user not shown)
Line 1: Line 1:
Log into your server and type the following:
+
<center>
  su - dspace
+
  '''[[SUNScholar/Install DSpace/S11|Back to After Installation Tasks]]'''
 +
</center>
  
mkdir /home/dspace/scripts
+
==Introduction==
 +
To apply customisations, DSpace usually needs to be rebuilt, to update the Java WAR's for re-deployment by the Tomcat webapp server.
  
nano /home/dspace/scripts/build-webapps
+
This wiki page helps you to create a customised rebuild script that you can use later any time you need it.
  
''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.''
+
Also see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Customisation
  
Copy and paste the following into the open nano editor.
+
==Requirements==
<pre>
+
<font color="red">'''[[SUNScholar/Install_DSpace/S03#Step_3.2|Click here]] to setup the "source" folder first.'''</font>
sudo echo "Waiting 10 seconds for Apache connections to terminate."
+
==Instructions==
sleep 10
+
===[[SUNScholar/Rebuild_DSpace/5X|For DSpace Versions =>5.X]]===
sudo /etc/init.d/tomcat6 stop
+
===[[SUNScholar/Rebuild_DSpace/4X|For DSpace Versions <=4.X]]===
echo "Cleaning out old xmlui cache"
 
sudo rm /var/lib/tomcat6/work/Catalina/localhost/_/cache-dir/cocoon-ehcache.data
 
echo "Start package"
 
cd /home/dspace/dspace-1.6.2-src-release
 
mvn package -U clean package
 
cd /home/dspace/dspace-1.6.2-src-release/dspace/target/dspace-1.6.2-build.dir
 
echo "Start Ant"
 
ant -Doverwrite=true update clean_backups
 
echo  "Fix permissions"
 
sudo /root/scripts/fix-permissions
 
echo "Archive catalina log file"
 
tar czvf /var/log/tomcat6/catalina.out-`date +%U`.gz /var/log/tomcat6/catalina.out
 
rm /var/log/tomcat6/catalina.out
 
sudo /etc/init.d/tomcat6 start
 
echo "Waiting 10 seconds for Tomcat server to settle."
 
sleep 10
 
sudo /etc/init.d/apache2 start
 
</pre>
 
Save the file.
 
  
Type the following:
+
==Tips==
chmod 0755 /home/dspace/scripts/build-webapps
+
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.
  
Now you can rebuild Dspace by typing the following at anytime.
+
==References==
/home/dspace/scripts/build-webapps
+
==="ant" target references===
 +
*https://wiki.duraspace.org/display/DSDOC4x/Ant+targets+and+options
 +
*https://wiki.duraspace.org/display/DSDOC3x/Appendix+B
 +
 
 +
===General references===
 +
*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
 +
 
 +
{{Tomcat7}}
 +
 
 +
[[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.