TracNav(MolgenisGuide)?

How to develop MOLGENIS on Eclipse/Helios?

We assume you installed:

• Java JDK >= 1.6
• MySQL or other supported database
• Tomact 6.0 or other supported web engine

1. Install eclipse helios

• Download from

​http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/heliossr1

• Unzip to a directory of your choice
• Start it
  • Choose a sensible name for your workspace directory

2. install SVN plugin 'subversive'

Within Eclipse

• go to help -> install new software
• Choose: Work with -> Helios - ​http://download.eclipse.org/releases/helios
• Tick box: Collaboration -> Subversive SVN team provider and
• Install

3. install freemarker plugin 'Freemarker IDE'

Within Eclipse:

• go to help -> install new software
• Choose: 'Add' and add new url ​http://download.jboss.org/jbosstools/updates/JBossTools-3.1.1.GA/
• Type in search box 'Freemarker'
• Choose: Freemarker IDE (not SDK)
• Install

4. checkout molgenis projects

Within Eclipse

• go to Window->Open perspective->Other
• Choose: SVN Repository exploring
• Eclipse may ask you which SVN engine to use, choose SVN kit.
• Right-click on SVN repositories and add new repository
  • URL: ​http://www.molgenis.org/svn
• Browse to molgenis/3.3
  • right-click and choose 'check out'.
• Browse to molgenis_projects/<yourproject>
  • right-click and choose 'check out'.

In your workspace you now have two projects

• molgenis - has the generator
• your project - all software specific to your MOLGENIS instance.

5. Develop

From now on development is like on Galileo.

FAQ

Q1: how to add/manage J2EE dependencies

• In Eclipse Galileo there was a seperate entry for this in the project 'properties'.
• In Eclipse Helios this renamed to 'Deployment Assembly'. Here you can also choose other projects to be included.

Q2: I get 404 errors when starting the server

This may happen if Eclipse destroys your WebContent/WEB-INF/web.xml to default.

To solve this:

• right-click WebContent/WEB-INF/web.xml
• update to SVN.
• delete your web server from the 'Servers' pane
• run on server again.