IDE Integration: DSpace, Eclipse and Tomcat Video Tutorial

This is a video tutorial broken into three parts which describe the steps necessary to setup DSpace using the Eclipse IDE environment and integration with Tomcat. Eclipse is not the only IDE available, nor is this the only way to configure Eclipse - – however it is a clean and relatively simple method that will work for most developers.

Prerequisites

The tutorial assumes that you have several pieces of software already installed before beginning the eclipse integration. The DSpace manual covers installing & configuring these tools for use with DSpace:

...

Maven	2.0.7+          http://maven.apache.org/
Ant 1.6+                http://ant.apache.org/
SVN 1.4+                http://subversion.tigris.org/

Part I: Installing and Configuring Eclipse Plugins

Video: http://di.tamu.edu/publications/resources/tutorials/DSpaceEclipseVideoTutorialPart1.mp4^{Image Removed}

One of the strengths of the Eclipse platform is the ability to extend its feature through the addition of plugins. This tutorial requires five plugins which help make developing DSpace within Eclipse easier.

...

Use the standard plugin installation method from the remote URL: http://subclipse.tigris.org/update_1.2.x^{Image Removed}. Use http://subclipse.tigris.org/update_1.6.x^{Image Removed} for the latest stable branch (with Eclipse 3.4.2).

...

Use the standard plugin installation method from the remote URL: http://m2eclipse.codehaus.org/update-dev^{Image Removed}. Use http://m2eclipse.sonatype.org/update/^{Image Removed} for the latest stable branch (with Eclipse 3.4.2). Note also that all components will work with 3.4.2 JEE release save AJDT (disable this dependency if you are not using the AJDT plugin).

...

There is no remote URL available for this plugin, you must download and install it manually. First download the plugin from: http://www.eclipsetotale.com/tomcatPlugin.html^{Image Removed} Next, unzip the plugin into eclipse/plugins. Finaly restart Eclipse with the "—clean---clean" option so that it recognizes the new plugin.

Next the SysDeo Tomcat plugin needs to be configured. Select Eclipse -> Preferences -> Tomcat, and then select the appropriate version of Tomcat, setting the home and base location for your Tomcat installation, setting the classpath to include tools.jar (Windows & Linux) or classes.jar (Mac OS X), and finally provide the tomcat manager username and password.

Part II: Building DSpace

Video: http://di.tamu.edu/publications/resources/tutorials/DSpaceEclipseVideoTutorialPart2.mp4^{Image Removed}

This part will cover how to build and deploy DSpace from within Eclipse. First we will download DSpace and configure the several Eclipse projects that it contains. Next we will set up a series of Maven tasks to automate the build processes. Then we will perform the optional fresh install of DSpace from within Eclipse. Finally, specific projects will be configured for use with Tomcat.

...

First we need to check out the DSpace source code from SVN. To do this go to the SVN Exploration perspective, add a new repository location "https://dspace.svn.sourceforge.net/svnroot/dspace/". From the new repository locate the dspace-1_5_x branch and checkout all the subdirectories as projects. After SVN has finished downloading all the code, switch back to the Java perspective and select all the projects. Right click on the set and select "Maven -> Enable Dependency Management", Eclipse will then take a moment to rebuild the workspace, and then select "Maven -> Update Source Directories". After the workspace has finished rebuilding all compile errors should be resolved.

...

• DSpace Clean
• DSpace Assemble
• XMLUI Package
• JSPUI Package
• OAI Package
• LNI Package

Part III: Installing & Deploying DSpace

Video: http://di.tamu.edu/publications/resources/tutorials/DSpaceEclipseVideoTutorialPart3.mp4^{Image Removed}

1) Perform a fresh install

...