Rebuild Manakin (Manakin)

From DSpace Wiki

[edit] Directories:

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

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

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 changes)

1. Log on to the server DSpace / Manakin is running on (e.g. ssh). Make sure to login as the user who initially installed DSpace / Manakin!
2. Open a command prompt (if you don’t have one already), and cd[manakin-source]
3. ant -Ddspace=[manakin-source] build_wars (recompiles all Manakin code and builds a new .war file)
4. cp build/*.war [Tomcat] /webapps/
   • (Mac OS X Server) cp build/*.war /library/jboss/3.2/deploy
5. Test changes in DSpace / Manakin
6. Log on to the server DSpace / Manakin is running on (e.g. ssh). Make sure to login as the user who initially installed DSpace / Manakin!
7. Open a command prompt (if you don’t have one already), and #* cd[manakin-source]
   • ant clean (removes old compiled code)
   • ant -Ddspace=[dspace-source] build_wars (recompiles all Manakin and builds a new fresh .war file)
8. 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
9. cp build/*.war [Tomcat] /webapps/
   • (Mac OS X Server) cp build/*.war /library/jboss/3.2/deploy
10. (Optional, but recommended) Completely remove any manakin or dspace directories created in [Tomcat] /webapps ( /library/jboss/3.2/deploy for Mac OS X Server) - BE CAREFUL…you don’t want to remove the wrong directory!
    • To force Tomcat to recompile everything, you may also wish to remove any manakin or dspace directories created in [Tomcat] /work/Catalina/localhost
11. 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
12. Test your changes in DSpace / Manakin