Rebuild+DSpace
The following directions are for DSpace 1.5.x and above!
...
- dspace - The DSpace Installation directory
- dspace-source - The DSpace Assembly project within the DSpace source code
- dspace-source
Code Block |
---|
/dspace/target/dspace-[version]-build.dir/ |
- The directory where the DSpace Assembly project builds a new installation package for DSpace. - Tomcat (Mac OSX Server:
Code Block |
---|
/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!)
...
- 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
- (recompiles all DSpace code and rebuilds the DSpace installation package)
- dspace-source
Code Block |
---|
/dspace/target/dspace-[version]-build.dir/ |
(move into the target directory where DSpace has been rebuilt) - (updates your DSpace install based on the newly built content in your target directory)
- Alternatively, if you do not need to reinstall JAR files, you could instead run
Code Block |
---|
ant update_webapps |
Wiki Markup |
---|
(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 directory.
Code Block |
---|
cp -R [dspace]/webapps/ |
Tomcat - (For Mac OS X Server)
Code Block |
---|
cp build/*.war /library/jboss/3.2/deploy |
- Test your changes in 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
Code Block |
---|
mvn clean build |
(removes all old compiled code and recompiles all DSpace code and rebuilds the DSpace installation package)- dspace-source
Code Block |
---|
/dspace/target/dspace-[version]-build.dir/ |
(move into the target directory where DSpace has been rebuilt) - (updates your DSpace install based on the newly built content in your target directory)
- Alternatively, if you do not need to reinstall JAR files, you could instead run
Code Block |
---|
ant update_webapps |
Wiki Markup |
---|
(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 directory.
Code Block |
---|
cp -R [dspace]/webapps/ |
Tomcat - (For Mac OS X Server)
Code Block |
---|
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
Code Block |
---|
/work/Catalina/localhost |
- 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