*Authors: James Rutherford, Richard Jones, Stuart Lewis
*Version: 24th August 2009

...

Installing IDEA

This guide covers version 8.3 of IDEA, which you can get from here: http://www.jetbrains.com/idea/. Instructions for installing & running can be found on the website and in the readme file included with the download.

Creating a DSpace project from an SVN checkout

From the main window, click "Check out from Version Control", then "Subversion". When it prompts you for a repository, click the "+" icon and enter the URL for the DSpace subversion repository http://scm.dspace.org/svn/repo. Next, select "dspace" followed by "trunk" and click "checkout", and you will be prompted to choose a directory for the sources. Select your source, and on the next page ('SVN Checkout Options') elect how you wish the checkout to be structured ('Destination:'). Click OK and when prompted which SVN version to use, select the latest. The source will then be checked-out.

...

Project Settings -> JDKs

and add your JDK here

Building and installing DSpace for the first time

Go to the command line, and go to the root of your new project. Run:

...

• run

  Code Block
  ant fresh_install

  from this directory. You can do this in IDEA by right clicking

  Code Block
  build.xml

  , and selecting

  Code Block
  Add as Ant Build File

  . When the build file dialog opens, select

  Code Block
  fresh_install

  and hit the run button at the top of the panel.

One-click maven builds

Go to "Run" -> "Edit configurations", then click the "+" icon and select maven.

...

built into it. You can do this using the quick launch from the IDEA tool bar: in the centre of the toolbar at the top is a pull-down menu which contains all your pre-configured run tasks. Select the one you have named "mvn clean package", and hit the green arrow to the right of it. You should see maven building your project in a window at the bottom of IDEA, and the content will be similar to when you ran it from the command line earlier.

Web Facets

At some point during the above installation process, IDEA may notify you of new web facets detected. These correspond to the individual WAR files and thus web applications which we are working on. If you do not confirm the detection of these facets straight away, they will be available on the bottom left of the screen by clicking on the flashing gear/cog.

...

In the dialog, select "Accept".

Deploying DSpace

The next step in getting fully integrated with this IDE is to set it up with ant and tomcat. First, set up ant by clicking the "Ant build" icon on the right. If you used Ant to build DSpace above, then your previous configuration will remain. Otherwise, add a new one by clicking the "+" icon. Here, you need to select the

...

Once you have this set up, you can deploy DSpace, by selecting the tomcat deployment from the menu bar, and hitting the green play button next to it. Hit the play button on the opened dialog, and IDEA will deploy the applications at the context paths specified in this section.

Tips

If you leave the "run" dialog boxes open at the bottom, you have a quick way to re-run the build and deployment tasks. The maven build can be re-run by clicking the green icon that looks like ">>", and likewise for the ant + tomcat deployment, except you'll have to click "stop" first, and wait for tomcat to shut down.

Useful plugins

IDEA has loads of plugins available to install. A couple that may be useful are:

...