Rebuild DSpace (JSP)

From DSpace Wiki

[edit] Rebuild DSpace

[edit] Directories:

• [dspace-source]
• [dspace-source]/build/
• [Tomcat]/webapps/ (Mac OSX Server: /library/jboss/3.2/deploy)
  • Note: JBOSS comes pre-installed with Mac OS X server. However, for both server and desktop editions Tomcat may be used as with other platforms.

[edit] Quick Restart (Just restarts the web server after configuration changes*)

(*Exception – Changes to Messages.properties always requires a rebuild!)

1. Stop Tomcat(WARNING: this will bring down the website)
   • (Linux / OS X / Solaris) [Tomcat]/bin/shutdown.sh
   • (Mac OS X Server) Use Server Admin to stop Tomcat (“Application Server”)
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to stop Tomcat
2. Start Tomcat
   • (Linux / OS X / Solaris) [Tomcat]/bin/startup.sh
   • (Mac OS X Server) Use Server Admin to start Tomcat (“Application Server”)
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to start Tomcat

[edit] Quick Build: (Quick build after smaller, usually JSP-based, changes)

1. Log on to the server DSpace is running on (e.g. ssh). Make sure to login as the user who initially installed DSpace!
2. Open a command prompt (if you don’t have one already), and cd [dspace-source]
3. ant update(recompiles all DSpace code and reinstalls third-party JAR files)
4. Alternatively, if you do not need to reinstall JAR files, you could instead run ant build_wars (which just recompiles DSpace code)
5. cp build/*.war [Tomcat] /webapps/
   • (Mac OS X Server) cp build/*.war /library/jboss/3.2/deploy
6. Test changes in DSpace

[edit] Full Refresh/Rebuild: (Completely refresh all of DSpace)

1. Log on to the server DSpace is running on (e.g. ssh). Make sure to log in as the user who initially installed DSpace!
2. Open a command prompt (if you don’t have one already), and cd[dspace-source]
3. ant clean (removes old compiled code)
4. ant update (recompiles all DSpace code and reinstalls third-party JAR files)
5. Stop Tomcat(WARNING: this will bring down the website)
   • (Linux / OS X / Solaris) [Tomcat]/bin/shutdown.sh
   • (Mac OS X Server) Use Server Admin to stop Tomcat (“Application Server”)
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to stop Tomcat
6. cp build/*.war [Tomcat] /webapps/
   • (Mac OS X Server) cp build/*.war /library/jboss/3.2/deploy
7. (Optional, but recommended) Completely remove any dspace or dspace-oai directories created in [Tomcat]/webapps ( /library/jboss/3.2/deploy for Mac) - BE CAREFUL… you don’t want to remove the wrong directory!
   • To force Tomcat to recompile everything, you may also wish to remove any dspace or dspace-oai directories created in [Tomcat] /work/Catalina/localhost
8. Start Tomcat
   • (Linux / OS X / Solaris) [Tomcat]/bin/startup.sh
   • (Mac OS X Server) Use Server Admin to start Tomcat (“Application Server”)
   • (Windows) Use Tomcat Service Monitor (in Notification Area) to start Tomcat
9. Test your changes in DSpace