Contents
Rebuild+DSpace
The following directions are for DSpace 1.5.x and above!
Directories:
- dspace - The DSpace Installation directory
- dspace-source
- The DSpace Assembly project within the DSpace source code
/dspace/
- dspace-source
- The directory where the DSpace Assembly project builds a new installation package for DSpace.
/dspace/target/dspace-[version]-build.dir/
- Tomcat
(Mac OSX Server:
/webapps/
)/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.
Quick Restart (Just restarts the web server after configuration changes*)
(*Exception – Changes to Messages.properties always requires a rebuild!)
- 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
- 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
Quick Build: (Quick build after smaller, usually JSP based or XMLUI-Theme based, changes)
- Log on to the server DSpace is running on (e.g. ssh). Make sure to login as the user who initially installed DSpace!
- Open a command prompt (if you don't have one already), and
dspace-source
cd
/dspace/
- (recompiles all DSpace code and rebuilds the DSpace installation package)
mvn build
- dspace-source
cd
(move into the target directory where DSpace has been rebuilt)/dspace/target/dspace-[version]-build.dir/
- (updates your DSpace install based on the newly built content in your target directory)
ant update
- Alternatively, if you do not need to reinstall JAR files, you could instead run
ant update_webapps
(which just copies over web application changes to your [dspace)
- If you do not have Tomcat pointing at your dspace
directory, you will also need to copy your final web application(s) into your Tomcat
/webapps/
directory./webapps/
- Tomcat
cp -R [dspace]/webapps/
/webapps/
- (For Mac OS X Server)
cp build/*.war /library/jboss/3.2/deploy
- Test your changes in DSpace
Full Refresh/Rebuild: (Completely refresh all of DSpace)
- Log on to the server DSpace is running on (e.g. ssh). Make sure to log in as the user who initially installed DSpace!
- Open a command prompt (if you don't have one already), and
dspace-source
cd
/dspace/
- (removes all old compiled code and recompiles all DSpace code and rebuilds the DSpace installation package)
mvn clean build
- dspace-source
cd
(move into the target directory where DSpace has been rebuilt)/dspace/target/dspace-[version]-build.dir/
- (updates your DSpace install based on the newly built content in your target directory)
ant update
- Alternatively, if you do not need to reinstall JAR files, you could instead run
ant update_webapps
(which just copies over web application changes to your [dspace)
- If you do not have Tomcat pointing at your dspace
directory, you will also need to copy your final web application(s) into your Tomcat
/webapps/
directory./webapps/
- Tomcat
cp -R [dspace]/webapps/
/webapps/
- (For Mac OS X Server)
cp build/*.war /library/jboss/3.2/deploy
- Test changes in DSpace
- To force Tomcat to recompile everything, you may also wish to remove any DSpace related web application directories created in Tomcat
/work/Catalina/localhost
- To force Tomcat to recompile everything, you may also wish to remove any DSpace related web application directories created in Tomcat
- 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
- Test your changes in DSpace