| 1 | [[TracNav(MolgenisGuide)]] |
| 2 | = How to develop MOLGENIS on Eclipse/Helios = |
| 3 | |
| 4 | We assume you installed: |
| 5 | * Java JDK >= 1.6 |
| 6 | * MySQL or other supported database |
| 7 | * Tomact 6.0 or other supported web engine |
| 8 | |
| 9 | == 1. download eclipse helios == |
| 10 | Available at |
| 11 | http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/heliossr1 |
| 12 | |
| 13 | == 2. install SVN plugin 'subversive' == |
| 14 | Within Eclipse |
| 15 | * go to help -> install new software |
| 16 | * Choose: Work with Helios - http://download.eclipse.org/releases/helios |
| 17 | * Choose: Collaboration -> Subversive SVN team provider and |
| 18 | * Install |
| 19 | |
| 20 | == 3. install freemarker plugin 'Freemarker IDE' == |
| 21 | Within Eclipse: |
| 22 | * go to help -> install new software |
| 23 | * Choose: 'Add' and add new url http://download.jboss.org/jbosstools/updates/JBossTools-3.1.1.GA/ |
| 24 | * Type in search box 'Freemarker' |
| 25 | * Choose: Freemarker IDE (not SDK) |
| 26 | * Install |
| 27 | |
| 28 | == 4. checkout molgenis projects == |
| 29 | Within Eclipse |
| 30 | * go to Window->Open perspective->Other |
| 31 | * Choose: SVN Repository exploring |
| 32 | * Eclipse may ask you which SVN engine to use, choose SVN kit. |
| 33 | * Right-click on SVN repositories and add new repository |
| 34 | * URL: http://www.molgenis.org/svn |
| 35 | * Browse to molgenis/3.3 |
| 36 | * right-click and choose 'check out'. |
| 37 | * Browse to molgenis_projects/<yourproject> |
| 38 | * right-click and choose 'check out'. |
| 39 | |
| 40 | == 5. Develop == |
| 41 | From now on development is like on Galileo. |
| 42 | |
| 43 | == FAQ == |
| 44 | |
| 45 | === Q1: how to add/manage J2EE dependencies === |
| 46 | In Eclipse Galileo there was a seperate entry for this in the project 'properties'. |
| 47 | In Eclipse Helios this renamed to 'Deployment Assembly' |
| 48 | Here you can also choose other projects to be included. |
| 49 | |
| 50 | === Q2: I get 404 errors when starting the server === |
| 51 | This may happen if Eclipse destroys your WebContent/WEB-INF/web.xml to default. |
| 52 | To solve this right-click WebContent/WEB-INF/web.xml and update to SVN. |
| 53 | Then delete your web server from the 'Servers' pane and run on server again. |
| 54 | |
| 55 | |