SUNScholar/Rebuild DSpace

From Libopedia
Jump to navigation Jump to search 
Back to After Installation Tasks

Rationale

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

This wiki page helps you to build 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#Advanced_Customisation_.28Modules_Overlay_Method.29

Requirements

Click here to setup the "source" folder first.

Procedure

Step 1 - Login to your server

Check the following wiki page, and then return. 

http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S01

Step 2 - Create a scripts folder

Type the following: 

mkdir $HOME/scripts

Step 3 - Create the script

Type the following: 

nano $HOME/scripts/build-webapps

Copy and paste the following into the open nano editor. 

Replace all instances of XXX with the DSpace version number selected for installation.

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.

#!/bin/bash

sudo service tomcat6 stop
sleep 3

#### Optional ####
#Remove old cache and log files. Uncomment below to enable.
#echo "Clean 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 "Remove old catalina log file"
#sudo rm /var/log/tomcat6/catalina.out

#### Optional ####
#Remove old webapps. Uncomment below to enable.
#echo "Clean out old webapps"
#sudo rm -rf $HOME/webapps/*

#### Optional ####
#Remove old config folder. Uncomment below to enable.
#echo "Clean out old configs"
#sudo rm -rf $HOME/config/*

echo "Start MAVEN build"
cd $HOME/source
mvn -U clean package

echo "Start ANT updates"
cd $HOME/source/dspace/target/dspace-XXX-build
ant update

#### Optional ####
#Clean backups. Uncomment below to enable.
#ant clean_backups

#### Optional ####
#Overwrite configs. Uncomment below to enable.
#ant -Doverwrite=true update_configs

#### Optional ####
#Geolite database updates.
# !!!! Your server should be open on the internet before you do this !!!!
#Uncomment below to enable.
#sudo ant update_geolite

sleep 3
sudo service tomcat6 restart

#### Optional ####
#Fix file and folder permissions. Uncomment below to enable.
#echo "Fixing file permissions. Please wait..."
#sudo chmod 0777 -R $HOME
#echo "Fixing file ownership. Please wait..."
#sudo chown dspace.dspace -R $HOME

echo "Rebuild complete."
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 4 - Make the script executable

Type the following: 

chmod 0755 $HOME/scripts/build-webapps

Step 5 - Run the script

Now you can rebuild DSpace WHEN NEEDED by simply typing the following; 

$HOME/scripts/build-webapps

After the rebuild check that the config files have been copied over from the source folder correctly.

References

"ant" target references

General references

Other Scripts

Rebuild Indexes

Click on the heading above.

Restart DSpace

Click on the heading above.

Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Rebuild_DSpace&oldid=34879"